X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/81cf16a26fa162ac672b084a88148b822e645665..ee60e00ccc68104cae56a854ffd2fb65a959ce57:/doc/apt-ftparchive.1.xml diff --git a/doc/apt-ftparchive.1.xml b/doc/apt-ftparchive.1.xml index 84b5f4135..705f416eb 100644 --- a/doc/apt-ftparchive.1.xml +++ b/doc/apt-ftparchive.1.xml @@ -1,13 +1,9 @@ -%aptent; - - -%aptverbatiment; - + %aptent; + %aptverbatiment; + %aptvendor; ]> @@ -18,7 +14,7 @@ &apt-email; &apt-product; - 2009-08-17T00:00:00Z + 2016-08-06T00:00:00Z @@ -92,23 +88,26 @@ The release command generates a Release file from a - directory tree. It recursively searches the given directory for uncompressed - Packages and Sources files and the ones - compressed with gzip, bzip2 or lzma - as well as Release and md5sum.txt files by default - (APT::FTPArchive::Release::Default-Patterns). Additional filename patterns - can be added by listing them in APT::FTPArchive::Release::Patterns. - It then writes to stdout a Release file containing a MD5, SHA1 and SHA256 digest - for each file. + directory tree. It recursively searches the given directory for + uncompressed and compressed Packages, + Sources, Contents, + Components and icons files as + well as Release, Index and + md5sum.txt files by default + (APT::FTPArchive::Release::Default-Patterns). + Additional filename patterns can be added by listing them in + APT::FTPArchive::Release::Patterns. It then writes to + stdout a Release file containing (by default) an MD5, + SHA1, SHA256 and SHA512 digest for each file. Values for the additional metadata fields in the Release file are taken from the corresponding variables under APT::FTPArchive::Release, - e.g. APT::FTPArchive::Release::Origin. The supported fields - are: Origin, Label, Suite, + e.g. APT::FTPArchive::Release::Origin. The supported fields + are Origin, Label, Suite, Version, Codename, Date, - Valid-Until, Architectures, - Components, Description. + Valid-Until, Signed-By, Architectures, + Components and Description. @@ -139,7 +138,7 @@ tree manner. This only effects how the scope tag is handled. - The generate configuration has 4 separate sections, each described below. + The generate configuration has four separate sections, each described below. <literal>Dir</literal> Section @@ -162,7 +161,7 @@ - Specifies the location of the cache files + Specifies the location of the cache files. @@ -181,10 +180,11 @@ - Sets the default compression schemes to use - for the Package index files. It is a string that contains a space - separated list of at least one of: '.' (no compression), 'gzip' and - 'bzip2'. The default for all compression schemes is '. gzip'. + Sets the default compression schemes to use + for the package index files. It is a string that contains a space + separated list of at least one of the compressors configured via the + configuration scope. + The default for all compression schemes is '. gzip'. @@ -233,8 +233,8 @@ - Sets if long descriptions should be included in the Packages file or split - out into a master Translation-en file. + Specifies whether long descriptions should be included in the Packages file or split + out into a master Translation-en file. @@ -290,7 +290,7 @@ - Set the output Translation-en master file with the long descriptions if they + Sets the output Translation-en master file with the long descriptions if they should be not included in the Packages file. Defaults to $(DIST)/$(SECTION)/i18n/Translation-en @@ -305,8 +305,8 @@ Sets the output Contents file. Defaults to - $(DIST)/Contents-$(ARCH). If this setting causes multiple - Packages files to map onto a single Contents file (such as the default) + $(DIST)/$(SECTION)/Contents-$(ARCH). If this setting causes multiple + Packages files to map onto a single Contents file (as is the default) then apt-ftparchive will integrate those package files together automatically. @@ -349,10 +349,10 @@ The Tree section takes a scope tag which sets the $(DIST) variable and defines the root of the tree (the path is prefixed by ArchiveDir). - Typically this is a setting such as dists/&stable-codename;. + Typically this is a setting such as dists/&debian-stable-codename;. All of the settings defined in the TreeDefault section can be - use in a Tree section as well as three new variables. + used in a Tree section as well as three new variables. When processing a Tree section apt-ftparchive performs an operation similar to: @@ -366,21 +366,25 @@ for i in Sections do This is a space separated list of sections which appear - under the distribution, typically this is something like + under the distribution; typically this is something like main contrib non-free - This is a space separated list of all the - architectures that appear under search section. The special architecture - 'source' is used to indicate that this tree has a source archive. + This is a space separated list of all the architectures that appear under + search section. The special architecture 'source' is used to indicate + that this tree has a source archive. The architecture 'all' signals that + architecture specific files like Packages should not + include information about architecture all packages in + all files as they will be available in a dedicated file. + - Sets if long descriptions should be included in the Packages file or split - out into a master Translation-en file. + Specifies whether long descriptions should be included in the Packages file or split + out into a master Translation-en file. @@ -428,7 +432,7 @@ for i in Sections do - Sets the Contents file output. (optional) + Sets the Contents file output (optional). @@ -472,8 +476,8 @@ for i in Sections do The Binary Override File The binary override file is fully compatible with &dpkg-scanpackages;. It - contains 4 fields separated by spaces. The first field is the package name, - the second is the priority to force that package to, the third is the + contains four fields separated by spaces. The first field is the package name, + the second is the priority to force that package to, the third is the section to force that package to and the final field is the maintainer permutation field. The general form of the maintainer field is: @@ -490,14 +494,14 @@ for i in Sections do The Source Override File The source override file is fully compatible with &dpkg-scansources;. It - contains 2 fields separated by spaces. The first fields is the source + contains two fields separated by spaces. The first field is the source package name, the second is the section to assign it. The Extra Override File The extra override file allows any arbitrary tag to be added or replaced - in the output. It has 3 columns, the first is the package, the second is + in the output. It has three columns, the first is the package, the second is the tag and the remainder of the line is the new value. @@ -505,7 +509,11 @@ for i in Sections do &apt-cmdblurb; - + + + + + Generate the given checksum. These options default to on, when turned off the generated index files will not have the checksum fields where possible. @@ -513,7 +521,7 @@ for i in Sections do APT::FTPArchive::Index::Checksum where Index can be Packages, Sources or Release and Checksum can be MD5, - SHA1 or SHA256. + SHA1, SHA256 or SHA512. @@ -589,7 +597,7 @@ for i in Sections do &apt-commonoptions; - +