Bug #49255 manpage of mysqldump doesn't list option "-d --no-data" in option table
Submitted: 1 Dec 2009 11:13 Modified: 8 Dec 2009 16:08
Reporter: Stefan Pfab Email Updates:
Status: Won't fix Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:5.0.51 OS:Linux
Assigned to: Paul Dubois CPU Architecture:Any
Triage: Needs Triage: D4 (Minor)

[1 Dec 2009 11:13] Stefan Pfab
Description:
the option "-d --no-data" is not listed in the table with all(?) options, only under this table, where these options are explained. 
The webpage 
http://dev.mysql.com/doc/refman/5.0/en/mysqldump.html
lists this option, but not with the short form "-d".

How to repeat:
- 'man mysqldump'
- search for "--no-data"
- option is not listet in table "Table 4.5. mysqldump Option Reference"

Suggested fix:
the informations presented in the manpage and in th documentation should be consistent, every option should be listed in the option reference and explained below.
[1 Dec 2009 11:30] Valeriy Kravchuk
Option -d is presented in the results of

mysqldump --help --verbose

and also it is listed with --no-data option, check http://dev.mysql.com/doc/refman/5.0/en/mysqldump.html#option_mysqldump_no-data. 

Do you want all short options to appear in the table at the top of that page?
[1 Dec 2009 11:55] Stefan Pfab
> Do you want all short options to appear in the table at the top of that page?

yes, in the manpage, the option --no-data should be listed in the table, as it is on the webpage. And, as the manpage lists also the short command forms, "-d" should be mentioned also.
[1 Dec 2009 19:15] Paul Dubois
Option tables are not included in man pages deliberately. This is a design decision for two reasons: a) It makes reading man pages unwieldy to read when you have to scroll them them to get to the rest of the page. (They serve as "jump tables" in the online manual, but can serve no such purpose in a man page. b) Some of the option tables are so big they give nroff problems.
[8 Dec 2009 16:08] Paul Dubois
Regarding short options in the option table, we have had requests both to include and exclude them, with fewer requests for change when they are excluded. So we will go with the status quo here.