[apt.git] / doc / apt.ent

<!-- -*- mode: sgml; mode: fold -*- -->

<!-- Some common paths.. -->
<!ENTITY docdir "/usr/share/doc/apt/">
<!ENTITY guidesdir "/usr/share/doc/apt-doc/">
<!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</filename>">
<!ENTITY aptconfdir "<filename>/etc/apt.conf</filename>">
<!ENTITY statedir "/var/lib/apt">
<!ENTITY cachedir "/var/cache/apt">

<!-- Cross references to other man pages -->
<!ENTITY apt-conf "<citerefentry>
    <refentrytitle><filename>apt.conf</filename></refentrytitle>
    <manvolnum>5</manvolnum>
  </citerefentry>"
>

<!ENTITY apt-get "<citerefentry>
    <refentrytitle><command>apt-get</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY apt-config "<citerefentry>
    <refentrytitle><command>apt-config</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY apt-cdrom "<citerefentry>
    <refentrytitle><command>apt-cdrom</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY apt-cache "<citerefentry>
    <refentrytitle><command>apt-cache</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY apt-preferences "<citerefentry>
    <refentrytitle><command>apt_preferences</command></refentrytitle>
    <manvolnum>5</manvolnum>
  </citerefentry>"
>

<!ENTITY apt-key "<citerefentry>
    <refentrytitle><command>apt-key</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY apt-secure "<citerefentry>
    <refentrytitle>apt-secure</refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY apt-ftparchive "<citerefentry>
    <refentrytitle><filename>apt-ftparchive</filename></refentrytitle>
    <manvolnum>1</manvolnum>
  </citerefentry>"
>


<!ENTITY sources-list "<citerefentry>
    <refentrytitle><filename>sources.list</filename></refentrytitle>
    <manvolnum>5</manvolnum>
  </citerefentry>"
>

<!ENTITY reportbug "<citerefentry>
    <refentrytitle><command>reportbug</command></refentrytitle>
    <manvolnum>1</manvolnum>
  </citerefentry>"
>

<!ENTITY dpkg "<citerefentry>
    <refentrytitle><command>dpkg</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY dpkg-buildpackage "<citerefentry>
    <refentrytitle><command>dpkg-buildpackage</command></refentrytitle>
    <manvolnum>1</manvolnum>
  </citerefentry>"
>

<!ENTITY gzip "<citerefentry>
    <refentrytitle><command>gzip</command></refentrytitle>
    <manvolnum>1</manvolnum>
  </citerefentry>"
>

<!ENTITY dpkg-scanpackages "<citerefentry>
    <refentrytitle><command>dpkg-scanpackages</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY dpkg-scansources "<citerefentry>
    <refentrytitle><command>dpkg-scansources</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY dselect "<citerefentry>
    <refentrytitle><command>dselect</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY aptitude "<citerefentry>
    <refentrytitle><command>aptitude</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY synaptic "<citerefentry>
    <refentrytitle><command>synaptic</command></refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>"
>

<!ENTITY debsign "<citerefentry>
    <refentrytitle><command>debsign</command></refentrytitle>
    <manvolnum>1</manvolnum>
  </citerefentry>"
>

<!ENTITY debsig-verify "<citerefentry>
    <refentrytitle><command>debsig-verify</command></refentrytitle>
    <manvolnum>1</manvolnum>
  </citerefentry>"
>

<!ENTITY gpg "<citerefentry>
    <refentrytitle><command>gpg</command></refentrytitle>
    <manvolnum>1</manvolnum>
  </citerefentry>"
>

<!ENTITY gnome-apt "<citerefentry>
    <refentrytitle><command>gnome-apt</command></refentrytitle>
    <manvolnum>1</manvolnum>
  </citerefentry>"
>

<!ENTITY wajig "<citerefentry>
    <refentrytitle><command>wajig</command></refentrytitle>
    <manvolnum>1</manvolnum>
  </citerefentry>"
>
 
<!-- Boiler plate docinfo section -->
<!ENTITY apt-docinfo "
 <refentryinfo>
   <address><email>apt@packages.debian.org</email></address>
   <author>
     <firstname>Jason</firstname> <surname>Gunthorpe</surname>
     <contrib></contrib>
   </author>
   <copyright><year>1998-2001</year> <holder>Jason Gunthorpe</holder></copyright>
   <date>28 October 2008</date>
   <productname>Linux</productname>

 </refentryinfo>
"> 

<!ENTITY apt-email "
   <address>
    <email>apt@packages.debian.org</email>
   </address>
">

<!ENTITY apt-author.jgunthorpe "
   <author>
    <firstname>Jason</firstname>
    <surname>Gunthorpe</surname>
    <contrib></contrib>
   </author>
">

<!ENTITY apt-author.moconnor "
   <author>
    <firstname>Mike</firstname>
    <surname>O'Connor</surname>
    <contrib></contrib>
   </author>
">

<!ENTITY apt-author.team "
   <author>
    <othername>APT team</othername>
    <contrib></contrib>
   </author>
">

<!ENTITY apt-product "
   <productname>Linux</productname>
">

<!ENTITY apt-copyright "
    <copyright>
     <holder>Jason Gunthorpe</holder>
     <year>1998-2001</year>
    </copyright>
">

<!ENTITY apt-product "
   <productname>Linux</productname>
">

<!ENTITY apt-qapage "
	<para>
		<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>
	</para>
">

<!-- Boiler plate Bug reporting section -->
<!ENTITY manbugs "
 <refsect1><title>Bugs</title>
   <para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>. 
   If you wish to report a bug in APT, please see
   <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the
   &reportbug; command.
   </para>
 </refsect1>
">

<!-- Boiler plate Author section -->
<!ENTITY manauthor "
 <refsect1><title>Author</title>
   <para>APT was written by the APT team <email>apt@packages.debian.org</email>.
   </para>
 </refsect1>
">

<!-- Should be used within the option section of the text to
     put in the blurb about -h, -v, -c and -o -->
<!ENTITY apt-commonoptions "
     <varlistentry><term><option>-h</option></term>
     <term><option>--help</option></term>
     <listitem><para>Show a short usage summary.
     </para>
     </listitem>
     </varlistentry>
     
     <varlistentry>
      <term><option>-v</option></term>
      <term><option>--version</option></term>
      <listitem><para>Show the program version.
     </para>
     </listitem>
     </varlistentry>

     <varlistentry>
      <term><option>-c</option></term>
      <term><option>--config-file</option></term>
     <listitem><para>Configuration File; Specify a configuration file to use. 
     The program will read the default configuration file and then this 
     configuration file. See &apt-conf; for syntax information.     
     </para>
     </listitem>
     </varlistentry>
     
     <varlistentry>
      <term><option>-o</option></term>
      <term><option>--option</option></term>
     <listitem><para>Set a Configuration Option; This will set an arbitrary
      configuration option. The syntax is <option>-o Foo::Bar=bar</option>.
      <option>-o</option> and <option>--option</option> can be used multiple
      times to set different options.
     </para>
     </listitem>
     </varlistentry>
">

<!-- Should be used within the option section of the text to
     put in the blurb about -h, -v, -c and -o -->
<!ENTITY apt-cmdblurb "
   <para>All command line options may be set using the configuration file, the
   descriptions indicate the configuration option to set. For boolean
   options you can override the config file by using something like 
   <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>
   or several other variations.
   </para>
">

<!ENTITY file-aptconf "
     <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>
">

<!ENTITY file-cachearchives "
     <varlistentry><term><filename>&cachedir;/archives/</filename></term>
     <listitem><para>Storage area for retrieved package files.
     Configuration Item: <literal>Dir::Cache::Archives</literal>.</para></listitem>
     </varlistentry>

     <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
     <listitem><para>Storage area for package files in transit.
     Configuration Item: <literal>Dir::Cache::Archives</literal> (implicit partial). </para></listitem>
     </varlistentry>
">

<!ENTITY file-preferences "
     <varlistentry><term><filename>/etc/apt/preferences</filename></term>
     <listitem><para>Version preferences file.
     This is where you would specify &quot;pinning&quot;,
     i.e. a preference to get certain packages
     from a separate source
     or from a different version of a distribution.
     Configuration Item: <literal>Dir::Etc::Preferences</literal>.</para></listitem>
     </varlistentry>

     <varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>
     <listitem><para>File fragments for the version preferences.
     Configuration Item: <literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>
     </varlistentry>
">

<!ENTITY file-sourceslist "
     <varlistentry><term><filename>/etc/apt/sources.list</filename></term>
     <listitem><para>Locations to fetch packages from.
     Configuration Item: <literal>Dir::Etc::SourceList</literal>.</para></listitem>
     </varlistentry>

     <varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>
     <listitem><para>File fragments for locations to fetch packages from.
     Configuration Item: <literal>Dir::Etc::SourceParts</literal>.</para></listitem>
     </varlistentry>
">

<!ENTITY file-statelists "
     <varlistentry><term><filename>&statedir;/lists/</filename></term>
     <listitem><para>Storage area for state information for each package resource specified in
     &sources-list;
     Configuration Item: <literal>Dir::State::Lists</literal>.</para></listitem>
     </varlistentry>

     <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
     <listitem><para>Storage area for state information in transit.
     Configuration Item: <literal>Dir::State::Lists</literal> (implicit partial).</para></listitem>
     </varlistentry>
">
Commit	Line	Data
b2e465d6 AL	1	<!-- -- mode: sgml; mode: fold -- -->
	2
	3	<!-- Some common paths.. -->
	4	<!ENTITY docdir "/usr/share/doc/apt/">
4d9fb6b0	5	<!ENTITY guidesdir "/usr/share/doc/apt-doc/">
24f6490f AL	6	<!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</filename>">
24f6490f AL	7	<!ENTITY aptconfdir "<filename>/etc/apt.conf</filename>">
b2e465d6 AL	8	<!ENTITY statedir "/var/lib/apt">
	9	<!ENTITY cachedir "/var/cache/apt">
	10
	11	<!-- Cross references to other man pages -->
24f6490f AL	12	<!ENTITY apt-conf "<citerefentry>
	13	<refentrytitle><filename>apt.conf</filename></refentrytitle>
	14	<manvolnum>5</manvolnum>
	15	</citerefentry>"
	16	>
	17
	18	<!ENTITY apt-get "<citerefentry>
	19	<refentrytitle><command>apt-get</command></refentrytitle>
	20	<manvolnum>8</manvolnum>
	21	</citerefentry>"
	22	>
	23
	24	<!ENTITY apt-config "<citerefentry>
	25	<refentrytitle><command>apt-config</command></refentrytitle>
	26	<manvolnum>8</manvolnum>
	27	</citerefentry>"
	28	>
	29
	30	<!ENTITY apt-cdrom "<citerefentry>
	31	<refentrytitle><command>apt-cdrom</command></refentrytitle>
	32	<manvolnum>8</manvolnum>
	33	</citerefentry>"
	34	>
	35
	36	<!ENTITY apt-cache "<citerefentry>
	37	<refentrytitle><command>apt-cache</command></refentrytitle>
	38	<manvolnum>8</manvolnum>
	39	</citerefentry>"
	40	>
	41
	42	<!ENTITY apt-preferences "<citerefentry>
	43	<refentrytitle><command>apt_preferences</command></refentrytitle>
	44	<manvolnum>5</manvolnum>
	45	</citerefentry>"
	46	>
	47
d2793259 MV	48	<!ENTITY apt-key "<citerefentry>
	49	<refentrytitle><command>apt-key</command></refentrytitle>
	50	<manvolnum>8</manvolnum>
	51	</citerefentry>"
	52	>
	53
	54	<!ENTITY apt-secure "<citerefentry>
	55	<refentrytitle>apt-secure</refentrytitle>
	56	<manvolnum>8</manvolnum>
	57	</citerefentry>"
	58	>
	59
2f493cc6 EL	60	<!ENTITY apt-ftparchive "<citerefentry>
2f493cc6 EL	61	<refentrytitle><filename>apt-ftparchive</filename></refentrytitle>
d2793259 MV	62	<manvolnum>1</manvolnum>
	63	</citerefentry>"
	64	>
	65
	66
24f6490f AL	67	<!ENTITY sources-list "<citerefentry>
	68	<refentrytitle><filename>sources.list</filename></refentrytitle>
	69	<manvolnum>5</manvolnum>
	70	</citerefentry>"
	71	>
	72
	73	<!ENTITY reportbug "<citerefentry>
	74	<refentrytitle><command>reportbug</command></refentrytitle>
	75	<manvolnum>1</manvolnum>
	76	</citerefentry>"
	77	>
	78
	79	<!ENTITY dpkg "<citerefentry>
	80	<refentrytitle><command>dpkg</command></refentrytitle>
	81	<manvolnum>8</manvolnum>
	82	</citerefentry>"
	83	>
	84
	85	<!ENTITY dpkg-buildpackage "<citerefentry>
	86	<refentrytitle><command>dpkg-buildpackage</command></refentrytitle>
	87	<manvolnum>1</manvolnum>
	88	</citerefentry>"
	89	>
	90
	91	<!ENTITY gzip "<citerefentry>
	92	<refentrytitle><command>gzip</command></refentrytitle>
	93	<manvolnum>1</manvolnum>
	94	</citerefentry>"
	95	>
	96
	97	<!ENTITY dpkg-scanpackages "<citerefentry>
	98	<refentrytitle><command>dpkg-scanpackages</command></refentrytitle>
	99	<manvolnum>8</manvolnum>
	100	</citerefentry>"
	101	>
	102
	103	<!ENTITY dpkg-scansources "<citerefentry>
	104	<refentrytitle><command>dpkg-scansources</command></refentrytitle>
	105	<manvolnum>8</manvolnum>
	106	</citerefentry>"
	107	>
	108
	109	<!ENTITY dselect "<citerefentry>
	110	<refentrytitle><command>dselect</command></refentrytitle>
	111	<manvolnum>8</manvolnum>
	112	</citerefentry>"
	113	>
d2793259 MV	114
	115	<!ENTITY aptitude "<citerefentry>
	116	<refentrytitle><command>aptitude</command></refentrytitle>
	117	<manvolnum>8</manvolnum>
	118	</citerefentry>"
	119	>
	120
	121	<!ENTITY synaptic "<citerefentry>
	122	<refentrytitle><command>synaptic</command></refentrytitle>
	123	<manvolnum>8</manvolnum>
	124	</citerefentry>"
	125	>
	126
	127	<!ENTITY debsign "<citerefentry>
	128	<refentrytitle><command>debsign</command></refentrytitle>
	129	<manvolnum>1</manvolnum>
	130	</citerefentry>"
	131	>
	132
	133	<!ENTITY debsig-verify "<citerefentry>
	134	<refentrytitle><command>debsig-verify</command></refentrytitle>
	135	<manvolnum>1</manvolnum>
	136	</citerefentry>"
	137	>
	138
	139	<!ENTITY gpg "<citerefentry>
	140	<refentrytitle><command>gpg</command></refentrytitle>
	141	<manvolnum>1</manvolnum>
	142	</citerefentry>"
	143	>
007aba92 EL	144
	145	<!ENTITY gnome-apt "<citerefentry>
	146	<refentrytitle><command>gnome-apt</command></refentrytitle>
	147	<manvolnum>1</manvolnum>
	148	</citerefentry>"
	149	>
	150
	151	<!ENTITY wajig "<citerefentry>
	152	<refentrytitle><command>wajig</command></refentrytitle>
	153	<manvolnum>1</manvolnum>
	154	</citerefentry>"
	155	>
	156
b2e465d6 AL	157	<!-- Boiler plate docinfo section -->
b2e465d6 AL	158	<!ENTITY apt-docinfo "
24f6490f AL	159	<refentryinfo>
24f6490f AL	160	<address><email>apt@packages.debian.org</email></address>
f0599b9c DK	161	<author>
	162	<firstname>Jason</firstname> <surname>Gunthorpe</surname>
	163	<contrib></contrib>
	164	</author>
24f6490f	165	<copyright><year>1998-2001</year> <holder>Jason Gunthorpe</holder></copyright>
2f493cc6	166	<date>28 October 2008</date>
24f6490f AL	167	<productname>Linux</productname>
	168
	169	</refentryinfo>
b2e465d6 AL	170	">
b2e465d6 AL	171
646c7090 AL	172	<!ENTITY apt-email "
	173	<address>
	174	<email>apt@packages.debian.org</email>
	175	</address>
	176	">
	177
	178	<!ENTITY apt-author.jgunthorpe "
	179	<author>
	180	<firstname>Jason</firstname>
	181	<surname>Gunthorpe</surname>
f0599b9c	182	<contrib></contrib>
646c7090 AL	183	</author>
	184	">
	185
651001f7 MV	186	<!ENTITY apt-author.moconnor "
	187	<author>
	188	<firstname>Mike</firstname>
	189	<surname>O'Connor</surname>
f0599b9c	190	<contrib></contrib>
651001f7 MV	191	</author>
	192	">
	193
646c7090 AL	194	<!ENTITY apt-author.team "
	195	<author>
	196	<othername>APT team</othername>
f0599b9c	197	<contrib></contrib>
646c7090 AL	198	</author>
	199	">
	200
5e80de29 AL	201	<!ENTITY apt-product "
	202	<productname>Linux</productname>
	203	">
	204
646c7090 AL	205	<!ENTITY apt-copyright "
	206	<copyright>
	207	<holder>Jason Gunthorpe</holder>
	208	<year>1998-2001</year>
	209	</copyright>
	210	">
	211
	212	<!ENTITY apt-product "
	213	<productname>Linux</productname>
	214	">
	215
2f493cc6 EL	216	<!ENTITY apt-qapage "
	217	<para>
	218	<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>
	219	</para>
	220	">
	221
b2e465d6 AL	222	<!-- Boiler plate Bug reporting section -->
b2e465d6 AL	223	<!ENTITY manbugs "
24f6490f AL	224	<refsect1><title>Bugs</title>
24f6490f AL	225	<para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>.
4ba3008f	226	If you wish to report a bug in APT, please see
24f6490f AL	227	<filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the
	228	&reportbug; command.
	229	</para>
	230	</refsect1>
b2e465d6 AL	231	">
	232
	233	<!-- Boiler plate Author section -->
	234	<!ENTITY manauthor "
24f6490f AL	235	<refsect1><title>Author</title>
	236	<para>APT was written by the APT team <email>apt@packages.debian.org</email>.
	237	</para>
	238	</refsect1>
	239	">
	240
b2e465d6 AL	241	<!-- Should be used within the option section of the text to
	242	put in the blurb about -h, -v, -c and -o -->
	243	<!ENTITY apt-commonoptions "
24f6490f AL	244	<varlistentry><term><option>-h</option></term>
	245	<term><option>--help</option></term>
	246	<listitem><para>Show a short usage summary.
	247	</para>
	248	</listitem>
	249	</varlistentry>
b2e465d6	250
24f6490f AL	251	<varlistentry>
	252	<term><option>-v</option></term>
	253	<term><option>--version</option></term>
	254	<listitem><para>Show the program version.
	255	</para>
	256	</listitem>
	257	</varlistentry>
	258
	259	<varlistentry>
	260	<term><option>-c</option></term>
	261	<term><option>--config-file</option></term>
	262	<listitem><para>Configuration File; Specify a configuration file to use.
b2e465d6 AL	263	The program will read the default configuration file and then this
b2e465d6 AL	264	configuration file. See &apt-conf; for syntax information.
24f6490f AL	265	</para>
	266	</listitem>
	267	</varlistentry>
b2e465d6	268
24f6490f AL	269	<varlistentry>
	270	<term><option>-o</option></term>
	271	<term><option>--option</option></term>
e3a1f08d	272	<listitem><para>Set a Configuration Option; This will set an arbitrary
24f6490f	273	configuration option. The syntax is <option>-o Foo::Bar=bar</option>.
32c8f64e LB	274	<option>-o</option> and <option>--option</option> can be used multiple
32c8f64e LB	275	times to set different options.
24f6490f AL	276	</para>
	277	</listitem>
	278	</varlistentry>
b2e465d6 AL	279	">
	280
	281	<!-- Should be used within the option section of the text to
	282	put in the blurb about -h, -v, -c and -o -->
	283	<!ENTITY apt-cmdblurb "
24f6490f	284	<para>All command line options may be set using the configuration file, the
b2e465d6 AL	285	descriptions indicate the configuration option to set. For boolean
b2e465d6 AL	286	options you can override the config file by using something like
24f6490f AL	287	<option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>
24f6490f AL	288	or several other variations.
b2e465d6 AL	289	</para>
b2e465d6 AL	290	">
24f6490f	291
1221c3a3 DK	292	<!ENTITY file-aptconf "
	293	<varlistentry><term><filename>/etc/apt/apt.conf</filename></term>
	294	<listitem><para>APT configuration file.
	295	Configuration Item: <literal>Dir::Etc::Main</literal>.</para></listitem>
	296	</varlistentry>
	297
	298	<varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>
	299	<listitem><para>APT configuration file fragments.
	300	Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem>
	301	</varlistentry>
	302	">
	303
	304	<!ENTITY file-cachearchives "
	305	<varlistentry><term><filename>&cachedir;/archives/</filename></term>
	306	<listitem><para>Storage area for retrieved package files.
	307	Configuration Item: <literal>Dir::Cache::Archives</literal>.</para></listitem>
	308	</varlistentry>
	309
	310	<varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
	311	<listitem><para>Storage area for package files in transit.
	312	Configuration Item: <literal>Dir::Cache::Archives</literal> (implicit partial). </para></listitem>
	313	</varlistentry>
	314	">
	315
	316	<!ENTITY file-preferences "
	317	<varlistentry><term><filename>/etc/apt/preferences</filename></term>
	318	<listitem><para>Version preferences file.
	319	This is where you would specify "pinning",
	320	i.e. a preference to get certain packages
	321	from a separate source
	322	or from a different version of a distribution.
	323	Configuration Item: <literal>Dir::Etc::Preferences</literal>.</para></listitem>
	324	</varlistentry>
	325
	326	<varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>
	327	<listitem><para>File fragments for the version preferences.
	328	Configuration Item: <literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>
	329	</varlistentry>
	330	">
	331
	332	<!ENTITY file-sourceslist "
	333	<varlistentry><term><filename>/etc/apt/sources.list</filename></term>
	334	<listitem><para>Locations to fetch packages from.
	335	Configuration Item: <literal>Dir::Etc::SourceList</literal>.</para></listitem>
	336	</varlistentry>
	337
	338	<varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>
	339	<listitem><para>File fragments for locations to fetch packages from.
	340	Configuration Item: <literal>Dir::Etc::SourceParts</literal>.</para></listitem>
	341	</varlistentry>
	342	">
	343
	344	<!ENTITY file-statelists "
	345	<varlistentry><term><filename>&statedir;/lists/</filename></term>
	346	<listitem><para>Storage area for state information for each package resource specified in
	347	&sources-list;
	348	Configuration Item: <literal>Dir::State::Lists</literal>.</para></listitem>
	349	</varlistentry>
	350
	351	<varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
	352	<listitem><para>Storage area for state information in transit.
	353	Configuration Item: <literal>Dir::State::Lists</literal> (implicit partial).</para></listitem>
	354	</varlistentry>
	355	">