Updated docs to reflect new file naming

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

diff --git a/doc/apt-get.8.yo b/doc/apt-get.8.yo
index 60405131258c1540079a767bb288467818d5592d..6209c7e0728a62f533e6aa2a64c5af3a9b2be13d 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
@@ -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,11 +125,14 @@ 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.
@@ -130,7 +142,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
@@ -158,6 +174,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 +221,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.