Merge abotchkov@bk-internal.mysql.com:/home/bk/mysql-4.1

into deer.(none):/home/hf/work/mysql-4.1.2way

INSTALL-WIN-SOURCE

+#########################################################
+#                                                       #
+#         HOWTO : INSTALL MySQL FROM SOURCE             #
+#                    WINDOWS PORT                       #
+#                                                       #  
+#           Copyright (C) MySQL AB 1995-2003            #
+#########################################################
+
+This is a simple 'HOWTO' document describing how to
+build MySQL binaries for versions 4.1 and above on
+Windows. Instructions are provided for building binaries
+from a standard source distribution or from the BitKeeper
+tree that contains the latest developer source.
+
+---------------------------------------------------------
+NOTE
+---------------------------------------------------------
+
+Normally, it is best to use precompiled binary distributions
+of MySQL that are built specifically for optimal performance
+on Windows by MySQL AB.  Binary distributions are available
+from:
+
+http://www.mysql.com/downloads/
+
+The instructions in this document are strictly for users
+who want to test MySQL on Windows from the latest source or
+from the BitKeeper tree, and for internal MySQL developers.
+
+--------------------------------------------------------
+TABLE OF CONTENTS
+--------------------------------------------------------
+1. REQUIREMENTS
+2. OBTAINING A WINDOWS SOURCE DISTRIBUTION
+3. CREATING A SOURCE PACKAGE FROM THE 'BitKeeper' TREE
+4. BUILDING 'mysql server and clients' FROM VC++ WORKSPACE
+5. BUILDING FROM 'nmake' MAKEFILES
+6. STARTING THE MYSQL SERVER FOR THE FIRST TIME
+7. TESTING THE CONNECTION
+8. SPECIAL NOTES AND CONSIDERATIONS
+
+-------------------------------------------------------
+1. REQUIREMENTS
+-------------------------------------------------------
+
+To build MySQL on Windows from source, you need the
+following compiler and resources available on your Windows
+system:
+
+   - Microsoft Visual C++ 6.0 and above
+   - ~45 MB disk space
+   - 64 MB RAM
+
+You'll also need a MySQL source distribution.  You can
+get the source for released versions of MySQL from:
+
+http://www.mysql.com/downloads/
+
+Alternatively, you can package a source distribution
+yourself from the latest BitKeeper developer source
+tree. If you plan to do this, you must create the
+package on a Unix system and then transfer it to your
+Windows system.  (The reason for this is that the initial
+configuration scripts and some of the build steps work
+only on Unix.)  The BitKeeper approach thus requires:
+
+   - A system running Unix, or a Unix-like system such as Linux
+   - BitKeeper 3.0 installed on that system (you can obtain
+     BitKeeper from http://www.bitkeeper.com)
+
+-------------------------------------------------------
+2. OBTAINING A WINDOWS SOURCE DISTRIBUTION
+-------------------------------------------------------
+
+There are two ways you can get a Windows source distribution for 
+MySQL version 4.1 and above:
+
+ I.  Obtain a MySQL AB-distributed source distribution for the
+     particular version of MySQL in which you are interested.
+     Prepackaged source distributions are available for released
+     versions of MySQL and can be obtained from:
+     
+     http://www.mysql.com/downloads/
+
+ II. Create a source package yourself from the latest development 
+     'BitKeeper' source tree.
+
+If you are using the first option, you can skip the  next
+section and go directly to 'BUILDING FROM VC++ WORKSPACE'.
+
+-------------------------------------------------------
+3. CREATING A SOURCE PACKAGE FROM THE 'BitKeeper' TREE
+-------------------------------------------------------
+
+To build the latest Windows source package, Please follow the 
+following instructions from any of your '*UNIX*' operating 
+systems (preferably Linux):
+
+- Clone the BitKeeper source tree for MySQL (version 4.1
+  or above, as desired).  For more information how to clone
+  the BitKeeper source tree, follow the instructions at:
+
+  http://www.mysql.com/doc/en/Installing_source_tree.html
+
+- Build the distribution so that you have a server binary to
+  work with.  One way to do this is to run the following
+  command in the top-level directory of your source tree:
+
+  ./BUILD/compile-pentium-max
+
+- After making sure that  build process completed successfully,
+  run the following utility script from top-level directory
+  of your source tree:
+
+  ./scripts/make_win_src_distribution
+
+  This script creates the Windows source package.  You can
+  supply different options to the script based on your needs.
+  It accepts: the following options:
+
+    --debug   Debug, without creating the package
+    --tmp     Specify the temporary location
+    --suffix  Suffix name for the package
+    --dirname Directory name to copy files (intermediate)
+    --silent  Do not list verbosely files processed
+    --tar     Create tar.gz package instead of .zip
+    --help    Show this help message
+
+   By default, make_win_src_distribution creates a zipped
+   archive with the name mysql-$version-win-src.zip, where
+   $version is the version of the MySQL source tree you
+   cloned.
+ 
+ - Copy or upload to your Windows machine the Windows source
+   package that you have just created, and compile it using
+   the instructions in the next section.
+
+---------------------------------------------------------
+4. BUILDING 'mysql server & clients'  FROM VC++ WORKSPACE
+---------------------------------------------------------
+
+NOTE: MySQL 4.1 and above VC++ workspace files are compatible
+      with Microsoft Visual Studio 6.0 and above(7.0/.NET)
+      editions and tested by MySQL folks before each 
+      release.
+
+Unpack the Windows source zipped archive to a folder and open 
+mysql.dsw from your top-level directory.
+
+If you want to build both release and debug versions, then
+select 'build' -> 'buildall' option. To build only 'release'
+or 'debug' versions, then select all appropriate workspaces
+from the 'build' -> 'batch build' option.
+
+The simplest solution to build basic clients and core
+server is to set your current active workspace as 'mysqld'
+release or debug version, and just hit 'build' or 'F7', which
+creates necessary client binaries in the 'client_release' or
+'client_debug' directories. The libraries are placed in the
+'lib_release' and 'lib_debug' directories for release and
+debug versions, respectively.
+
+Now you have built the distribution. If you get any compiler
+errors, please cross check and send the compiler output to 
+win32@lists.mysql.com for further assistance.
+
+---------------------------------------------------------
+5. BUILDING FROM 'nmake' MAKEFILES
+---------------------------------------------------------
+TODO from MySQL PIEFU team.
+
+---------------------------------------------------------
+6. STARTING THE MYSQL SERVER FOR THE FIRST TIME
+---------------------------------------------------------
+
+First ensure to set or copy my.ini or my.cnf file to your 
+'data' directory that exists in the top-level directory or 
+point to existing 'data' directory.
+
+Now, start your server from the 'client_release' or
+'client_debug' directory (depending on which server you
+want to use), by following the instructions from:
+
+http://www.mysql.com/doc/en/Windows_installation.html
+
+That's all!!! See, it's as simple to build MySQL on Windows
+as on any other platform!!!
+
+---------------------------------------------------------
+7. TESTING THE CONNECTION
+---------------------------------------------------------
+
+Once the server is running in standalone fashion or as a
+service based on your configuration, try to connect to it
+from the 'mysql' command line SQL interactive utility that
+exists in your 'client_release' or 'client_debug' directory.
+
+---------------------------------------------------------
+8. SPECIAL NOTES AND CONSIDERATIONS
+---------------------------------------------------------
+
+- For production use, MySQL AB does not advise using a MySQL
+  server built by yourself from source. Instead, stick to
+  binaries shipped by MySQL AB.
+
+- If you find something not working as expected, or you have
+  suggestions about ways to improve the current build process
+  on Windows, please email to 'win32@lists.mysql.com'.
+
+Thanks
+MySQL Team

scripts/make_win_src_distribution.sh

@@ -59,6 +59,8 @@ show_usage()
   echo ""
   echo "  --debug   Debug, without creating the package"
   echo "  --tmp     Specify the temporary location"
+  echo "  --suffix  Suffix name for the package"
+  echo "  --dirname Directory name to copy files (intermediate)"
   echo "  --silent  Do not list verbosely files processed"
   echo "  --tar     Create tar.gz package instead of .zip"
   echo "  --help    Show this help message"
@@ -249,7 +251,7 @@ touch $BASE/innobase/ib_config.h
 cd $SOURCE
 for i in COPYING ChangeLog README \
          INSTALL-SOURCE INSTALL-WIN \
-         INSTALL-SOURCE-WIN \
+         INSTALL-WIN-SOURCE
          Docs/manual_toc.html  Docs/manual.html \
          Docs/mysqld_error.txt Docs/INSTALL-BINARY