Make mysql.info optional.

prefers to take docs directly from the source tree.

correct location.

which was detected during the build of 5.5.3-m3.
This requires version 9 of IBM C++ to help.

More fixes will still be needed, it is very strict
(or rather: a bit picky?) about templates.

about handling the debug plugin files,
also "ha_example.*" are dropped.

While here:

 - split INSTALL_*DIR variables into two sections, first set the major
   variables, then second set the minor ones, using the major where
   appropriate.

 - format the settings for easier parsing (at least with a wide terminal)

archive storage engine headers don't include my_global.h first


During the build of 5.5.3-m3 on older Linux platforms
(kernels 2.4 or early 2.6),
the symptom described in the bug report occurred both
in the "archive" and in the "innobase" storage engine.

This change is the patch proposed in that bug report,
and a similar one in innobase, that latter is aligned
with Vasil Dimov of Innobase, the original author.

as found necessary during the release build of 5.5.3-m3.

scripts/CMakeLists.txt:
  The scripts "mysqldumpslow" and "mysqlhotcopy" need to be handled.
scripts/make_win_bin_dist:
  1) We do not create ".map" files any more.
  
  2) Typing error fixed, it isn't "$DISTDIR" but "$DESTDIR".
  
  3) Security fix:
     If the argument isn't of the form "dst=src",
     then we want the variables to be empty.
  The original code would have used an argument "foo"
  to set both "$src" and "$dst" to this string,
  which doesn't make much sense.

A variable declaration was preceded by "DBUG_PRINT()".

sql-common/client.c:
  Thou shalt not declare a variable after an executable statement
  (and "DBUG_PRINT()" is executable).

extracted from a work-in-progress development branch
just for the build of 5.5.3-m3.

The "cmake" way still shows issues in our release build environment.
Block it temporarily, but in a way that can easily be undone.

This change is to be reverted once the problems are solved.

BUILD/choose_configure.sh:
  Easiest way: Preset "HAVE_CMAKE=no"

There are two issues fixed here:

  1. We needed to update the result file, for some of 
     mysqlbinlog_* tests, because now the some padding chars
     are not output anymore.

  2. We needed to change the Field_string::pack so that
     for BINARY types the padding chars are not packed 
     (lengthsp will return full length for these types).

The problem is introduced by WL#4435 "Support OUT-parameters in 
prepared statements".
When a statement that has out parameters was reprepared,
the reprepare request error was ignored, and an
attempt to send out parameters to the client was made.

Since the out parameter list was not initialized in case
of an error, this attempt led to a crash.

Don't try to send out parameters to the client
if an error occurred in statement execution.

sql/sql_prepare.cc:
  Don't try to send out parameters if error.
tests/mysql_client_test.c:
  Re-enable the test case for Bug#49972.