Bug 111427

Summary: Missing chunks of text in historical manpages
Product: Documentation Reporter: Jerry Peek <jpeek>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Jerry Peek 2007-04-09 21:00:10 UTC 
I've used the historical manpages -- especially 7th Edition and 4.3 Reno -- for years, thanks.  Today I'm reading the 4.3 Reno page diff3(1), from http://www.freebsd.org/cgi/man.cgi?query=diff3&apropos=0&sektion=1&manpath=4.3BSD+Reno&format=html .  It has a problem I've seen in some other pages (but not reported before): some small bits of text are missing.

For instance, the second paragraph of DESCRIPTION begins like this:

Options are: Produces output in a form suitable as an input script for the ed(1) utility.

Which option does that describe?  It doesn't say.  Another example is in the FILES section:

FILES
     temporary files.  the executable.

I think that section should include /tmp/XXX and /usr/bin/diff3, or something.

Fix: 

I'm guessing that there's a macro call which isn't being read or handled by the man-to-html converter.  For instance, the missing -e option might have been coded as:

.XX -e
How-To-Repeat: Open the manual page I mentioned in Firefox 2.0.0.3, or probably in other browsers too.
Comment 1 Erwin Lansing freebsd_committer freebsd_triage 2007-04-09 21:18:41 UTC 
State Changed
From-To: open->closed

Duplicate of docs/111425.