Bug#1062772: apt: apt.conf(5) should document all options

2024-02-20 Thread Thorsten Glaser
Hi Wesley,

> /usr/share/doc/apt/examples/configure-index. It documents all the options you
> can find.

ah, interesting.

It does not document all the options I can find, though.

It lists them all. Some have a short comment, which for
a small number of them passes for documentation; default
values are also only shown exceedingly rarely.

That is more useful than not having it, but… still not
quite there yet ☺

bye,
//mirabilos
-- 
15:41⎜ Somebody write a testsuite for helloworld :-)



Bug#1062772: apt: apt.conf(5) should document all options

2024-02-20 Thread Wesley Schwengle

Hi Thorsten,


I would expect apt.conf(5) to document any and all configuration
items one can do to apt*, either directly or by other manpages
referenced from “SEE ALSO”.


The man page of apt.conf shows the following:

EXAMPLES
   /usr/share/doc/apt/examples/configure-index.gz is a 
configuration file showing example values for all possible options.


The file location is incorrect (on Debian sid), this should be 
/usr/share/doc/apt/examples/configure-index. It documents all the 
options you can find.


Cheers,
Wesley

--
Wesley Schwengle
E: wes...@schwengle.net



Bug#1062772: apt: apt.conf(5) should document all options

2024-02-02 Thread Thorsten Glaser
Package: apt
Version: 2.2.4
Severity: normal
X-Debbugs-Cc: t...@mirbsd.de

With “apt-config dump”, one can see lots of options, but they
mostly are not documented, so for example APT::Cmd::Pattern-Only
(which only shows up in Binary::apt:: so even “apt-config dump”
hides some options unless they are used anywhere).

I would expect apt.conf(5) to document any and all configuration
items one can do to apt*, either directly or by other manpages
referenced from “SEE ALSO”.


-- Package-specific info:

-- (no /etc/apt/preferences present) --


-- (/etc/apt/preferences.d/dash-mksh.pref present, but not submitted) --


-- (/etc/apt/preferences.d/ncurses-term-considered-harmful present, but not 
submitted) --


-- (/etc/apt/preferences.d/prevent-apparmor present, but not submitted) --


-- (/etc/apt/preferences.d/prevent-aptitude present, but not submitted) --


-- (/etc/apt/preferences.d/prevent-consolekit present, but not submitted) --


-- (/etc/apt/preferences.d/prevent-drexim present, but not submitted) --


-- (/etc/apt/preferences.d/prevent-networkmanager present, but not submitted) --


-- (/etc/apt/preferences.d/prevent-packagekit present, but not submitted) --


-- (/etc/apt/preferences.d/prevent-policykit present, but not submitted) --


-- (/etc/apt/preferences.d/prevent-pulseaudio present, but not submitted) --


-- (/etc/apt/preferences.d/prevent-puppet present, but not submitted) --


-- (/etc/apt/preferences.d/prevent-ruby present, but not submitted) --


-- (/etc/apt/preferences.d/prevent-systemd-completely present, but not 
submitted) --


-- (/etc/apt/preferences.d/prevent-systemd-installed present, but not 
submitted) --


-- (/etc/apt/preferences.d/prevent-systemd-running present, but not submitted) 
--


-- (/etc/apt/preferences.d/prevent-unattended-upgrades present, but not 
submitted) --


-- (/etc/apt/preferences.d/prevent-usrmove present, but not submitted) --


-- (/etc/apt/preferences.d/systemd present, but not submitted) --


-- (no /etc/apt/sources.list present) --


-- (/etc/apt/sources.list.d/bullseye.list present, but not submitted) --


-- (/etc/apt/sources.list.d/wtf.list present, but not submitted) --


-- System Information:
Debian Release: 11.8
  APT prefers oldstable-updates
  APT policy: (500, 'oldstable-updates'), (500, 'oldstable-security'), (500, 
'oldstable-proposed-updates'), (500, 'oldstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 5.10.0-27-amd64 (SMP w/2 CPU threads)
Kernel taint flags: TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=C, LC_CTYPE=C (charmap=UTF-8) (ignored: LC_ALL set to C.UTF-8), 
LANGUAGE not set
Shell: /bin/sh linked to /bin/lksh
Init: sysvinit (via /sbin/init)

Versions of packages apt depends on:
ii  adduser 3.118+deb11u1
ii  debian-archive-keyring  2021.1.1+deb11u1
ii  gpgv2.2.27-2+deb11u2
ii  libapt-pkg6.0   2.2.4
ii  libc6   2.31-13+deb11u7
ii  libgcc-s1   10.2.1-6
ii  libgnutls30 3.7.1-5+deb11u4
ii  libseccomp2 2.5.1-1+deb11u1
ii  libstdc++6  10.2.1-6
ii  libsystemd0 247.3-7+deb11u4

Versions of packages apt recommends:
ii  ca-bundle [ca-certificates]  20190604

Versions of packages apt suggests:
pn  apt-doc  
pn  aptitude | synaptic | wajig  
ii  dpkg-dev 1.20.13
ii  gnupg2.2.27-2+deb11u2
ii  gnupg1   1.4.23-1.1
pn  powermgmt-base   

-- Configuration Files:
/etc/cron.daily/apt-compat changed [not included]
/etc/logrotate.d/apt changed [not included]

-- no debconf information