Fixed another oops

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

diff --git a/doc/apt-get.8.yo b/doc/apt-get.8.yo
index 32b1e613223047c4b194cf8fd56de0f23d701fc1..768b4e69502507970a03b0dfdc42840ab6e22f44 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() 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
   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))
 
 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.
 
 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.
 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()
 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.
 
 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            
 
 dit(bf(-f, --fix-broken))
 Fix; attempt to correct a system with broken dependencies in            


@@ -101,51 +111,65 @@ 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
 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.
 
 
 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  
 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 may produce an error in some situations. 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.
 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
 
 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
 
 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
 
 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
 
 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
 
 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
 
 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(--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
 
 dit(bf(-c, --config-file))
 Configuration File; Specify a configuration file to use. bf(apt-get) will


@@ -156,6 +180,7 @@ dit(bf(-o, --option))
 Set a Configuration Option; This will set an arbitary configuration option.
 The syntax is 
 verb(-o Foo::Bar=bar)
 Set a Configuration Option; This will set an arbitary configuration option.
 The syntax is 
 verb(-o Foo::Bar=bar)

+enddit()

 
 manpagefiles()
 itemize(
 
 manpagefiles()
 itemize(


@@ -176,16 +201,18 @@ itemize(
 )
 
 manpageseealso()
 )
 
 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.
 
 manpagebugs()
 
 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.
 
 bug in bf(apt-get), please see bf(/usr/doc/debian/bug-reporting.txt)
 or the bf(bug(1)) command.