Bug#520831: apt.conf(5): please mention /etc/apt/apt.conf.d

[Vincent McIntyre <Vince.McIntyre@atnf.csiro.au>]

package: apt
version: 0.6.46.4-0.1 
tags: patch
severity: wishlist


Hi,
I was looking into the order in which apt processes /etc/apt/apt.conf and 
the /etc/apt/apt.conf.d/* files, and noticed the apt.conf.d directory is
only mentioned in the apt-get(5) manpage. The ordering is indeed explained
in the first paragraphs of apt.conf(5) but there's no mention of the 
apt.conf.d directory. It would be nice to have this connection made
clearer.

Please consider the attached patch against apt-0.7.20.2.

Thanks
Vince

diff -urN -ruN apt-0.7.20.2.orig/doc/apt.conf.5.xml apt-0.7.20.2/doc/apt.conf.5.xml
--- apt-0.7.20.2.orig/doc/apt.conf.5.xml	2009-02-08 02:09:35.000000000 +1100
+++ apt-0.7.20.2/doc/apt.conf.5.xml	2009-03-23 08:27:43.000000000 +1100
@@ -786,7 +786,17 @@
  </refsect1>
  
  <refsect1><title>Files</title>
-   <para><filename>/etc/apt/apt.conf</filename></para>
+   <variablelist>
+      <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>
+      <listitem><para>APT configuration file.
+      Configuration Item: <literal>Dir::Etc::Main</literal>.</para></listitem> 
+      </varlistentry>
+
+      <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>
+      <listitem><para>APT configuration file fragments.
+      Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem>
+      </varlistentry>
+   </variablelist>
  </refsect1>
  
  <refsect1><title>See Also</title>