Re: Custom undocumented(7)s are just as bad.
Zed Pobre <zed@resonant.org> writes:
> On Thu, Jan 20, 2000 at 11:01:30PM -0300, Nicolás Lichtmaier wrote:
> > a binary is not meant to be called by the user, it is a bug to have it in
> > the PATH.
> Yup. It probably is. In some cases, a permanent bug, since sheer
> logistics are going to prevent some things from being fixed. So do
> you prefer that instead of having a bug filed for a missing manpage,
> you have a bug filed for a possibly incorrect location? Because
> there's going to be an outstanding report either way.
Actually, if there is no man page or if undocumented(7) is used, then
there should be be *two* bug reports! IOW, both.
OTOH, you can write a quick-and-dirty man page that says, "this
program is not intended to be used directly, it is called by foo(1).
It should really be kept in /usr/lib/foo, but this would require a lot
of difficult work and might cause things to break in the meantime."
If you do that, then you can at least close one of the bug reports.
--
Chris Waters xtifr@dsp.net | I have a truly elegant proof of the
or xtifr@debian.org | above, but it is too long to fit into
http://www.dsp.net/xtifr | this .signature file.
Reply to: