Man pages in yodl

Author: jgg
Date: 1998-12-05 22:14:39 GMT
Man pages in yodl

1 files changed, 0 insertions, 249 deletions

diff --git a/doc/apt-get.8 b/doc/apt-get.8
deleted file mode 100644
index 48e453dba..000000000
--- a/doc/apt-get.8
+++ /dev/null
@@ -1,249 +0,0 @@
-.\" $Id: apt-get.8,v 1.2 1998/11/23 01:15:56 jgg Exp $

-.\" This manpage is copyright (C) 1998 Branden Robinson <branden@debian.org>.

-.\" 

-.\" This is free software; you may redistribute it and/or modify

-.\" it under the terms of the GNU General Public License as

-.\" published by the Free Software Foundation; either version 2,

-.\" or (at your option) any later version.

-.\"

-.\" This is distributed in the hope that it will be useful, but

-.\" WITHOUT ANY WARRANTY; without even the implied warranty of

-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

-.\" GNU General Public License for more details.

-.\"

-.\" You should have received a copy of the GNU General Public

-.\" License along with APT; if not, write to the Free Software

-.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 

-.\" 02111-1307 USA

-.TH apt-get 8 "16 June 1998" "Debian GNU/Linux"

-.SH NAME

-apt-get \- APT package handling utility \(em command-line interface

-.SH SYNOPSIS

-.B apt-get

-.RI [ options ]

-.RI [ command ]

-.RI [ package

-.IR ... ]

-.SH DESCRIPTION

-.B apt-get

-is the command-line tool for handling packages, and may be considered the

-user's "back-end" to

-.BR apt (8).

-Use

-.BR apt (8)

-if the usage of apt-get does not seem intuitive.

-.PP

-.I command

-is one of

-.RS

-.PD 0

-.B update

-.PP

-.B upgrade

-.PP

-.B dselect-upgrade

-.PP

-.B dist-upgrade

-.PP

-.B install

-.PP

-.B check

-.PP

-.B clean

-.RE

-.PD 1

-.PP

-Unless one of the

-.IR -h ,

-.IR --help ,

-.IR -f ,

-or

-.I --fix-broken

-options is given, one of the above commands must be present. Only the

-.B install

-command requires any further arguments.

-.SS update

-.B update

-is used to resynchronize the package overview files from their

-sources. The overviews of available packages are fetched from the

-location(s) specified in

-.IR /etc/apt/sources.list .

-For example, when using a Debian archive, this command retrieves and

-scans the

-.I Packages.gz

-files, so that information about new and updated packages is available. An

-.B update

-should always be performed before an

-.B upgrade

-or

-.BR dist-upgrade .

-.SS upgrade

-.B upgrade

-is used to install the newest versions of all packages currently installed

-on the system from the sources enumerated in

-.IR /etc/apt/sources.list .

-Packages currently installed with new versions available are retrieved

-and upgraded; under no circumstances are currently installed packages

-removed, or packages not already installed retrieved and installed. New

-versions of currently installed packages that cannot be upgraded without

-changing the install status of another package will be left at their

-current version. An

-.B update

-must be performed first so that

-.B apt-get

-knows that new versions of packages are available.

-.SS dselect-upgrade

-.B dselect-upgrade

-is used in conjunction with the traditional Debian GNU/Linux packaging

-front-end,

-.BR dselect (8). " dselect-upgrade"

-follows the changes made by

-.B dselect

-to the

-.I 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).

-.B dselect-upgrade

-does not attempt to intelligently address dependency issues as

-.B dist-upgrade

-or

-.B install

-do. If any dependency problems arise,

-.B apt-get

-aborts without performing any of the actions requested, even those

-without problems.

-.B dselect-upgrade

-is only useful to users of

-.B dselect

-and the

-.I .deb

-package file format. The

-.I /etc/apt/sources.list

-file contains a list of locations from which to retrieve desired package

-files.

-.SS dist-upgrade

-.BR dist-upgrade ,

-in addition to performing the function of

-.BR upgrade ,

-also intelligently handles changing dependencies with new versions of

-packages;

-.B apt-get

-has a "smart" conflict resolution system, and it will attempt to upgrade

-the most important packages at the expense of less important ones if

-necessary. The

-.I /etc/apt/sources.list

-file contains a list of locations from which to retrieve desired package

-files.

-.SS install

-.B install

-is followed by one or more

-.I packages

-desired for installation. Each

-.I package

-is a package name, not a fully qualified filename (for instance, in a

-Debian GNU/Linux system,

-.I lsdo

-would be the argument provided, not

-.IR ldso_1.9.6-2.deb ).

-All packages required by the package(s) specified for installation will

-also be retrieved and installed. The

-.I /etc/apt/sources.list

-file is used to locate the desired packages. If a 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.

-.SS check

-.B check

-is a diagnostic tool; it updates the package cache and checks for broken

-packages.

-.SS clean

-.B clean

-clears out the local repository of retrieved package files. It removes

-everything but the lock file from

-.I /var/cache/apt/archives/

-and

-.IR /var/cache/apt/archives/partial/ .

-When APT is used as a

-.BR dselect (8)

-method,

-.B

-clean

-is run automatically.  Those who do not use dselect will likely want to

-run

-.B

-apt-get clean

-from time to time to free up disk space.

-.SH OPTIONS

-.TP

-.IR \-d , " --download-only"

-Download only; package files are only retrieved, not unpacked or installed.

-.TP

-.IR \-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 is discouraged.          

-.TP

-.IR \-h , " --help"

-Help; display a helpful usage message and exit.

-.TP

-.IR \-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.                                                      

-.TP

-.IR \-q , " --silent"

-Quiet; produces output suitable for logging, omitting progress indicators.

-.TP

-.I \-qq

-Very quiet; no output except for errors.

-.TP

-.IR \-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.

-.TP

-.IR \-y , " --yes" , " --assume-yes"

-Automatic yes to prompts; assume "yes" as answer to all prompts and run

-non-interactively.

-.SH FILES

-.TP

-.I /etc/apt/sources.list

-see

-.BR sources.list (5)

-.TP

-.I /var/cache/apt/archives/

-storage area for retrieved package files

-.TP

-.I /var/cache/apt/archives/partial/

-storage area for package files in transit

-.TP

-.I /var/state/apt/lists/

-storage area for state information for each package resource specified in

-.I /etc/apt/sources.list

-.TP

-.I /var/state/apt/lists/partial/

-storage area for state information in transit

-.SH SEE ALSO

-.BR apt-cache (8),

-.BR dpkg (8),

-.BR dselect (8),

-.BR sources.list (5)

-.SH DIAGNOSTICS

-apt-get returns zero on normal operation, decimal 100 on error.

-.SH BUGS

-See <http://www.debian.org/Bugs/db/pa/lapt.html>.  If you wish to report a

-bug in

-.BR apt-get ,

-please see

-.I /usr/doc/debian/bug-reporting.txt

-or the

-.BR bug (1)

-command.

-.SH AUTHOR

-apt-get was written by the APT team <apt@packages.debian.org>.