Offline document

[ntk/apt.git] / doc / files.sgml

diff --git a/doc/files.sgml b/doc/files.sgml
index e86b2de..2b68cf9 100644 (file)
--- a/doc/files.sgml
+++ b/doc/files.sgml
@@ -4,7 +4,7 @@
 <title>APT Files</title>
 
 <author>Jason Gunthorpe <email>jgg@debian.org</email></author>
-<version>$Id: files.sgml,v 1.4 1998/12/14 04:00:33 jgg Exp $</version>
+<version>$Id: files.sgml,v 1.7 1999/02/15 06:38:03 jgg Exp $</version>
 
 <abstract>
 This document describes the complete implementation and format of the 
@@ -13,7 +13,7 @@ views the Debian archive.
 </abstract>
 
 <copyright>
-Copyright &copy; Jason Gunthorpe, 1998.
+Copyright &copy; Jason Gunthorpe, 1998-1999.
 <p>
 "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
@@ -260,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..
 </sect>
@@ -367,7 +371,7 @@ This is the common name we give our archives, such as <em>stable</> or
 
 <tag>Component<item>
 Referes to the sub-component of the archive, <em>main</>, <em>contrib</>
-etc.
+etc. Component may be omitted if there are no components for this archive.
 
 <tag>Version<item>
 This is a version string with the same properties as in the Packages file.