Bug #80680 INSTALL-SOURCE makes chain of references, the last one DNE "4.4.7, mysql_upgrade
Submitted: 10 Mar 2016 1:47 Modified: 21 Apr 2016 18:10
Reporter: Brian Barnes Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:5.7 OS:Linux (Source)
Assigned to: CPU Architecture:Any
Tags: INVALID POINTER CHAIN

[10 Mar 2016 1:47] Brian Barnes
Description:
the INSTALL-SOURCE doc makes references to some material which is included and some which is not.

How to repeat:
Attempt to follow section references in document:
...
If you plan to upgrade an existing version of
   MySQL to a newer version rather than install MySQL for the
   first time, see Section 2.11.1, "Upgrading MySQL," for
   information about upgrade procedures

[[ try to find 2.11.1;  found on  line 8472 ]]
2.11.1 Upgrading MySQL
   This section describes how to upgrade to a new MySQL version...
[[ So far so good ]]

This section makes another, parallel reference:
See Section 4.4.7, "mysql_upgrade --- Check and Upgrade MySQL Tables."

Search for string "4.4.7"... After 5 NEXT trys, you will find yourself back at the first.  There is NO Section 4.4.7 in the included documentation

Suggested fix:

Either include the references in a systematic, consistent way or indicate at least indicate that "See Section 4.4.7" actually means

See https://dev.mysql.com/doc/refman/5.6/en/mysql-upgrade.html
MySQL 5.6 Reference Manual // mysql_upgrade — Check and Upgrade MySQL Tables
4.4.7 mysql_upgrade — Check and Upgrade MySQL Tables

If you were tying to install this in the Vault, you would now be hosed. 

For more info, please reference section 1.2.66656666666666666666. Good luck! :)
[11 Apr 2016 7:45] MySQL Verification Team
Hello Brian Barnes,

Thank you for the report.

Thanks,
Umesh
[21 Apr 2016 18:10] Paul DuBois
Posted by developer:
 
Noted in 5.6.31 changelog.

The INSTALL-SOURCE file had partly outdated information and has been
removed from source packages. (Binary packages are unaffected).