--- Begin Message ---
- To: Debian Bug Tracking System <submit@bugs.debian.org>
- Subject: apt-config: manpage not specific enough about the main functionality of the tool
- From: Christian Buhtz <c.buhtz@posteo.jp>
- Date: Sun, 12 Feb 2017 13:06:23 +0100
- Message-id: <148690118363.18145.5022918224285891709.reportbug@localhost>
Package: apt-config
Severity: minor
Dear Maintainer,
the first lines of the german(!) manpage of apt-config (Debian unstable) are
not specific enough.
They don't tell exactly with clear words what the tool does. Because of that
and because of the name of the tool the user can implicite that it is possible
to modify the configuration of apt with it. But it is not possible - when I
understand it correct.
Please reformulate the lines and maybe add the information that it is not
possible to modifiy the configuration. Please check the english (original?)
version of the manpage for the same issues.
kind
-- System Information:
Debian Release: 9.0
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 4.9.9-towo.1-siduction-686 (SMP w/2 CPU cores; PREEMPT)
Locale: LANG=de_DE.utf8, LC_CTYPE=de_DE.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
--- End Message ---
--- Begin Message ---
On Sun, Feb 12, 2017 at 09:31:45PM +0200, Adrian Bunk wrote:
> Control: reassign -1 apt
>
> apt-config is part of the apt package.
>
> On Sun, Feb 12, 2017 at 01:06:23PM +0100, Christian Buhtz wrote:
> > Package: apt-config
> > Severity: minor
> >
> > Dear Maintainer,
> >
> > the first lines of the german(!) manpage of apt-config (Debian unstable) are
> > not specific enough.
> >
> > They don't tell exactly with clear words what the tool does. Because of that
> > and because of the name of the tool the user can implicite that it is possible
> > to modify the configuration of apt with it. But it is not possible - when I
> > understand it correct.
The NAME explictly states that it is a configuration *query* tool:
msgstr "APT-Konfigurationsabfrageprogramm"
and the description just gives you two query commands, so everything
is explicitly stated.
If you just read the first DESCRIPTION line without reading the NAME,
that's weird, but please read the NAME field - it'S there for a reason.
Closing.
--
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.
--- End Message ---