Doc updates and -qq fix

[apt.git] / doc / apt-get.8.yo

diff --git a/doc/apt-get.8.yo b/doc/apt-get.8.yo
index 30a2fc691f1e020c8435d27cf626385279c0ba64..f57b62e00b3ab9d51983757ce60d838c41b5ab4d 100644 (file)
--- a/doc/apt-get.8.yo
+++ b/doc/apt-get.8.yo
@@ -20,6 +20,7 @@ itemize(
   it() remove package1 [package2] [...]
   it() check
   it() clean
+  it() autoclean
 )
 
 Unless the -h, or --help option is given one of the above commands
@@ -65,7 +66,7 @@ list of locations from which to retrieve desired package files.
 dit(bf(install))
 bf(install) is followed by one or more em(packages) desired for installation. 
 Each em(package) is a package name, not a fully qualified filename 
-(for instance, in a Debian GNU/Linux system, em(lsdo) would be the argument 
+(for instance, in a Debian GNU/Linux system, em(ldso) would be the argument 
 provided, not em(ldso_1.9.6-2.deb)). All packages required by the package(s) 
 specified for installation will also be retrieved and installed. The
 bf(/etc/apt/sources.list) file is used to locate the desired packages. If a
@@ -89,6 +90,14 @@ and bf(/var/cache/apt/archives/partial/).
 When APT is used as a bf(dselect(8)) method, bf(clean) is run automatically.
 Those who do not use dselect will likely want to run code(apt-get clean)
 from time to time to free up disk space.
+
+dit(bf(autoclean))
+Like bf(clean), df(autoclean) clears out the local repository of retrieved 
+package files. The difference is that it only removes package files that
+can no longer be downloaded, and are largely useless. This allows a
+cache to be maintained over a long period without it growing out of
+control.
+
 enddit()
 
 manpageoptions()
@@ -127,8 +136,11 @@ those packages and handle the result. Use of this option together with
 
 dit(bf(-q, --quiet))
 Quiet; produces output suitable for logging, omitting progress indicators.
-More qs will produce more quite up to a maximum of 2. You can also use
-bf(-q=#) to set the quiet level, overriding the configuration file.
+More qs will produce more quiet up to a maximum of 2. You can also use
+bf(-q=#) to set the quiet level, overriding the configuration file. Note that
+quiet level 2 implies -y, you should never use -qq without a no-action
+modifier such as -d, --print-uris or -s as APT may decided to do something
+you did not expect.
 See bf(quiet)
 
 dit(bf(-s, --simulate, --just-print, --dry-run, --recon, --no-act))
@@ -165,6 +177,12 @@ prompting if it is doing something potentially harmfull. It should not be used
 except in very special situations. Using bf(force-yes) can potentially destroy
 your system! See bf(APT::Get::force-yes).
 
+dit(bf(--print-uris))
+Instead of fetching the files to install their URIs are printed. Each
+URI will have the path, the destination file name, the size and the expected
+md5 hash. Note that the file name to write to will not always match
+the file name on the remote site! See bf(APT::Get::Print-URIs).
+
 dit(bf(-c, --config-file))
 Configuration File; Specify a configuration file to use. bf(apt-get) will
 read the default configuration file and then this configuration file. See