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 60405131258c1540079a767bb288467818d5592d..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()
@@ -116,21 +125,31 @@ some situations. See bf(APT::Get::Fix-Broken).
 dit(bf(-h, --help))
 Help; display a helpful usage message and exits.
 
+dit(bf(-v, --version))
+Show the program verison.
+
 dit(bf(-m, --ignore-missing))
 Ignore missing packages; If packages cannot be retrieved or fail the    
 integrity check after retrieval (corrupted package files), hold back    
 those packages and handle the result. Use of this option together with  
--f is discouraged. See bf(ignore-missing).
+-f may produce an error in some situations. See bf(ignore-missing).
 
 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))
 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
@@ -158,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
@@ -199,7 +224,7 @@ manpagediagnostics()
 apt-get returns zero on normal operation, decimal 100 on error.
 
 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.