Undid undoing for bug 65952, fix is in aliencode

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

diff --git a/doc/apt-get.8.yo b/doc/apt-get.8.yo
index c5b8a716289ca13a613ea8e298437a5402a2303c..4983b25816b5edc7cb24f1b9fbf1bd278f364f0f 100644 (file)
--- a/doc/apt-get.8.yo
+++ b/doc/apt-get.8.yo
@@ -101,6 +101,10 @@ 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.
 
+Note that source packages are not tracked like binary packages, they exist
+only in the current directory and are similar to downloading source
+tar balls.
+
 dit(bf(check))
 bf(check) is a diagnostic tool; it updates the package cache and checks for 
 broken packages.
@@ -135,14 +139,15 @@ Configuration Item: bf(APT::Get::Download-Only).
 
 dit(bf(-f, --fix-broken))
 Fix; attempt to correct a system with broken dependencies in            
-place. This option may be used alone or in conjunction with any of the  
-command actions, and is sometimes necessary when running APT for the    
-first time; APT itself does not allow broken package dependencies to    
-exist on a system. It is possible that a system's dependency structure  
-can be so corrupt as to require manual intervention (which usually
-means using dselect or dpkg --remove to eliminate some of the offending 
-packages). Use of this option together with -m may produce an error in
-some situations. Configuration Item: bf(APT::Get::Fix-Broken).
+place. This option, when used with install/remove, can omit any packages
+to permit APT to deduce a likely soltion. Any Package that are specified
+must completly correct the problem. The option is sometimes necessary when 
+running APT for the first time; APT itself does not allow broken package 
+dependencies to exist on a system. It is possible that a system's 
+dependency structure can be so corrupt as to require manual intervention 
+(which usually means using dselect or dpkg --remove to eliminate some of 
+the offending packages). Use of this option together with -m may produce an 
+error in some situations. Configuration Item: bf(APT::Get::Fix-Broken).
 
 dit(bf(-h, --help))
 Help; display a helpful usage message and exits.
@@ -154,11 +159,15 @@ dit(bf(-m, --ignore-missing, --fix-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 may produce an error in some situations. Configuration Item: bf(ignore-missing).
+-f may produce an error in some situations. If a package is selected for 
+installation (particularly if it is mentioned on the command line) and it
+could not be downloaded then it will be silently held back.
+Configuration Item: bf(APT::Get::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.
+Configuration Item: bf(APT::Get::No-Download).
 
 dit(bf(-q, --quiet))
 Quiet; produces output suitable for logging, omitting progress indicators.
@@ -191,6 +200,7 @@ upgraded. Configuration Item: bf(APT::Get::Show-Upgraded).
 
 dit(bf(-b, --compile, --build))
 Compile source packages after downloading them.
+Configuration Item: bf(APT::Get::Compile).
 
 dit(bf(--ignore-hold))
 Ignore package Holds; This causes bf(apt-get) to ignore a hold placed on 
@@ -217,6 +227,7 @@ command. Configuration Item: bf(APT::Get::Print-URIs).
 
 dit(bf(--purge))
 Use purge instead of remove for anything that would be removed.
+Configuration Item: bf(APT::Get::Purge).
 
 dit(bf(--reinstall))
 Re-Install packages that are already installed and at the newest version.
@@ -237,7 +248,7 @@ dit(bf(--no-remove))
 If any packages are to be removed apt-get immediately aborts without
 prompting. Configuration Item: bf(APT::Get::No-Remove)
 
-dit(bf(--diff-only), bd(--tar-only))
+dit(bf(--diff-only), bf(--tar-only))
 Download only the diff or tar file of a source archive. 
 Configuration Item: bf(APT::Get::Diff-Only)