← Back to branch summary

~ubuntu-branches/debian/experimental/apt/experimental

« back to all changes in this revision

Viewing changes to doc/sources.list.5.xml

  • Committer: Bazaar Package Importer
  • Author(s): Michael Vogt
  • Date: 2010-02-18 22:07:23 UTC
  • mfrom: (9.1.7 sid)
  • Revision ID: james.westby@ubuntu.com-20100218220723-zb7zdh6fmsmp30tr
Tags: 0.7.26~exp2
fix crash when LANGUAGE is not set

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/sources.list.5.xml
21
21
 <refmeta>
22
22
   <refentrytitle>sources.list</refentrytitle>
23
23
   <manvolnum>5</manvolnum>
 
24
   <refmiscinfo class="manual">APT</refmiscinfo>
24
25
 </refmeta>
25
26
 
26
27
 <!-- Man page title -->
33
34
   <para>The package resource list is used to locate archives of the package
34
35
   distribution system in use on the system. At this time, this manual page
35
36
   documents only the packaging system used by the Debian GNU/Linux system.
36
 
   This control file is located in <filename>/etc/apt/sources.list</filename></para>
 
37
   This control file is <filename>/etc/apt/sources.list</filename>.</para>
37
38
 
38
39
   <para>The source list is designed to support any number of active sources and a
39
40
   variety of source media. The file lists one source per line, with the
40
41
   most preferred source listed first. The format of each line is:
41
42
   <literal>type uri args</literal> The first item, <literal>type</literal>
42
 
   determines the format for <literal>args</literal> <literal>uri</literal> is
 
43
   determines the format for <literal>args</literal>. <literal>uri</literal> is
43
44
   a Universal Resource Identifier 
44
45
   (URI), which is a superset of the more specific and well-known Universal
45
46
   Resource Locator, or URL. The rest of the line can be marked as a comment 
63
64
   <literal>stable</literal> <literal>unstable</literal> or 
64
65
   <literal>testing</literal> while component is one of <literal>main</literal> 
65
66
   <literal>contrib</literal> <literal>non-free</literal> or
66
 
   <literal>non-us</literal> The 
 
67
   <literal>non-us</literal>. The 
67
68
   <literal>deb-src</literal> type describes a debian distribution's source
68
69
   code in the same form as the <literal>deb</literal> type.
69
70
   A <literal>deb-src</literal> line is required to fetch source indexes.</para>
70
71
 
71
72
 
72
73
   <para>The format for a <filename>sources.list</filename> entry using the
73
 
   <literal>deb</literal> and <literal>deb-src</literal> types are:</para>
 
74
   <literal>deb</literal> and <literal>deb-src</literal> types is:</para>
74
75
 
75
76
   <literallayout>deb uri distribution [component1] [component2] [...]</literallayout>
76
77
 
78
79
   Debian distribution, from which APT will find the information it needs. 
79
80
   <literal>distribution</literal> can specify an exact path, in which case the 
80
81
   components must be omitted and <literal>distribution</literal> must end with
81
 
   a slash (/). This is useful for when only a particular sub-section of the 
 
82
   a slash (/). This is useful for when the case only a particular sub-section of the 
82
83
   archive denoted by the URI is of interest.
83
84
   If <literal>distribution</literal> does not specify an exact path, at least
84
85
   one <literal>component</literal> must be present.</para>
142
143
    http://server:port/, the proxy server specified in
143
144
    <envar>http_proxy</envar> will be used. Users of authenticated
144
145
    HTTP/1.1 proxies may use a string of the format
145
 
    http://user:pass@server:port/
 
146
    http://user:pass@server:port/.
146
147
    Note that this is an insecure method of authentication.</para></listitem>
147
148
    </varlistentry>
148
149
 
173
174
    <command>dd</command> 
174
175
    commands to perform the file transfers from the remote.</para></listitem>
175
176
    </varlistentry>
 
177
 
 
178
    <varlistentry><term>more recognizable URI types</term>
 
179
    <listitem><para>
 
180
    APT can be extended with more methods shipped in other optional packages which should
 
181
    follow the nameing scheme <literal>apt-transport-<replaceable>method</replaceable></literal>.
 
182
    The APT team e.g. maintains also the <literal>apt-transport-https</literal> package which
 
183
    provides access methods for https-URIs with features similar to the http method, but other
 
184
    methods for using e.g. debtorrent are also available, see <citerefentry>
 
185
    <refentrytitle><filename>apt-transport-debtorrent</filename></refentrytitle>
 
186
    <manvolnum>1</manvolnum></citerefentry>.
 
187
    </para></listitem>
 
188
    </varlistentry>
176
189
  </variablelist>
177
190
 </para>
178
191
 </refsect1>
198
211
 
199
212
   <para>Uses FTP to access the archive at ftp.debian.org, under the debian
200
213
   directory, and uses only the unstable/contrib area. If this line appears as
201
 
   well as the one in the previous example in <filename>sources.list</filename>.
 
214
   well as the one in the previous example in <filename>sources.list</filename>
202
215
   a single FTP session will be used for both resource lines.</para>
203
216
   <literallayout>deb ftp://ftp.debian.org/debian unstable contrib</literallayout>
204
217