From 24f6490f4ba3572069619d88e053db5cb07e846c Mon Sep 17 00:00:00 2001 From: Arch Librarian Date: Mon, 20 Sep 2004 17:05:19 +0000 Subject: * Replace SGML manpages with XML man pages from richard... Author: mdz Date: 2004-02-07 21:48:14 GMT * Replace SGML manpages with XML man pages from richard.bos@xs4all.nl (Closes: #230687) --- doc/sources.list.5.sgml | 199 ------------------------------------------------ 1 file changed, 199 deletions(-) delete mode 100644 doc/sources.list.5.sgml (limited to 'doc/sources.list.5.sgml') diff --git a/doc/sources.list.5.sgml b/doc/sources.list.5.sgml deleted file mode 100644 index 45941c215..000000000 --- a/doc/sources.list.5.sgml +++ /dev/null @@ -1,199 +0,0 @@ - - -%aptent; - -]> - - - &apt-docinfo; - - - sources.list - 5 - - - - - sources.list - Package resource list for APT - - - Description</> - <para> - The package resource list is used to locate archives of the package - distribution system in use on the system. At this time, this manual page - documents only the packaging system used by the Debian GNU/Linux system. - This control file is located in <filename>/etc/apt/sources.list</> - <para> - The source list is designed to support any number of active sources and a - variety of source media. The file lists one source per line, with the - most preferred source listed first. The format of each line is: - <literal/type uri args/. The first item, <literal/type/, determines the - format for <literal/args/. <literal/uri/ is a Universal Resource Identifier - (URI), which is a superset of the more specific and well-known Universal - Resource Locator, or URL. The rest of the line can be marked as a comment - by using a #. - </RefSect1> - - <RefSect1><Title>The deb and deb-src types</> - <para> - The <literal/deb/ type describes a typical two-level Debian archive, - <filename>distribution/component</>. Typically, <literal/distribution/ is - generally one of <literal/stable/, <literal/unstable/, or - <literal/testing/, while component is one of <literal/main/, - <literal/contrib/, <literal/non-free/, or <literal/non-us/. The - <literal/deb-src/ type describes a debian distribution's source code in - the same form as the <literal/deb/ type. A <literal/deb-src/ line is - required to fetch source indexes. - <para> - The format for a <filename/sources.list/ entry using the <literal/deb/ - and <literal/deb-src/ types are: - <literallayout>deb uri distribution [component1] [component2] [...]</literallayout> - <para> - The URI for the <literal/deb/ type must specify the base of the Debian - distribution, from which APT will find the information it needs. - <literal/distribution/ can specify an exact path, in which case the - components must be omitted and <literal/distribution/ must end with a - slash (/). This is useful for when only a particular sub-section of the - archive denoted by the URI is of interest. If <literal/distribution/ does - not specify an exact path, at least one <literal/component/ must be present. - <para> - <literal/distribution/ may also contain a variable, <literal/$(ARCH)/, - which expands to the Debian architecture (i386, m68k, powerpc, ...) - used on the system. This permits architecture-independent - <filename/sources.list/ files to be used. In general this is only of - interest when specifying an exact path, <literal/APT/ will automatically - generate a URI with the current architecture otherwise. - <para> - Since only one distribution can be specified per line it may be necessary - to have multiple lines for the same URI, if a subset of all available - distributions or components at that location is desired. - APT will sort the URI list after it has generated a complete set - internally, and will collapse multiple references to the same Internet - host, for instance, into a single connection, so that it does not - inefficiently establish an FTP connection, close it, do something else, - and then re-establish a connection to that same host. This feature is - useful for accessing busy FTP sites with limits on the number of - simultaneous anonymous users. APT also parallelizes connections to - different hosts to more effectively deal with sites with low bandwidth. - <para> - It is important to list sources in order of preference, with the most - preferred source listed first. Typically this will result in sorting - by speed from fastest to slowest (CD-ROM followed by hosts on a local - network, followed by distant Internet hosts, for example). - <para> - Some examples: - <literallayout> -deb http://http.us.debian.org/debian stable main contrib non-free -deb http://http.us.debian.org/debian dists/stable-updates/ - </literallayout> - </RefSect1> - - <RefSect1><title>URI specification - - The currently recognized URI types are cdrom, file, http, and ftp. - - file - - The file scheme allows an arbitrary directory in the file system to be - considered an archive. This is useful for NFS mounts and local mirrors or - archives. - - - cdrom - - The cdrom scheme allows APT to use a local CDROM drive with media - swapping. Use the &apt-cdrom; program to create cdrom entries in the - source list. - - - http - - The http scheme specifies an HTTP server for the archive. If an environment - variable - - ftp - - The ftp scheme specifies an FTP server for the archive. APT's FTP behavior - is highly configurable; for more information see the - &apt-conf; manual page. Please note that a ftp proxy can be specified - by using the - - copy - - The copy scheme is identical to the file scheme except that packages are - copied into the cache directory instead of used directly at their location. - This is useful for people using a zip disk to copy files around with APT. - - - rshssh - - The rsh/ssh method invokes rsh/ssh to connect to a remote host - as a given user and access the files. No password authentication is - possible, prior arrangements with RSA keys or rhosts must have been made. - Access to files on the remote uses standard - - - - Examples - - Uses the archive stored locally (or NFS mounted) at /home/jason/debian - for stable/main, stable/contrib, and stable/non-free. - deb file:/home/jason/debian stable main contrib non-free - - As above, except this uses the unstable (development) distribution. - deb file:/home/jason/debian unstable main contrib non-free - - Source line for the above - deb-src file:/home/jason/debian unstable main contrib non-free - - Uses HTTP to access the archive at archive.debian.org, and uses only the - hamm/main area. - deb http://archive.debian.org/debian-archive hamm main - - Uses FTP to access the archive at ftp.debian.org, under the debian - directory, and uses only the stable/contrib area. - deb ftp://ftp.debian.org/debian stable contrib - - Uses FTP to access the archive at ftp.debian.org, under the debian - directory, and uses only the unstable/contrib area. If this line appears as - well as the one in the previous example in deb ftp://ftp.debian.org/debian unstable contrib - - Uses HTTP to access the archive at nonus.debian.org, under the debian-non-US - directory. - deb http://nonus.debian.org/debian-non-US stable/non-US main contrib non-free - - Uses HTTP to access the archive at nonus.debian.org, under the - debian-non-US directory, and uses only files found under - unstable/binary-i386 on i386 machines, - unstable/binary-m68k on m68k, and so - forth for other supported architectures. [Note this example only - illustrates how to use the substitution variable; non-us is no longer - structured like this] - deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/ - - - See Also</> - <para> - &apt-cache; &apt-conf; - </RefSect1> - - &manbugs; - &manauthor; - -</refentry> -- cgit v1.2.3