X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/f45fd56b58a71f2827eb8b4f96333782d84b7b63..6bc703c22970055d9e1a1b4e3e0efe74f4cefda5:/doc/apt.conf.5.xml
diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml
index e568baa35..c13ad4867 100644
--- a/doc/apt.conf.5.xml
+++ b/doc/apt.conf.5.xml
@@ -21,7 +21,7 @@
&apt-email;
&apt-product;
- 18 September 2009
+ 16 January 2010
@@ -37,16 +37,27 @@
Description
- apt.conf is the main configuration file for the APT suite of
- tools, all tools make use of the configuration file and a common command line
- parser to provide a uniform environment. When an APT tool starts up it will
- read the configuration specified by the APT_CONFIG environment
- variable (if any) and then read the files in Dir::Etc::Parts
- then read the main configuration file specified by
- Dir::Etc::main then finally apply the
- command line options to override the configuration directives, possibly
- loading even more config files.
-
+ apt.conf is the main configuration file for
+ the APT suite of tools, but by far not the only place changes to options
+ can be made. All tools therefore share the configuration files and also
+ use a common command line parser to provide a uniform environment.
+
+ When an APT tool starts up it will read the configuration files
+ in the following order:
+ the file specified by the APT_CONFIG
+ environment variable (if any)
+ all files in Dir::Etc::Parts in
+ alphanumeric ascending order which have no or "conf"
+ as filename extension and which only contain alphanumeric,
+ hyphen (-), underscore (_) and period (.) characters -
+ otherwise they will be silently ignored.
+ the main configuration file specified by
+ Dir::Etc::main
+ the command line options are applied to override the
+ configuration directives or to load even more configuration files.
+
+
+ Syntax
The configuration file is organized in a tree with options organized into
functional groups. Option specification is given with a double colon
notation, for instance APT::Get::Assume-Yes is an option within