Retry support
[apt.git] / doc / apt.conf.5.yo
index 5c4a9d4298a930b02fb1274db6cb2b70836b1f42..2eb2bbf456ca9d939509207fd7ed833958eaf67c 100644 (file)
@@ -52,12 +52,12 @@ The Get subsection controls the bf(apt-get(8)) tool, please see its
 documentation for more information about the options here.
 
 dit(bf(Cache))
-The Cache subsection controls the bf(apt-cache(8)) tool, please see it
-sdocumentation for more information about the options here.
+The Cache subsection controls the bf(apt-cache(8)) tool, please see its
+documentation for more information about the options here.
 
 dit(bf(CDROM))
-The CDROM subsection controls the bf(apt-cdrom(8)) tool, please see it
-sdocumentation for more information about the options here.
+The CDROM subsection controls the bf(apt-cdrom(8)) tool, please see its
+documentation for more information about the options here.
 
 enddit()
 
@@ -68,10 +68,14 @@ URI handlers.
 startdit()
 dit(bf(Queue-Mode))
 Queuing mode; bf(Queue-Mode) can be one of bf(host) or bf(access) which 
-determins how APT parallelizesoutgoing connections. bf(host) means that
+determins how APT parallelizes outgoing connections. bf(host) means that
 one connection per target host will be opened, bf(access) means that one
 connection per URI type will be opened.
 
+dit(bf(Retries))
+Number of retries to perform. If this is non-zero apt will retry failed 
+files the given number of times.
+
 dit(bf(http))
 HTTP URIs; http::Proxy is the default http proxy to use. It is in the standard
 form of em(http://[[user][:pass]@]host[:port]/). Per host proxies can also
@@ -79,6 +83,21 @@ be specified by using the form http::Proxy::<host> with the special keyword
 em(DIRECT) meaning to use no proxies. The em($http_proxy) environment variable
 will override all settings.
 
+Three settings are provided for cache control with HTTP/1.1 complient proxy
+caches. bf(No-Cache) tells the proxy to not used its cached response under
+any circumstances, bf(Max-Age) is sent only for index files and tells the
+cache to refresh its object if it is older than the given number of seconds. 
+Debian updates its index files daily so the default is 1 day. bf(No-Store) 
+specifies that the cache should never store this request, it is only
+set for archive files. This may be usefull to prevent polluting a proxy cache
+with very large .deb files. Note: Squid 2.0.2 does not support any of
+these options. 
+
+One setting is provided to control the pipeline depth in cases where the
+remote server is not RFC conforming or buggy (such as Squid 2.0.2)
+Acquire::http::Pipeline-Depth can be a value from 0 to 5 indicating how many
+outstanding requests APT should send.
+
 dit(bf(cdrom))
 CDROM URIs; the only setting for CDROM URIs is the mount point, cdrom::Mount
 which must be the mount point for the CDROM drive as specified in /etc/fstab.
@@ -140,12 +159,15 @@ manpagesection(EXAMPLES)
 bf(/usr/doc/apt/examples/apt.conf) contains a sample configuration file
 showing the default values for all possible options.
 
+mapagesection(FILES)
+/etc/apt/apt.conf
+
 manpageseealso()
 apt-cache (8),
 apt.conf (5)
 
 manpagebugs()
-See http://www.debian.org/Bugs/db/pa/lapt.html.  If you wish to report a
+See http://bugs.debian.org/apt.  If you wish to report a
 bug in bf(apt-get), please see bf(/usr/doc/debian/bug-reporting.txt)
 or the bf(bug(1)) command.