Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.debian.user > #237797

Re: explanation of first column "v" is hiding

Show all headers | View raw

On Tue, Jul 27, 2021 at 03:38:31PM +1200, Richard Hector wrote:
> My main issue with aptitude documentation is that most of it isn't in the
> manpage, but in the 'aptitude reference manual' which is referred to without
> a link. The path given in the SEE ALSO section might be that, but it doesn't
> say so.

Agreed.  But it's a tricky line to walk, when you have a *lot* of
documentation.  It's reasonable to avoid writing bash(1)-sized man
pages, and to put the less-often-needed details in an external
reference.

However, I think the aptitude(8) man page has some room for improvement.

> But experience suggests that A means 'automatically installed' (and p stands
> for purged, which linguistically doesn't really mean 'maybe has been purged;
> maybe has never been installed').

See, it's *not just me*!  Nobody else can find the section that says
what the letters mean either.  Well, OK, not "nobody", but damned few
people know about it.

I know that "search" comes alphabetically before "why", but the most
common use of aptitude by people who only use it for one thing is
"aptitude why".  So, when there is *nothing* at all in the "why"
section that documents what the letters mean, most people will simply
assume it's not anywhere in the man page.

I would suggest taking the paragraph that describes what the letters
mean, which is currently under the "search" subcommand, and doing two
things to it:

1) Reformat it as a table.
2) Move it to a separate section, and drop a sentence in the "search"
   subcommand pointing to it.

Then, add that same sentence to the "why" subcommand, and to any other
subcommands that have the same single-letter output indicators.

Back to linux.debian.user | Previous | Next — Previous in thread | Find similar | Unroll thread

Thread

explanation of first column "v" is hiding Felix Miata <mrmazda@earthlink.net> - 2021-07-26 19:10 +0200
  Re: explanation of first column "v" is hiding l0f4r0@tuta.io - 2021-07-26 19:30 +0200
    Re: explanation of first column "v" is hiding Greg Wooledge <greg@wooledge.org> - 2021-07-26 19:50 +0200
      Re: explanation of first column "v" is hiding Andrei POPESCU <andreimpopescu@gmail.com> - 2021-07-26 21:00 +0200
        Re: explanation of first column "v" is hiding Felix Miata <mrmazda@earthlink.net> - 2021-07-26 22:40 +0200
    Re: explanation of first column "v" is hiding Polyna-Maude Racicot-Summerside <debian@polynamaude.com> - 2021-07-26 22:40 +0200
  Re: explanation of first column "v" is hiding Greg Wooledge <greg@wooledge.org> - 2021-07-26 19:30 +0200
    Re: explanation of first column "v" is hiding Andrei POPESCU <andreimpopescu@gmail.com> - 2021-07-26 21:10 +0200
    Re: explanation of first column "v" is hiding Javier Barroso <javibarroso@gmail.com> - 2021-07-27 01:20 +0200
    Re: explanation of first column "v" is hiding Richard Hector <richard@walnut.gen.nz> - 2021-07-27 05:40 +0200
      Re: explanation of first column "v" is hiding The Wanderer <wanderer@fastmail.fm> - 2021-07-27 13:30 +0200
        Re: explanation of first column "v" is hiding Greg Wooledge <greg@wooledge.org> - 2021-07-27 22:00 +0200
          Re: explanation of first column "v" is hiding <tomas@tuxteam.de> - 2021-07-27 22:10 +0200
          Re: explanation of first column "v" is hiding Richard Hector <richard@walnut.gen.nz> - 2021-07-28 01:50 +0200
            Re: explanation of first column "v" is hiding Greg Wooledge <greg@wooledge.org> - 2021-07-28 02:50 +0200
      Re: explanation of first column "v" is hiding Greg Wooledge <greg@wooledge.org> - 2021-07-27 13:30 +0200

csiph-web