X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/a88136062dbe189417aa0b4751449637816c8445..c1ab34c75f7e98fa1a9686c7bc59e578e1ae9572:/doc/apt-config.8.xml diff --git a/doc/apt-config.8.xml b/doc/apt-config.8.xml index 94aeec059..cf2e87c62 100644 --- a/doc/apt-config.8.xml +++ b/doc/apt-config.8.xml @@ -1,13 +1,9 @@ - -%aptent; - - -%aptverbatiment; - + %aptent; + %aptverbatiment; + %aptvendor; ]> @@ -18,7 +14,7 @@ &apt-email; &apt-product; - 29 February 2004 + 2013-11-30T00:00:00Z @@ -39,20 +35,20 @@ apt-config is an internal program used by various portions of the APT suite to provide consistent configurability. It accesses the main configuration file /etc/apt/apt.conf in a - manner that is easy to use by scripted applications. + manner that is easy to use for scripted applications. Unless the , or option is - given one of the commands below must be present. + given, one of the commands below must be present. - shell + - shell is used to access the configuration information from a shell - script. It is given pairs of arguments, the first being a shell - variable and the second the configuration value to query. As output - it lists a series of shell assignments commands for each present value. - In a shell script it should be used like: + shell is used to access the configuration information from a shell + script. It is given pairs of arguments, the first being a shell + variable and the second the configuration value to query. As output + it lists shell assignment commands for each value present. + In a shell script it should be used as follows: @@ -72,7 +68,7 @@ eval $RES - dump + Just show the contents of the configuration space. @@ -93,10 +89,11 @@ eval $RES - Defines the output of each config option. %t will be replaced with the tagname, - %f with the complete tagname and %v with the value of the option. - Use uppercase letters and the respective values will be quoted. Additionally - %n will be replaced by a newline, %N by a tab. A % can be + Defines the output of each config option. %t will be replaced with its individual name, + %f with its full hierarchical name and %v with its value. + Use uppercase letters and special characters in the value will be encoded to ensure that + it can e.g. be safely used in a quoted-string as defined by RFC822. Additionally + %n will be replaced by a newline, and %N by a tab. A % can be printed by using %%.