This file is indexed.

/usr/share/doc/apt-doc/guide.html/ch2.html is in apt-doc 1.0.1ubuntu2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">

<html>

<head>

<meta http-equiv="content-type" content="text/html; charset=utf-8">

<title>APT User's Guide - apt-get</title>

<link href="index.html" rel="start">
<link href="ch1.html" rel="prev">
<link href="ch3.html" rel="next">
<link href="index.html#contents" rel="contents">
<link href="index.html#copyright" rel="copyright">
<link href="ch1.html" rel="chapter" title="1 General">
<link href="ch2.html" rel="chapter" title="2 apt-get">
<link href="ch3.html" rel="chapter" title="3 DSelect">
<link href="ch4.html" rel="chapter" title="4 The Interface">
<link href="ch1.html#s1.1" rel="section" title="1.1 Anatomy of the Package System">
<link href="ch4.html#s4.1" rel="section" title="4.1 Startup">
<link href="ch4.html#s4.2" rel="section" title="4.2 The Status Report">
<link href="ch4.html#s4.3" rel="section" title="4.3 The Status Display">
<link href="ch4.html#s4.4" rel="section" title="4.4 Dpkg">
<link href="ch4.html#s4.2.1" rel="subsection" title="4.2.1 The Extra Package list">
<link href="ch4.html#s4.2.2" rel="subsection" title="4.2.2 The Packages to Remove">
<link href="ch4.html#s4.2.3" rel="subsection" title="4.2.3 The New Packages list">
<link href="ch4.html#s4.2.4" rel="subsection" title="4.2.4 The Kept Back list">
<link href="ch4.html#s4.2.5" rel="subsection" title="4.2.5 Held Packages warning">
<link href="ch4.html#s4.2.6" rel="subsection" title="4.2.6 Final summary">

</head>

<body>

<p><a name="ch2"></a></p>
<hr>

<p>
[ <a href="ch1.html">previous</a> ]
[ <a href="index.html#contents">Contents</a> ]
[ <a href="ch1.html">1</a> ]
[ 2 ]
[ <a href="ch3.html">3</a> ]
[ <a href="ch4.html">4</a> ]
[ <a href="ch3.html">next</a> ]
</p>

<hr>

<h1>
APT User's Guide
<br>Chapter 2 - apt-get
</h1>

<hr>

<p>
<code>apt-get</code> provides a simple way to install packages from the command
line.  Unlike <code>dpkg</code>, <code>apt-get</code> does not understand .deb
files, it works with the package's proper name and can only install .deb
archives from a <em>Source</em>.
</p>

<p>
The first [<a href="footnotes.html#f1" name="fr1">1</a>] thing that should be
done before using <code>apt-get</code> is to fetch the package lists from the
<em>Sources</em> so that it knows what packages are available.  This is done
with <samp>apt-get update</samp>.  For instance,
</p>

<pre>
     # apt-get update
     Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages
     Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages
     Reading Package Lists... Done
     Building Dependency Tree... Done
</pre>

<p>
Once updated there are several commands that can be used:
</p>
<dl>
<dt>upgrade</dt>
<dd>
<p>
Upgrade will attempt to gently upgrade the whole system.  Upgrade will never
install a new package or remove an existing package, nor will it ever upgrade a
package that might cause some other package to break.  This can be used daily
to relatively safely upgrade the system.  Upgrade will list all of the packages
that it could not upgrade, this usually means that they depend on new packages
or conflict with some other package.  <code>dselect</code> or <samp>apt-get
install</samp> can be used to force these packages to install.
</p>
</dd>
</dl>
<dl>
<dt>install</dt>
<dd>
<p>
Install is used to install packages by name.  The package is automatically
fetched and installed.  This can be useful if you already know the name of the
package to install and do not want to go into a GUI to select it.  Any number
of packages may be passed to install, they will all be fetched.  Install
automatically attempts to resolve dependency problems with the listed packages
and will print a summary and ask for confirmation if anything other than its
arguments are changed.
</p>
</dd>
</dl>
<dl>
<dt>dist-upgrade</dt>
<dd>
<p>
Dist-upgrade is a complete upgrader designed to simplify upgrading between
releases of Debian.  It uses a sophisticated algorithm to determine the best
set of packages to install, upgrade and remove to get as much of the system to
the newest release.  In some situations it may be desired to use dist-upgrade
rather than spend the time manually resolving dependencies in
<code>dselect</code>.  Once dist-upgrade has completed then
<code>dselect</code> can be used to install any packages that may have been
left out.
</p>

<p>
It is important to closely look at what dist-upgrade is going to do, its
decisions may sometimes be quite surprising.
</p>
</dd>
</dl>

<p>
<code>apt-get</code> has several command line options that are detailed in its
man page, <code>apt-get(8)</code>.  The most useful option is <samp>-d</samp>
which does not install the fetched files.  If the system has to download a
large number of package it would be undesired to start installing them in case
something goes wrong.  When <samp>-d</samp> is used the downloaded archives can
be installed by simply running the command that caused them to be downloaded
again without <samp>-d</samp>.
</p>

<hr>

<p>
[ <a href="ch1.html">previous</a> ]
[ <a href="index.html#contents">Contents</a> ]
[ <a href="ch1.html">1</a> ]
[ 2 ]
[ <a href="ch3.html">3</a> ]
[ <a href="ch4.html">4</a> ]
[ <a href="ch3.html">next</a> ]
</p>

<hr>

<p>
APT User's Guide
</p>

<address>
$Id: guide.sgml,v 1.7 2003/04/26 23:26:13 doogie Exp $<br>
<br>
Jason Gunthorpe <code><a href="mailto:jgg@debian.org">mailto:jgg@debian.org</a></code><br>
<br>
</address>
<hr>

</body>

</html>