Bug#478098: apt: sources.list manpage is unclear about sources.list.d

[Timothy G Abbott <tabbott@MIT.EDU>]

This bug is deeper than I thought.  The source code in sources.list.5.xml 
looks correct, but it seems docbook2man incorrectly doesn't escape dot 
when it's not at the start of a line (apparently #399947), causing the man 
page to have errors (apparently, the package has two lintian warnings 
about this).

Attached is what I believe to be a workaround patch that makes the 
<literal>.list</literal> in sources.list.5.xml not be at the start of a 
line; you'll also need to regenerate sources.list.5 from this.

	-Tim Abbott

On Sun, 27 Apr 2008, Otavio Salvador wrote:

> Timothy G Abbott <tabbott@MIT.EDU> writes:
>
> > Package: apt
> > Version: 0.7.11
> > Severity: minor
> >
> > The man pages for sources.list describes the sources.list.d directory
> > as follows:
> >
> > SOURCES.LIST.D
> >        The /etc/apt/sources.list.d directory provides a way to add
> > sources.list entries in seperate files that end with sources.list
> > file.
> >
> > I think it should be:
> >
> > SOURCES.LIST.D
> >        The /etc/apt/sources.list.d directory provides a way to add
> > sources.list entries in seperate files whose names end with .list.
> >
> > since that is more grammatical, and the filename ending seems to only
> > need to have .list, not sources.list, for apt to pick up files in
> > /etc/apt/sources.list.d.
>
> Could you take  the lastest apt sources and produce a diff making the
> suggested change?
>
> --
>        O T A V I O    S A L V A D O R
> ---------------------------------------------
> E-mail: otavio@debian.org      UIN: 5906116
> GNU/Linux User: 239058     GPG ID: 49A5F855
> Home Page: http://otavio.ossystems.com.br
> ---------------------------------------------
> "Microsoft sells you Windows ... Linux gives
> you the whole house."
--- apt-0.7.11/doc/sources.list.5.xml	2007-07-24 08:33:29.000000000 -0400
+++ sources.list.5.xml	2008-04-28 19:56:06.000000000 -0400
@@ -47,10 +47,10 @@
  </refsect1>
  
  <refsect1><title>sources.list.d</title>
-   <para>The <filename>/etc/apt/sources.list.d</filename> directory provides
-   a way to add sources.list entries in seperate files that end with 
-   <literal>.list</literal>. The format is the same as for the regular
-   <filename>sources.list</filename> file. </para>
+   <para>The <filename>/etc/apt/sources.list.d</filename> directory
+   provides a way to add sources.list entries in separate files whose
+   names end with <literal>.list</literal>. The format is the same as
+   for the regular <filename>sources.list</filename> file. </para>
  </refsect1>
 
  <refsect1><title>The deb and deb-src types</title>