Man pages in yodl

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

1 files changed, 0 insertions, 199 deletions

diff --git a/doc/apt-cache.8 b/doc/apt-cache.8
deleted file mode 100644
index 0292973ed..000000000
--- a/doc/apt-cache.8
+++ /dev/null
@@ -1,199 +0,0 @@
-.\" 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-cache 8 "16 June 1998" "Debian GNU/Linux"

-.SH NAME

-apt-cache \- APT package handling utility \(em cache manipulator

-.SH SYNOPSIS

-.B apt-cache

-.I command cache

-.RI [ argument 

-.IR ... ]

-.SH DESCRIPTION

-.B apt-cache

-performs a variety of operations on APT's package cache.

-.I apt-cache

-is seldom called directly; instead it is usually invoked internally by

-.BR apt-get (8)

-or

-.BR apt (8).

-.PP

-.I command

-is one of

-.RS

-.PD 0

-.B add

-.PP

-.B dump

-.PP

-.B dumpavail

-.PP

-.B showpkg

-.PP

-.B stats

-.RE

-.PD 1

-.PP

-.I cache

-must be a package cache file (for instance,

-.IR /var/cache/apt/pkgcache.bin ).

-Some

-.IR command s

-require additional arguments.

-.SS add

-.B add

-adds a new set of package records to

-.IR cache .

-Remaining arguments are of the form

-.IR file : dist : ver ,

-where

-.I file

-is the full path to file in question.

-.I dist

-and

-.I ver

-can be any string and are not yet implemented.

-.SS dump

-.B dump

-displays information about all the packages in the cache. See

-.B showpkg

-below for an explanation of what data is output for each package.

-.SS dumpavail

-.B dumpavail

-generates an

-.I available

-file suitable for use with

-.BR dpkg (8)

-based on the information in the cache.

-.SS showpkg

-.B showpkg

-displays information about the packages listed on the command line.     

-Remaining arguments are package names. The available versions and       

-reverse dependencies of each package listed are listed, as well as      

-forward dependencies for each version. Forward (normal) dependencies   

-are those packages upon which the package in question depends; reverse  

-dependencies are those packages that depend upon the package in         

-question. Thus, forward dependencies must be satisfied for a package,  

-but reverse dependencies need not be.                                   

-For instance,

-.B apt-cache showpkg

-.I cache

-.B libreadline2

-would produce output similar to the following:

-.PP

-.RS

-.PD 0

-Package: libreadline2

-.PP

-Versions: 2.1-8,2.1-7,

-.PP

-Reverse Depends:

-.RS

-.PP

-libreadlineg2,libreadline2

-.PP

-libreadlineg2,libreadline2

-.PP

-libreadline2-altdev,libreadline2

-.RE

-.PP

-Dependencies:

-.PP

-2.1-8 - libc5 ncurses3.0 ldso

-.PP

-2.1-7 - ldso libc5 ncurses3.0

-.RE

-.PD 1

-.PP

-Thus it may be seen that libreadline2, version 2.1-8, depends on libc5,

-ncurses3.0, and ldso, which must be installed for libreadline2 to work. In

-turn, libreadlineg2 and libreadline2-altdev depend on libreadline2. If

-libreadline2 is installed, libc5, ncurses3.0, and ldso must also be

-installed; libreadlineg2 and libreadline2-altdev do not have to be

-installed.

-.SS stats

-.B stats

-displays some statistics about

-.IR cache .

-No further arguments are expected. Statistics reported are:

-.RS

-.TP

-.I Total package names

-is the number of package names found in the cache.

-.TP

-.I Normal packages

-is the number of regular, ordinary package names; these

-are packages that bear a one-to-one correspondence between their names and

-the names used by other packages for them in dependencies. The majority of

-packages fall into this category.

-.TP

-.I Pure virtual packages

-is the number of packages that exist only as a virtual package name; that

-is, packages only "provide" the virtual package name, and no package

-actually uses the name. For instance, "mail-transport-agent" in the Debian

-GNU/Linux system is a pure virtual package; several packages provide

-"mail-transport-agent", but there is no package named "mail-transport-agent".

-.TP

-.I Single virtual packages

-is the number of packages with only one package providing a particular  

-virtual package. For instance, in the Debian GNU/Linux system,         

-"X11-text-viewer" is a virtual package, but only one package, xless,    

-provides "X11-text-viewer".

-.TP

-.I Mixed virtual packages

-is the number of packages that either provide a particular virtual package

-or have the virtual package name as the package name. For instance, in the

-Debian GNU/Linux system, e2fsprogs is both an actual package, and

-provided by the e2compr package.

-.TP

-.I Missing

-is the number of package names that were referenced in a dependency but

-were not provided by any package. Missing packages may be in evidence

-if a full distribution is not accesssed, or if a package (real or virtual)

-has been dropped from the distribution.

-.TP

-.I Total distinct versions

-is the number of package versions found in the cache; this value is

-therefore at least equal to the number of total package names. If more than

-one distribution (both "stable" and "unstable", for instance), is being

-accessed, this value can be considerably larger than the number of total

-package names.

-.TP

-.I Total dependencies

-is the number of dependency relationships claimed by all of the packages in

-the cache.

-.RE

-.SH OPTIONS

-None.

-.SH FILES

-None.

-.SH SEE ALSO

-.BR apt (8),

-.BR apt-get (8),

-.I /usr/doc/apt/cache*

-.SH DIAGNOSTICS

-apt-cache 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-cache ,

-please see

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

-or the

-.BR bug (1)

-command.

-.SH AUTHOR

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