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: | |
Category: | MySQL Server: Documentation | Severity: | S3 (Non-critical) |
Version: | 5.0.51 | OS: | Linux |
Assigned to: | Paul DuBois | CPU Architecture: | Any |
[1 Dec 2009 11:13]
Stefan Pfab
[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.