Bug 67554

Summary:	man-cgi visual glitch on 3-word titles
Product:	Documentation	Reporter:	Chris Pepper <pepper>
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Closed FIXED
Severity:	Affects Only Me	CC:	pepper
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description Chris Pepper 2004-06-04 03:50:19 UTC

	Three-word titles, like "INTRODUCTION TO USB" in http://www.freebsd.org/cgi/man.cgi?query=usb&sektion=4&manpath=FreeBSD+4.10-RELEASE & PRINCIPLES of OPERATION in http://www.freebsd.org/cgi/man.cgi?query=polling&sektion=4&manpath=FreeBSD+4.10-RELEASE are inconsistently displayed.

Fix: 

I don't know, but presumably the heading code in man.cgi needs a little TLC.
How-To-Repeat: 	Under 4.10-STABLE, "man usb polling", and compare against the above URLs.

	In the USB web page, " USB" is not blue underlined to match "INTRODUCTION TO", which is. In the source, the b & a close tags are after OF, rather than OPERATION.

	In the polling web page, " OPERATION" is not blue underined, while "PRINCIPLES OF" is. Interestingly, "Principles of Operation" is mixed-case and indented one level in the man command itself, while its boldface and flush left on the web.

	Presumably this is a problem with man.cgi, although I suppose it could be triggered by odd markup in the source.

Comment 1 Chris Pepper 2004-06-04 04:07:54 UTC

	A related note: in 
http://www.freebsd.org/cgi/man.cgi?query=rl&apropos=0&sektion=4&manpath=FreeBSD+4.10-RELEASE&format=html, 
under DIAGNOSTICS, 'D0' is not capitalized in "rl%d: chip is in D3 
power state -- setting to D0". The man source under 4.10-STABLE has 
D0 correctly boldfaced.


						Regards,


						Chris Pepper
-- 
Chris Pepper:               <http://www.reppep.com/~pepper/>
Rockefeller University:     <http://www.rockefeller.edu/>

Comment 2 Simon L. B. Nielsen freebsd_committer

2004-06-27 20:42:51 UTC

On 2004.06.03 22:46:41 -0400, Chris Pepper wrote:
>
> Three-word titles, like "INTRODUCTION TO USB" in
> http://www.freebsd.org/cgi/man.cgi?query=usb&sektion=4&manpath=FreeBSD+4.10-RELEASE
> & PRINCIPLES of OPERATION in
> http://www.freebsd.org/cgi/man.cgi?query=polling&sektion=4&manpath=FreeBSD+4.10-RELEASE
> are inconsistently displayed.
>
> In the USB web page, " USB" is not blue underlined to match
> "INTRODUCTION TO", which is. In the source, the b & a close tags are
> after OF, rather than OPERATION.
>
> In the polling web page, " OPERATION" is not blue underined, while
> "PRINCIPLES OF" is. Interestingly, "Principles of Operation" is
> mixed-case and indented one level in the man command itself, while its
> boldface and flush left on the web.
>
> Presumably this is a problem with man.cgi, although I suppose it
> could be triggered by odd markup in the source.


I just had a quick look at the source code for man.cgi.  It parses the
output from man(1) and does so using perl at it's best/worst with a
lot of regular expressions, so fixing this isn't simple.

I just cc'ed Wolfram Schneider who is the original author of man.cgi
and unless he has a quick fix I wouldn't count on this problem being
fixed any time soon - it's just too much black perl magic :-).

-- 
Simon L. Nielsen
FreeBSD Documentation Team

Comment 3 Wolfram Schneider freebsd_committer

2007-07-16 18:50:08 UTC

State Changed
From-To: open->closed

fixed in rev 1.176 www/en/cgi/man.cgi 
Thanks for your report!