Bug #58576 Building from source on Windows documentation is out of date for 5.5
Submitted: 30 Nov 2010 1:46 Modified: 3 Jan 2011 11:33
Reporter: Sunny Bains Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:mysql-5.5-innodb OS:Any
Assigned to: CPU Architecture:Any

[30 Nov 2010 1:46] Sunny Bains
Description:
http://dev.mysql.com/doc/refman/5.5/en/windows-source-build.html - The entire page seems to be irrelevant for >= 5.5 builds.

e.g.,
 "Within the command shell, navigate to the work directory and run the following command:
  C:\workdir>win\configure.js options"

There is no win/configure.js.  The only file in win/ is create_def_file.js

INSTALL-WIN-SOURCE has a link to the 5.1 documentation - I think it can be removed

The only file required is BUILD-CMAKE and it has the correct information. This file should be used to
rewrite the build documentation.

How to repeat:
Try and build the system on Windows by following the 5.5 documentation.
[30 Nov 2010 4:13] Valeriy Kravchuk
Your URL redirects me to http://dev.mysql.com/doc/refman/5.5/en/source-installation.html and if I navigate to http://dev.mysql.com/doc/refman/5.5/en/installing-source-distribution.html from there I see more or less correct description of current build process on Windows. Do I miss something?
[30 Nov 2010 4:20] Sunny Bains
It does indeed. But not when I filed the bug. I tried to retrace my steps.
This is what I did originally:

 http://dev.mysql.com/doc/refman/5.1/en/windows-source-build.html

Then I clicked on the 5.5 link in the top left corner. However, now when I
click on the 5.5 link it takes me back the above URL. The URL I pasted
earlier was a copy and paste from the navigation bar.
[30 Nov 2010 4:27] Valeriy Kravchuk
Looks like there is no such page in 5.5 manual any more. Similar behavior happens when, say, you ask for 5.0 version of some page that described unique 5.5 feature.

Can you, please, summarize what documentation problems with regard to building on Windows do you see now in 5.5 (after this page disappeared).
[30 Nov 2010 4:31] Sunny Bains
WIth the ghost page now out of the way, my only gripe then is this:

sunny@imac:mysql-5.5-innodb> vim INSTALL-WIN-SOURCE 

You can find information about how to install from a Windows source
distributions at

  http://dev.mysql.com/doc/refman/5.1/en/windows-source-build.html

The MySQL Reference Manual is also available in various formats on
http://dev.mysql.com/doc; if you're interested in the DocBook XML
sources go to http://svn.mysql.com.

---
My suggestion is to simply remove this file.
[1 Jan 2011 0:00] Bugs System
No feedback was provided for this bug for over a month, so it is
being suspended automatically. If you are able to provide the
information that was originally requested, please do so and change
the status of the bug back to "Open".