Bug #14729 Incorrect statement in the manual: internals.texi is not in distribution
Submitted: 8 Nov 2005 2:53 Modified: 8 Nov 2005 3:51
Reporter: Sergey Petrunya Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version: OS:
Assigned to: CPU Architecture:Any
Triage: D4 (Minor)

[8 Nov 2005 2:53] Sergey Petrunya
Description:
The page http://dev.mysql.com/doc/refman/5.0/en/optimizing-subqueries.html says:
<<<
There is a chapter titled ¿How MySQL Transforms Subqueries¿ in the MySQL
Internals Manual. You can obtain this document by downloading the MySQL
source package and looking for a file named internals.texi in the Docs
directory.
>>>

This is not true. I downloaded 5.0 tarball source from 
http://dev.mysql.com/get/Downloads/MySQL-5.0/mysql-5.0.15.tar.gz/from/pick , 
and in Docs/ directory I only see:

drwxrwxrwx 503/100           0 2005-10-17 05:36:40 mysql-5.0.15/Docsa/
drwxrwxrwx 503/100           0 2005-10-17 05:36:40 mysql-5.0.15/Docs/Support/
-rwxr-xr-x 503/100         626 2005-10-17 05:27:55 mysql-5.0.15/Docs/Support/generate-text-files.pl
-rw-r--r-- 503/100        2258 2005-10-17 05:27:29 mysql-5.0.15/Docs/Makefile.am
-rw-r--r-- 503/100       16460 2005-10-17 05:28:59 mysql-5.0.15/Docs/Makefile.in
-rw-r--r-- 503/100     4275355 2005-10-17 05:28:07 mysql-5.0.15/Docs/mysql.info
-rw-r--r-- 503/100        7940 2005-10-17 05:31:26 mysql-5.0.15/Docs/INSTALL-BINARY

How to repeat:
n/a

Suggested fix:
Change the above quoted passage to link to http://dev.mysql.com/docs/internals/
[8 Nov 2005 3:51] Paul Dubois
Thank you for your bug report. This issue has been addressed in the
documentation. The updated documentation will appear on our website
shortly, and will be included in the next release of the relevant
product(s).

Additional info:

Thanks, I've changed the passage to refer to the general
documentation page (http://dev.mysql.com/doc/), where
the Internals manual is available in several formats.

There were also some obsolete references to the Docs
directory in the APIs chapter.  I've updated those as well.