On Sat, Mar 04, 2006 at 05:37:37PM +0900, Charles Plessy wrote: > On Sun, Feb 12, 2006 at 10:08:39AM -0500, Justin Pryzby wrote : > > > undocumented.7 manpages are now discouraged, I think. So just write a > > real manpage, not just a minimal one, or otherwise do the best you > > can, forward it upstream, hope it gets included, and hope people > > improve it, too. > > Hi, > > I wrote a manpage, using the sgml template provided in the /debian > directory. I am running in two problems: > > a) I can not build it automatically, despite the line containing > docbook-to-man debian/tv.sgml > tv.1 in the rules file. > > b) It is not very easy to write perfect sgml, but I could not find a > validator such as tidy. Could somebody suggest one for me ? I don't know but I'd bet that one of these packages does it:
grep-dctrl -n -s Package -F Build-Depends-Indep docbook-to-man <(bzcat /var/cache/apt/Sources.bz2) (also try Build-Depends) > Also, I welcome comments on the contents of the manpage, which you can > find at http://charles.plessy.org/debian/treeviewx/tv.html This is pretty good; does the prog accept options? You might say just "portable" instead of listing platforms; perhaps alongside "open source". You should also document the "file" argument in a separate section or paragraph. Justin -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
