Re: [eboard-devel] eboard-config(1) and eboard-addtheme(1) manpages

[Daniel B. <dbu...@br...>]

On Sat, Jun 23, 2001 at 12:28:20AM -0400, Felipe Bergo <be...@se...> was heard to say:
> Does the debian GTK+ package include a man page for gtk-config ? Does the
> Debian XMMS package include a man page for xmms-config ?

  As a matter of fact, gtk-config comes with a manpage written by
Owen Taylor.  xmms-config doesn't, gnome-config does.

> I think man pages for these scripts is overkill. Please check in other
> debian packages whether they really write man pages for these -config
> scripts.

  I disagree.  Any command the user might want to run (and this does
include the -config scripts) should be documented IMO.  (and also in the
opinion of Debian policy)

  It is possible to link the manpage to a page which says "there is no
manpage for this program", but that is considered a bug in the program.
(see http://www.debian.org/doc/debian-policy/ch-docs.html#s13.1)
I prefer to just write a manpage if possible.

> And I wouldn't like to have 'debian-only' eboard files, if you need to
> include such man pages, I'll add them to CVS and to the next versions of
> eboard.

  Ok.  Go ahead and use mine if you want to.

  Daniel

-- 
/-------------------- Daniel Burrows <dbu...@br...> --------------------\
|          "Of course you can't see the guards.  They DON'T EXIST!"           |
|          "Oh my god, we're surrounded!" "Run away, run away!"               |
|           -- Fluble                                                         |
\------- Listener-supported public radio -- NPR -- http://www.npr.org --------/