Added clean install code

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

diff --git a/doc/apt-get.8.yo b/doc/apt-get.8.yo
index 3e6e64a492a631b574d5d924fa680929ede4bdac..918d17b1cddb6979b1b2dda68da3ec10e2fb8f6e 100644 (file)
--- a/doc/apt-get.8.yo
+++ b/doc/apt-get.8.yo
@@ -57,6 +57,7 @@ front-end, bf(dselect (8)). bf(dselect-upgrade)
 follows the changes made by bf(dselect) to the em(Status)
 field of available packages, and performs the actions necessary to realize
 that state (for instance, the removal of old and the installation of new
+packages). 
 
 dit(bf(dist-upgrade))
 bf(dist-upgrade),in addition to performing the function of bf(upgrade),
@@ -86,14 +87,17 @@ dit(bf(source))
 bf(source) causes apt-get to fetch source packages. APT will examine the
 available packages to decide which source package to fetch. It will then
 find and download into the current directory the newest available version of
-that source package. Source packages are tracked seperately from binary
-packages via df(deb-src) type lines in the bf(/etc/apt/sources.list) file.
+that source package. Source packages are tracked separately from binary
+packages via bf(deb-src) type lines in the bf(/etc/apt/sources.list) file.
 This probably will mean that you will not get the same source as the package
-you have installed or as you could install.
+you have installed or as you could install. If the --compile options is
+specified then the package will be compiled to a binary .deb using
+dpkg-buildpackage, if --download-only is specified then the source package
+will not be unpacked.
 
 dit(bf(check))
 bf(check) is a diagnostic tool; it updates the package cache and checks for 
-brokenpackages.
+broken packages.
 
 dit(bf(clean))
 bf(clean) clears out the local repository of retrieved package files. It 
@@ -138,7 +142,7 @@ dit(bf(-h, --help))
 Help; display a helpful usage message and exits.
 
 dit(bf(-v, --version))
-Show the program verison.
+Show the program version.
 
 dit(bf(-m, --ignore-missing, --fix-missing))
 Ignore missing packages; If packages cannot be retrieved or fail the    
@@ -146,9 +150,13 @@ integrity check after retrieval (corrupted package files), hold back
 those packages and handle the result. Use of this option together with  
 -f may produce an error in some situations. See bf(ignore-missing).
 
+dit(bf(--no-download))
+Disables downloading of packages. This is best used with --ignore-missing to
+force APT to use only the .debs it has already downloaded.
+
 dit(bf(-q, --quiet))
 Quiet; produces output suitable for logging, omitting progress indicators.
-More qs will produce more quiet up to a maximum of 2. You can also use
+More q's 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
@@ -165,18 +173,21 @@ and empty set of square brackets meaning breaks that are of no consequence
 
 dit(bf(-y, --yes, --assume-yes))
 Automatic yes to prompts; assume "yes" as answer to all prompts and run
-non-interactively. If an undesireable situation, such as changing a held
-package or removing an essential package occures then bf(apt-get) will
+non-interactively. If an undesirable situation, such as changing a held
+package or removing an essential package occurs then bf(apt-get) will
 abort. See bf(APT::Get::Assume-Yes).
 
 dit(bf(-u, --show-upgraded))
 Show upgraded packages; Print out a list of all packages that are to be
 upgraded. See bf(APT::Get::Show-Upgraded).
 
+dit(bf(-b, --compile, --build))
+Compile source packages after downloading them.
+
 dit(bf(--ignore-hold))
 Ignore package Holds; This causes bf(apt-get) to ignore a hold placed on 
-a package. This may be usefull in conjunction with bf(dist-upgrade) to
-override a large number of undesired holds. See bf(APT::Ingore-Hold).
+a package. This may be useful in conjunction with bf(dist-upgrade) to
+override a large number of undesired holds. See bf(APT::Ignore-Hold).
 
 dit(bf(--no-upgrade))
 Do not upgrade packages; When used in conjunction with bf(install)
@@ -185,7 +196,7 @@ are already installed. See bf(APT::Get::no-upgrade).
 
 dit(bf(--force-yes))
 Force yes; This is a dangerous option that will cause apt to continue without
-prompting if it is doing something potentially harmfull. It should not be used
+prompting if it is doing something potentially harmful. 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).
 
@@ -196,13 +207,26 @@ md5 hash. Note that the file name to write to will not always match
 the file name on the remote site! This also works with the bf(source)
 command See bf(APT::Get::Print-URIs).
 
+dit(bf(--purge))
+Use purge instead of remove for anything that would be removed.
+
+dit(bf(--list-cleanup))
+This option defaults to on, use bf(--no-list-cleanup) to turn it off.
+When on apt-get will automatically manage the contents of 
+/var/state/apt/lists to ensure that obsolete files are erased. The only 
+reason to turn it off is if you frequently change your source list. See
+bf(APT::Get::List-Cleanup)
+
+dit(bf(--diff-only), bd(--tar-only))
+Download only the diff or tar file of a source archive.
+
 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
 bf(apt.conf(5)) for syntax information.
 
 dit(bf(-o, --option))
-Set a Configuration Option; This will set an arbitary configuration option.
+Set a Configuration Option; This will set an arbitrary configuration option.
 The syntax is 
 verb(-o Foo::Bar=bar)
 enddit()
@@ -220,6 +244,7 @@ itemize(
   
   it() /var/state/apt/lists/
   storage area for state information for each package resource specified in
+  the source list
   
   it() /var/state/apt/lists/partial/
   storage area for state information in transit