[Aptitude-devel] Bug#801908: say how to do -v and -v -v via Aptitude::CmdLine::Verbose

[Manuel A. Fernandez Montecelo]

Control: severity -1 wishlist
Control: tags -1 + wontfix
Control: close -1


2015-10-16 00:12 積丹尼 Dan Jacobson:
>Package: aptitude
>
>
>On the man page please mention how does one specify these:
>           Aptitude::CmdLine::Verbose="once";
>           Aptitude::CmdLine::Verbose="twice";
>           Aptitude::CmdLine::Verbose=1;
>           Aptitude::CmdLine::Verbose=2;
>"
>       -v, --verbose
>           Causes some commands (for instance, show) to display extra
>           information. This may be supplied multiple times to get more and
>           more information.
>
>           This corresponds to the configuration option
>           Aptitude::CmdLine::Verbose.
>"
>

If you keep searching down for ::Verbose in the manpage itself, you get
to this:

  When combined with -v or a non-zero value for
  Aptitude::CmdLine::Verbose, this displays the entire chain of
  dependencies that lead each package to be installed. For instance:


But the full and authoritative place for the configuration values where
everything is nicely explained is here (or aptitude-doc-${lang}):

  http://aptitude.alioth.debian.org/doc/en/ch02s05s05.html

  Option: Aptitude::CmdLine::Verbose
  Default: 0
  Description: This controls how verbose the command-line mode of
  aptitude is. Every occurrence of the -v command-line option adds 1 to
  this value.

If nothing else, the default value should give a good idea of what type
the variable expects to get: integers.


It is not a good idea to start to duplicate the information everywhere
in manpage and guide (and in some cases on-line quick help and in-source
messages) -- it takes at least twice the work and can easily lead to
being out of sync (I've been fixing many such cases lately), so marking
as +wontfix and closing.


Cheers.
-- 
Manuel A. Fernandez Montecelo <manuel.montezelo at gmail.com>