summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/Bugs47
-rw-r--r--doc/apt-get.8.yo6
-rw-r--r--doc/apt.conf.5.yo10
-rw-r--r--doc/examples/apt.conf7
4 files changed, 56 insertions, 14 deletions
diff --git a/doc/Bugs b/doc/Bugs
index 8fdaf9198..633137202 100644
--- a/doc/Bugs
+++ b/doc/Bugs
@@ -2,15 +2,8 @@
#24000: Bug in apt Version: 0.0.17-1bo0
Summary: Couldn't locate an archive source for a package
Status: Require Status file.
-#24685: HTTP Proxy cache refresh
- Summary: Some caches hold onto the package index file for too long
- Status: It may be possible to insert the proper header to disable
- caching but I can't think how to do this while allowing
- the cache to return cached objects - in effect it would
- completely disable the cache which may not be desired.
#24717: apt dies early if one postinst/preinst dies
Status: Requires dpkg modifications
-#22892: Apt improvements
#28184: apt could be smarter regarding mirrors
Summary: Make use of redundant sources
Status: 0.3.0 will likely do this, already the information for it is stored.
@@ -113,6 +106,37 @@
#29441: documenting the codes for -s
Summary: Apparently the simulation output is not immediately obvois
Status: Someone should update the man page.
+#24685: HTTP Proxy cache refresh
+ Summary: Some caches hold onto the package index file for too long
+ Status: It may be possible to insert the proper header to disable
+ caching but I can't think how to do this while allowing
+ the cache to return cached objects - in effect it would
+ completely disable the cache which may not be desired.
+ APT now sends a max age header. See the apt.conf(5)
+#28172: HTTP Proxy cache refresh should be forced for corrupted packages
+ Summary: Some problem resulted in a corrupted package
+ Status: I belive this reflects a deeper problem and the suggested solution
+ is only a band-aide patch. I intend to close this bug when #24685
+ is fixed with a configuration directive.
+ Use -o acquire::http::no-cache=true
+#29351: poor error message after conffile update
+ Summary: APT errors when the package file is not found
+ Status: The new APT warns better and the error is not fatal
+#30112: apt: internal error in apt
+ Summary: APT gives an unclear error when it cannot correct dependencies
+ Status: Error is clearer
+#30324: apt-get lying about file dates in /var/state/apt/lists
+ Summary: Doesn't copy the file dates right with file URIs
+ Status: Fixed in v3
+#30383: apt: dist-upgrade msg "E: Internal error, ScoredFix generated breaks."
+ Summary: libc6 maddness causes bizzar problems
+ Status: Fixed in v3
+#29983: apt: Wrong diagnostic, could be better
+ Summary: It doesn't explicy say you should be root
+ Status: Fixed in v3
+#22892: Apt improvements
+ Summary: Bails if an index file can't be found
+ Status: Fixed in v3
-- Silly things
#26592: apt: Problems with ftpd in SunOS 5.6
@@ -135,12 +159,11 @@
#22551: apt: wish: use dist X iff pkg does not exist in dist Y
#27100: apt: Better support for project/experimental
Status: GUI Feature - Version selection and pinning
-#28172: HTTP Proxy cache refresh should be forced for corrupted packages
- Summary: Some problem resulted in a corrupted package
- Status: I belive this reflects a deeper problem and the suggested solution
- is only a band-aide patch. I intend to close this bug when #24685
- is fixed with a configuration directive.
#27646: Apt: dpkg --merge-avail
Summary: Suggestion to call merge avail after each update operation
Status: Unlikely. The dpkg --print-avail functions should be obsoleted
by the apt-query program which should be written.
+#30237: apt: 0.1.9 checks dependencies against packages.gz
+ Summary: For packages with identical version numbers APT prefers
+ to use the archive index files
+ Status: Yes it is sorta bad, but there is no reasonable solution.
diff --git a/doc/apt-get.8.yo b/doc/apt-get.8.yo
index 604051312..4d3efd745 100644
--- a/doc/apt-get.8.yo
+++ b/doc/apt-get.8.yo
@@ -130,7 +130,11 @@ See bf(quiet)
dit(bf(-s, --simulate, --just-print, --dry-run, --recon, --no-act))
No action; perform a simulation of events that would occur but do not
-actually change the system. See bf(APT::Get::Simulate).
+actually change the system. See bf(APT::Get::Simulate). Simulate prints out
+a series of lines each one representing a dpkg operation, Configure (Conf),
+Remove (Remv), Unpack (Inst). Square brackets indicate broken packages with
+and empty set of square brackets meaning breaks that are of no consequence
+(rare).
dit(bf(-y, --yes, --assume-yes))
Automatic yes to prompts; assume "yes" as answer to all prompts and run
diff --git a/doc/apt.conf.5.yo b/doc/apt.conf.5.yo
index 5c4a9d429..a1ebd784c 100644
--- a/doc/apt.conf.5.yo
+++ b/doc/apt.conf.5.yo
@@ -79,6 +79,16 @@ 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 value. Debian
+updates its index files daily so the default is 1 day. bd(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.
+
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.
diff --git a/doc/examples/apt.conf b/doc/examples/apt.conf
index 18292f6f6..061b082dd 100644
--- a/doc/examples/apt.conf
+++ b/doc/examples/apt.conf
@@ -1,4 +1,4 @@
-// $Id: apt.conf,v 1.17 1998/12/06 04:36:33 jgg Exp $
+// $Id: apt.conf,v 1.18 1998/12/06 22:51:14 jgg Exp $
/* This file is an index of all APT configuration directives. It should
NOT actually be used as a real config file, though it is a completely
valid file.
@@ -56,6 +56,11 @@ Acquire
{
Proxy "http://127.0.0.1:3128";
Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
+
+ // Cache Control. Note these do not work with Squid 2.0.2
+ No-Cache "false";
+ Max-Age "86400"; // 1 Day age on index files
+ No-Store "false"; // Prevent the cache from storing archives
};
cdrom