[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: minimal documentation or usefulness of new package -- teleport?

On 08-Oct-03, 15:40 (CDT), Moray Allan <moray@sermisy.org> wrote: 
> Indeed. Why do you assume that there would be Debian-specific documents?
> [snip] 
> Indeed. Why do you assume there would be info documents?
> [snip] 

I think he was just noting that he'd looked in all the different typical
places for documentation.

> I suspect you'd save time on Debian systems by looking for man pages
> before other possible forms of documentation.

It varies. There's a lot of manpages that point to info pages, or HTML
under /usr/share/doc/. Not to mention good old undocumented(7).

> > Hmm, --help does not display help, nor does -h. 
> Do you usually feed programmes random options not included in their
> man pages?

Random? Hardly. Programs that don't recognize (at least one of) -h or
--help, even if only to point the user at the real documentation, are
buggy. This is a long standing Unix convention, and is one of the first
things that ought to be implemented in a new package. IF nothing else,
it can say "No docs yet" so the poor user doesn't waste her time looking
for them.

> Please file bugs rather than ranting on debian-devel.

But this is exactly the correct answer. Problems with individual
packages are exactly that. If you want a problem fixed, file a bug. If
the solution to the problem needs to be discussed in a wider venue, then
it will be.


Steve Greenland
    The irony is that Bill Gates claims to be making a stable operating
    system and Linus Torvalds claims to be trying to take over the
    world.       -- seen on the net

Reply to: