[Aptitude-devel] Bug#776789: aptitude-doc-en: Inconsistent documentation about --show-summary's configuration option: Aptitude::CmdLine::Show-Summary vs Aptitude::CmdLine::Why-Display-Mode

[Axel Beckert]

Package: aptitude-doc-en
Version: 0.6.11-1
Severity: minor
Usertags: found-during-book-writing

Hi,

in the man page aptitude(8), there is written for --show-summary:

  This option corresponds to the configuration item
  Aptitude::CmdLine::Show-Summary; if --show-summary is present on the
  command-line, it will override Aptitude::CmdLine::Show-Summary.

Looking at the version of the man page included in aptitude-doc-en,
e.g. at
https://aptitude.alioth.debian.org/doc/en/rn01re01.html#cmdlineOptionShowSummary
and clicking on the link labeled "Aptitude::CmdLine::Show-Summary", I
get to
https://aptitude.alioth.debian.org/doc/en/ch02s05s05.html#configCmdLine-Show-Summary

But the option to which the browser jumped is not
Aptitude::CmdLine::Show-Summary but Option:
Aptitude::CmdLine::Why-Display-Mode. Excerpt from the HTML code of that page

<a name="configCmdLine-Show-Summary"></a>
<div class="seg"><strong><span class="segtitle">Option: </span></strong>
<code class="literal">Aptitude::CmdLine::Why-Display-Mode</code></div>

Looks as if either of these two options has been renamed in the past and
this inconsistency has been overseen when the renaming was done.

-- System Information:
Debian Release: 8.0
  APT prefers testing
  APT policy: (909, 'testing'), (500, 'testing-updates'), (500, 'testing-proposed-updates'), (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 3.16.0-4-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

aptitude-doc-en depends on no packages.

aptitude-doc-en recommends no packages.

Versions of packages aptitude-doc-en suggests:
ii  aptitude  0.6.11-1+b1

-- no debconf information