* Joerg Schilling <[EMAIL PROTECTED]> [2008-01-15 14:03]: > Stephen Hahn <[EMAIL PROTECTED]> wrote: > while I see this kind of review, it reminds me on recently introduced > problems with the man pages: How recently do you mean? Many of the poorly formatted pages have always seemed to me to be tied to the conversion to SGML as the definitive source. (I'm sure you recall that the formatting used to be much worse.)
> - The man pages do no longer use the official "man -s5 man" structuring > rules. Example: Option desriptions are correctly written: > > .TP > .B \-option > option description. > > The Solaris man pages instead use strange absolut positioning and font > switching. I suspect this arises from the conversion from SGML/XML. > - Many man pages are indented too much resulting in several man pages > to become unreadable: > > Example: "man sccs-admin" Also this (but possibly incorrectly tagged in SGML). > - Several man pages include incorrectly expanded SCCS keywords. > Example "man sccs-val" where even an expected %Y% was replaced by > an expaned %T%. That's a content bug, and should be straightforward to fix. > Is there a hope that this could be changed? The first step is to file appropriate bug reports. In particular, reports against the expanded keywords mistakes you've found should be easy for the manual page writers to address. Once bug reports are filed, the various people interested in the tools (like Mike, now) can start to examine the commands and suggest remedies, etc. (If you are too busy, I can try to make time to file some of these.) - Stephen -- [EMAIL PROTECTED] http://blogs.sun.com/sch/ _______________________________________________ opensolaris-code mailing list [email protected] http://mail.opensolaris.org/mailman/listinfo/opensolaris-code
