X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/0a8e3465cb644e380ab0fc6d66f6d1f17363b34e..c373c37a2edf384b658c8d054bdcc55464900863:/doc/files.sgml
diff --git a/doc/files.sgml b/doc/files.sgml
index 2d4b1eac0..2b68cf9bc 100644
--- a/doc/files.sgml
+++ b/doc/files.sgml
@@ -4,7 +4,7 @@
-Copyright © Jason Gunthorpe, 1998.
+Copyright © Jason Gunthorpe, 1998-1999.
"APT" and this document are free software; you can redistribute them and/or
modify them under the terms of the GNU General Public License as published
@@ -45,6 +45,8 @@ The var directory structure is as follows:
lists/
partial/
xstatus
+ userstatus
+ cdroms.list
/var/cache/apt/
pkgcache.bin
srcpkgcache.bin
@@ -52,12 +54,15 @@ The var directory structure is as follows:
partial/
/etc/apt/
sources.list
- cdromdevs.list
+ apt.conf
/usr/lib/apt/
methods/
cdrom
ftp
http
+ file
+ gzip
+ copy
@@ -80,7 +85,7 @@ support a mix of source media. The file lists one source per line, with the
fastest source listed first. The format of each line is:
-type ui args
+type uri args
The first item, type, indicates the format for the remainder
@@ -122,17 +127,14 @@ URIs in the source list support a large number of access schemes.
cdrom-
The cdrom scheme is special in that If Modifed Since queries are never
performed and that APT knows how to match a cdrom to the name it
- was given when first inserted. It does this by examining the date
- and size of the package file. APT also knows all of the possible
- prefix paths for the cdrom drives and that the user should be prompted
+ was given when first inserted. APT also knows all of the possible
+ mount points the cdrom drives and that the user should be prompted
to insert a CD if it cannot be found. The path is relative to an
arbitary mount point (of APT's choosing) and must not start with a
slash. The first pathname component is the given name and is purely
descriptive and of the users choice. However, if a file in the root of
- the cdrom is called 'cdname' its contents will be used instead of
+ the cdrom is called '.disk/info' its contents will be used instead of
prompting. The name serves as a tag for the cdrom and should be unique.
- APT will track the CDROM's based on their tag and package file
- properties.
cdrom:Debian 1.3/debian
@@ -140,8 +142,7 @@ URIs in the source list support a large number of access schemes.
http
-
This scheme specifies a HTTP server for the debian archive. HTTP is prefered
over FTP because If Modified Since queries against the Package file are
- possible. Newer HTTP protcols may even support reget which would make
- http the protocol of choice.
+ possible as well as deep pipelining and resume capabilities.
http://www.debian.org/archive
@@ -259,7 +260,11 @@ No dirctory structure is transfered from the receiving site and all .deb
file names conform to debian conventions. No short (msdos) filename should
be placed in archives. If the need arises .debs should be unpacked, scanned
and renamed to their correct internal names. This is mostly to prevent
-file name conflicts but other programs may depend on this if convenient.
+file name conflicts but other programs may depend on this if convenient.
+A conforming .deb is one of the form, name_version_arch.deb. Our archive
+scripts do not handle epochs, but they are necessary and should be re-inserted.
+If necessary _'s and :'s in the fields should be quoted using the % convention.
+It must be possible to extract all 3 fields by examining the file name.
Downloaded .debs must be found in one of the package lists with an exact
name + version match..
@@ -366,7 +371,7 @@ This is the common name we give our archives, such as stable> or
Component
-
Referes to the sub-component of the archive, main>, contrib>
-etc.
+etc. Component may be omitted if there are no components for this archive.
Version
-
This is a version string with the same properties as in the Packages file.