X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/741c12586fac0a9a5ed6ebc475479fee43e911a1..2569ac285813e0ca36d76c03cce92cf490c63e6d:/doc/apt.conf.5.xml
diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml
index 43f33681f..db8dfa7ce 100644
--- a/doc/apt.conf.5.xml
+++ b/doc/apt.conf.5.xml
@@ -46,7 +46,7 @@
the APT tool group, for the Get tool. options do not inherit from their
parent groups.
- Syntacticly the configuration language is modeled after what the ISC tools
+ Syntactically the configuration language is modeled after what the ISC tools
such as bind and dhcp use. Lines starting with
// are treated as comments (ignored).
Each line is of the form
@@ -75,6 +75,9 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
&docdir;examples/apt.conf &configureindex;
is a good guide for how it should look.
+ The names of the configuration items are not case-sensitive. So in the previous example
+ you could use dpkg::pre-install-pkgs.
+
Two specials are allowed, #include and #clear
#include will include the given file, unless the filename
ends in a slash, then the whole directory is included.
@@ -214,7 +217,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
configuration file. This entry specifies the commands to send to tell
the proxy server what to connect to. Please see
&configureindex; for an example of
- how to do this. The subsitution variables available are
+ how to do this. The substitution variables available are
$(PROXY_USER) $(PROXY_PASS) $(SITE_USER)
$(SITE_PASS) $(SITE) and $(SITE_PORT)
Each is taken from it's respective URI component.
@@ -235,7 +238,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
not recommended to use FTP over HTTP due to its low efficiency.
The setting ForceExtended controls the use of RFC2428
- EPSV and EPRT commands. The defaut is false, which means
+ EPSV and EPRT commands. The default is false, which means
these commands are only used if the control connection is IPv6. Setting this
to true forces their use even on IPv4 connections. Note that most FTP servers
do not support RFC2428.
@@ -276,7 +279,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
pkgcache as well as the location to place downloaded archives,
Dir::Cache::archives. Generation of caches can be turned off
by setting their names to be blank. This will slow down startup but
- save disk space. It is probably prefered to turn off the pkgcache rather
+ save disk space. It is probably preferred to turn off the pkgcache rather
than the srcpkgcache. Like Dir::State the default
directory is contained in Dir::Cache
@@ -295,6 +298,19 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
dpkg, apt-get dpkg-source
dpkg-buildpackage and apt-cache specify the location
of the respective programs.
+
+
+ The configuration item RootDir has a special
+ meaning. If set, all paths in Dir:: will be
+ relative to RootDir, even paths that
+ are specified absolutely. So, for instance, if
+ RootDir is set to
+ /tmp/staging and
+ Dir::State::status is set to
+ /var/lib/dpkg/status, then the status file
+ will be looked up in
+ /tmp/staging/var/lib/dpkg/status.
+
APT in DSelect