Bug 121565

Summary:	dhcp-options(5) manpage incorrectly formatted omitting important information
Product:	Documentation	Reporter:	Kernel Jake <kerneljake>
Component:	Books & Articles	Assignee:	Brooks Davis <brooks>
Status:	Closed Works As Intended
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description Kernel Jake 2008-03-10 15:10:06 UTC

Large sections of the dhcp-options(5) manpage from the isc-dhcp3-server port are missing.  The text is present in the nroff source code, but the "man" program does not output the correct manpage.  You can see these missing sections with "nroff -man dhcp-options.5" but not with "man dhcp-options".

How-To-Repeat: $ export PAGER=less
$ man dhcp-options
/option dhcp-parameter-request-list
(it will not be found)
$ man dhcp-options | wc -l
433

$ cd /usr/ports/net/isc-dhcp3-server/work/dhcp-3.0.5/common
$ nroff -man dhcp-options.5 | less
/option dhcp-parameter-request-list
(it will be found)
$ nroff -man dhcp-options.5 | wc -l
1158

Comment 1 Doug Barton freebsd_committer

2011-07-07 08:28:42 UTC

State Changed
From-To: open->analyzed


The man page that's in our source tree renders properly. The issue 
here (if any) is that it's not as complete as more recent versions. 

Let Mr. DHCP sort it out, or close this.

Comment 2 Doug Barton freebsd_committer

2011-07-07 08:28:42 UTC

Responsible Changed
From-To: freebsd-doc->brooks

Comment 3 Brooks Davis freebsd_committer

2014-06-17 15:00:01 UTC

I believe the manpage for the src tree correctly documents the options it supports.  To the extent that this isn't true bugs should be filed about specific issues.