Bug #21220 mysqld manpage has wrong section
Submitted: 21 Jul 2006 17:51 Modified: 28 Jul 2006 19:50
Reporter: Christian Hammers (Silver Quality Contributor) (OCA) Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Packaging Severity:S3 (Non-critical)
Version:all OS:
Assigned to: Paul DuBois CPU Architecture:Any

[21 Jul 2006 17:51] Christian Hammers 
Description:
The mysqld manpage belongs to section 8 not 1.

(I had this as Debian specific patch flying around for month as it was reported as Debian bug and I'm currently cleaning up :-))

bye,

-christian-

How to repeat:
man mysqld

Suggested fix:
--- old/man/mysqld.1.orig       2004-06-01 01:03:50.000000000 +0200
+++ new/man/mysqld.1    2004-06-01 01:03:56.000000000 +0200
@@ -1,2 +1,2 @@
-.TH "\\FBMYSQLD\\FR" "1" "07/04/2006" "MySQL 5.0" "MySQL Database System"
+.TH "\\FBMYSQLD\\FR" "8" "07/04/2006" "MySQL 5.0" "MySQL Database System"
 .SH NAME
[23 Jul 2006 6:33] Valeriy Kravchuk 
Thank you for a bug report.
[24 Jul 2006 22:24] Paul DuBois 
I'm curious why this comes up now. The mysqld manpage has
been in section 1 forever -- since 3.23 at least.
[24 Jul 2006 22:46] Christian Hammers 
Hi Paul

Yes it has, and since about 4.0 there has been a Debian specific patch which put it into section 8 where postfix, apache, inetd, sshd etc. pp. are as well.
(rule of thumb: /usr/bin -> man1 and /usr/sbin -> man8)
I just want to get rid of as many Debian specific patches as possible so I took the time and reported it, even it's so minor :)

bye,

-christian-
[28 Jul 2006 19:50] 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 products.

I have reclassified these manpages from volume 1 to volume 8:

4.1: mysqld
5.0, 5.1: mysqld, mysqlmanager
[28 Jul 2006 20:50] Bugs System 
A patch for this bug has been committed. After review, it may
be pushed to the relevant source trees for release in the next
version. You can access the patch from:

  http://lists.mysql.com/commits/9736

ChangeSet@1.2189, 2006-07-28 22:49:42+02:00, kent@mysql.com +1 -0
  mysql.spec.sh:
    Man page for "mysqld" command move to section 8 (bug#21220)
[28 Jul 2006 20:58] Bugs System 
A patch for this bug has been committed. After review, it may
be pushed to the relevant source trees for release in the next
version. You can access the patch from:

  http://lists.mysql.com/commits/9737

ChangeSet@1.2189, 2006-07-28 22:57:57+02:00, kent@mysql.com +1 -0
  mysql.spec.sh:
    Man page for "mysqld" command move to section 8 (bug#21220)
[28 Jul 2006 21:09] Bugs System 
A patch for this bug has been committed. After review, it may
be pushed to the relevant source trees for release in the next
version. You can access the patch from:

  http://lists.mysql.com/commits/9739

ChangeSet@1.2190, 2006-07-28 23:06:49+02:00, kent@mysql.com +1 -0
  make_binary_distribution.sh:
    Man page for "mysqld" command move to section 8 (bug#21220)
[28 Jul 2006 21:12] Bugs System 
A patch for this bug has been committed. After review, it may
be pushed to the relevant source trees for release in the next
version. You can access the patch from:

  http://lists.mysql.com/commits/9740

ChangeSet@1.2191, 2006-07-28 23:12:40+02:00, kent@mysql.com +2 -0
  Makefile.am, configure.in:
    Man page for mysqld command move to section 8 (bug#21220)