oops

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

diff --git a/doc/apt-get.8.yo b/doc/apt-get.8.yo
index 32b1e613223047c4b194cf8fd56de0f23d701fc1..4d3efd745ed10fdcb46b8c0f909eb4884bb9e08b 100644 (file)
--- a/doc/apt-get.8.yo
+++ b/doc/apt-get.8.yo
@@ -16,14 +16,14 @@ itemize(
   it() upgrade
   it() dselect-upgrade
   it() dist-upgrade
-  it() install
-  it() remove
+  it() install package1 [package2] [...]
+  it() remove package1 [package2] [...]
   it() check
   it() clean
 )
 
 Unless the -h, or --help option is given one of the above commands
-must be present. Only the install command requires any further arguments.
+must be present.
 
 startdit()
 dit(bf(update))
@@ -73,6 +73,11 @@ hyphen is appended to the package name (with no intervening space), the
 identified package will be removed if it is installed. This latter feature 
 may be used to override decisions made by apt-get's conflict resolution system.
 
+dit(bf(remove))
+bf(remove) is identical to bf(install) except that packages are removed
+instead of installed. If a plus sign is appended to the package name (with no
+intervening space), the identified package will be installed.
+
 dit(bf(check))
 bf(check) is a diagnostic tool; it updates the package cache and checks for 
 brokenpackages.
@@ -87,10 +92,15 @@ from time to time to free up disk space.
 enddit()
 
 manpageoptions()
+All command line options may be set using the configuration file, the
+descriptions indicate the configuration option to set. For boolean
+options you can override the config file by using something like bf(-f-),
+bf(--no-f), bf(-f=no) or several other variations.
 
 startdit()
 dit(bf(-d, --download-only))
 Download only; package files are only retrieved, not unpacked or installed.
+See bf(APT::Get::Download-Only).
 
 dit(bf(-f, --fix-broken))
 Fix; attempt to correct a system with broken dependencies in            
@@ -101,7 +111,7 @@ 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.
+some situations. See bf(APT::Get::Fix-Broken).
 
 dit(bf(-h, --help))
 Help; display a helpful usage message and exits.
@@ -110,42 +120,47 @@ 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.
+-f is discouraged. See bf(ignore-missing).
 
-dit(bf(-q, --silent))
+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.
+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.
+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
 non-interactively. If an undesireable situation, such as changing a held
 package or removing an essential package occures then bf(apt-get) will
-abort.
+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.
+upgraded. See bf(APT::Get::Show-Upgraded).
 
 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.
+override a large number of undesired holds. See bf(APT::Ingore-Hold).
 
 dit(bf(--no-upgrade))
 Do not upgrade packages; When used in conjunction with bf(install)
 bf(no-upgrade) will prevent packages listed from being upgraded if they
-are already installed.
+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
 except in very special situations. Using bf(force-yes) can potentially destroy
-your system!
+your system! See bf(APT::Get::force-yes).
 
 dit(bf(-c, --config-file))
 Configuration File; Specify a configuration file to use. bf(apt-get) will
@@ -156,6 +171,7 @@ dit(bf(-o, --option))
 Set a Configuration Option; This will set an arbitary configuration option.
 The syntax is 
 verb(-o Foo::Bar=bar)
+enddit()
 
 manpagefiles()
 itemize(
@@ -176,10 +192,12 @@ itemize(
 )
 
 manpageseealso()
-apt-cache (8),
-dpkg (8),
-dselect (8),
-sources.list (5)
+apt-cache(8),
+dpkg(8),
+dselect(8),
+sources.list(5),
+apt.conf(5),
+The APT Users Guide in /usr/doc/apt/
 
 manpagediagnostics()
 apt-get returns zero on normal operation, decimal 100 on error.