X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/4c86a6348d9916b6404709452affa10e9c776efa..4e3180ff00ae32e4d836517180137048ac3cdfc7:/doc/apt-ftparchive.1.xml?ds=sidebyside diff --git a/doc/apt-ftparchive.1.xml b/doc/apt-ftparchive.1.xml index 84b5f4135..6482b4632 100644 --- a/doc/apt-ftparchive.1.xml +++ b/doc/apt-ftparchive.1.xml @@ -8,6 +8,8 @@ %aptverbatiment; + +%aptvendor; ]> @@ -18,7 +20,7 @@ &apt-email; &apt-product; - 2009-08-17T00:00:00Z + 2012-06-09T00:00:00Z @@ -93,12 +95,12 @@ 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 + Packages and Sources files and 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 + It then writes to stdout a Release file containing an MD5, SHA1 and SHA256 digest for each file. Values for the additional metadata fields in the Release file are @@ -139,7 +141,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 +164,7 @@ - Specifies the location of the cache files + Specifies the location of the cache files. @@ -182,7 +184,7 @@ Sets the default compression schemes to use - for the Package index files. It is a string that contains a space + 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'. @@ -233,8 +235,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 +292,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 +307,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. @@ -352,7 +354,7 @@ Typically this is a setting such as dists/&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,7 +368,7 @@ 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 @@ -379,8 +381,8 @@ for i in Sections do - 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 +430,7 @@ for i in Sections do - Sets the Contents file output. (optional) + Sets the Contents file output (optional). @@ -472,8 +474,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 +492,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.