Bug#864285: man page of apt incomplete, missing "clean" subcommand
On Tue, Jun 06, 2017 at 11:42:10PM +0200, L.Schmidt wrote:
> Since apt runs here on mass storage starved small single board
> computers, I do indeed consider `clean' one of the important apt
> subcommands, as in "most used", yes. I disagree with the notion that
> documentation incompleteness and referral to other documents is
> preferrable to "distraction" by information. After all, one peruses a
> man page for obtaining information, not for minimising distraction.
>
> But the man page flaw is, IMHO, not the lack of complete documention
> of `clean' functionality. Instead it is that it's not evident from
> the man page that this subcommand is understood and executed. There
> may be other supported subcommands, about which I don't know from
> reading the man page alone - instead I may have to trial and error
> potential candidates (or look for other sources of information).
It's complicated. I guess we could rework the manual pages so
that they basically just include common snippets, and duplicate
all the needed stuff that way, but do we want that? (maybe yes,
I'm not sure).
In any case, I'm not likely to work on this, but if someone comes
up with a clean set of patches - well, we can talk.
--
Debian Developer - deb.li/jak | jak-linux.org - free software dev
| Ubuntu Core Developer |
When replying, only quote what is necessary, and write each reply
directly below the part(s) it pertains to ('inline'). Thank you.
Reply to: