Re: Debian package for TreeView X
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
Reply to: