Bug#90027: marked as done (apt: documentation wording problems [with patch])
Your message dated Mon, 20 Aug 2001 22:46:30 -0600 (MDT)
with message-id <Pine.LNX.3.96.1010820224454.12485A-100000@wakko.deltatee.com>
and subject line Fixed in apt 0.5.4
has caused the attached Bug report to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere. Please contact me immediately.)
Darren Benham
(administrator, Debian Bugs database)
--------------------------------------
Received: (at submit) by bugs.debian.org; 17 Mar 2001 19:46:44 +0000
>From jrv@vanzandt.mv.com Sat Mar 17 13:46:44 2001
Return-path: <jrv@vanzandt.mv.com>
Received: from mercury.mv.net [199.125.85.40] (root)
by master.debian.org with esmtp (Exim 3.12 1 (Debian))
id 14eMey-0001uq-00; Sat, 17 Mar 2001 13:46:44 -0600
Received: from vanzandt.mv.com (root@vanzandt.mv.com [207.22.43.76]) by mercury.mv.net (8.8.8/mem-971025) with ESMTP id OAA25026 for <submit@bugs.debian.org>; Sat, 17 Mar 2001 14:46:39 -0500 (EST)
Received: by vanzandt.mv.com
via sendmail with stdio
id <m14eMYt-0006KsC@vanzandt.mv.com> (Debian Smail3.2.0.102)
for submit@bugs.debian.org; Sat, 17 Mar 2001 14:40:27 -0500 (EST)
Message-Id: <m14eMYt-0006KsC@vanzandt.mv.com>
Date: Sat, 17 Mar 2001 14:40:27 -0500 (EST)
From: "James R. Van Zandt" <jrv@vanzandt.mv.com>
Subject: apt: documentation wording problems [with patch]
To: submit@bugs.debian.org
X-Mailer: bug 3.2.10
Delivered-To: submit@bugs.debian.org
Package: apt
Version: 0.3.18
Severity: normal
The APT User's Guide has a number of awkwardly worded passages and
spelling errors. I suggest the changes below.
- Jim Van Zandt
--- ../reference/doc/guide.sgml Fri Mar 16 21:46:43 2001
+++ doc/guide.sgml Sat Mar 17 14:35:35 2001
@@ -39,14 +39,14 @@
<p>
The Debian packaging system has a large amount of information associated with
each package to help assure that it integrates cleanly and easily into
-the system. The most prominent of features is the dependency system.
+the system. The most prominent of its features is the dependency system.
<p>
The dependency system allows individual programs to make use of shared
elements in the system such as libraries. It simplifies placing infrequently
used portions of a program in separate packages to reduce the
number of things the average user is required to install. Also, it allows
-a choices in for such things as mail transport agents, X servers and
+for choices in mail transport agents, X servers and
so on.
<p>
@@ -96,7 +96,7 @@
<p>
<prgn>apt-get</> provides a simple way to install packages from the command
line. Unlike <prgn>dpkg</>, <prgn>apt-get</> does not understand .deb files,
-it works with the packages proper name and can only install .deb archives from
+it works with the package's proper name and can only install .deb archives from
a <em>Source</>.
<p>
@@ -116,7 +116,7 @@
</example>
<p>
-Once updated there are several useful commands that can be used,
+Once updated there are several commands that can be used:
<taglist>
<tag>upgrade<item>
Upgrade will attempt to gently upgrade the whole system. Upgrade will
@@ -125,20 +125,20 @@
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.
-<prgn>Dselect</> or <tt>apt-get install</> can be used to force these
+<prgn>dselect</> or <tt>apt-get install</> can be used to force these
packages to install.
<tag>install<item>
-Install is used to install single packages by name. The package is
+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 it's arguments are changed
+if anything other than its arguments are changed.
<tag>dist-upgrade<item>
-Dist-upgrade is a complete upgrader designed to make simple upgrading between
+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
@@ -152,7 +152,7 @@
</taglist>
<p>
-<prgn>apt-get</> has several command line options that are detailed in it's
+<prgn>apt-get</> has several command line options that are detailed in its
man page, <manref name="apt-get" section="8">. The most useful option is
<tt>-d</> 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
@@ -229,7 +229,7 @@
<p>
The components list refers to the list of sub distributions to fetch. The
-distribution is split up based on software copyright, main being DFSG free
+distribution is split up based on software licenses, main being DFSG free
packages while contrib and non-free contain things that have various
restrictions placed on their use and distribution.
@@ -251,8 +251,8 @@
performs both of them together.
<p>
-By default APT will automatically remove the packages once they have been
-sucessfully installed. To change this behavor place <tt>Dselect::clean
+By default APT will automatically remove the package (.deb) files once they have been
+successfully installed. To change this behavior place <tt>Dselect::clean
"prompt";</> in /etc/apt/apt.conf.
</chapt>
@@ -278,14 +278,14 @@
<sect>Startup
<p>
-Before all operations, except update, APT performs a number of actions to
-prepare its internal state. It also does some checks of the systems state.
+Before all operations except update, APT performs a number of actions to
+prepare its internal state. It also does some checks of the system's state.
At any time these operations can be performed by running <tt>apt-get check</>.
<p>
<example>
# apt-get check
Reading Package Lists... Done
-Building Dependancy Tree... Done
+Building Dependency Tree... Done
</example>
<p>
@@ -297,14 +297,14 @@
<p>
The final operation performs a detailed analysis of the system's dependencies.
It checks every dependency of every installed or unpacked package and considers
-if it is ok. Should this find a problem then a report will be printed out and
+if it is OK. Should this find a problem then a report will be printed out and
<prgn>apt-get</> will refuse to run.
<p>
<example>
# apt-get check
Reading Package Lists... Done
-Building Dependancy Tree... Done
+Building Dependency Tree... Done
You might want to run apt-get -f install' to correct these.
Sorry, but the following packages have unmet dependencies:
9fonts: Depends: xlib6g but it is not installed
@@ -336,7 +336,7 @@
<p>
The second situation is much less serious than the first because APT places
-certain assurances on the order that packages are installed. In both cases
+certain constraints on the order that packages are installed. In both cases
supplying the <tt>-f</> option to <prgn>apt-get</> will cause APT to deduce a
possible solution to the problem and then continue on. The APT <prgn>dselect</>
method always supplies the <tt>-f</> option to allow for easy continuation
@@ -395,7 +395,7 @@
be taken off. The <tt>-f</> option is especially good at generating packages
to remove so extreme care should be used in that case. The list may contain
packages that are going to be removed because they are only
-partially removed, possibly due to an aborted installation.
+partially installed, possibly due to an aborted installation.
</sect1>
<sect1>The New Packages list
@@ -498,7 +498,7 @@
inaccuracies.
<p>
-The next section of the status line is repeated once for each dowload thread
+The next section of the status line is repeated once for each download thread
and indicates the operation being performed and some useful information
about what is happening. Sometimes this section will simply read <em>Forking</>
which means the OS is loading the download module. The first word after the [
@@ -511,11 +511,11 @@
of the negotiation phase of the download. Typically it progresses from
<em>Connecting</> to <em>Waiting for file</> to <em>Downloading</> or
<em>Resuming</>. The final value is the number of bytes downloaded from the
-remote site. Once the download begings this is represented as <tt>102/10.2k</>
+remote site. Once the download begins this is represented as <tt>102/10.2k</>
indicating that 102 bytes have been fetched and 10.2 kilobytes is expected.
The total size is always shown in 4 figure notation to preserve space. After
the size display is a percent meter for the file itself.
-The second last element is the instantenous average speed. This values is
+The second last element is the instantaneous average speed. This values is
updated every 5 seconds and reflects the rate of data transfer for that
period. Finally is shown the estimated transfer time. This is updated
regularly and reflects the time to complete everything at the shown
-- System Information
Debian Release: 2.2
Kernel Version: Linux vanzandt 2.4.2 #4 Sat Mar 3 21:34:20 EST 2001 i686 unknown
Versions of the packages apt depends on:
ii libc6 2.2.1-1 GNU C Library: Shared libraries and Timezone
ii libstdc++2.10 2.95.2-10 The GNU stdc++ library
---------------------------------------
Received: (at 90027-done) by bugs.debian.org; 21 Aug 2001 04:46:46 +0000
>From jgg@debian.org Mon Aug 20 23:46:46 2001
Return-path: <jgg@debian.org>
Received: from cast-ext.ab.videon.ca [206.75.216.34]
by master.debian.org with smtp (Exim 3.12 1 (Debian))
id 15Z3R3-0000yY-00; Mon, 20 Aug 2001 23:46:42 -0500
Received: (qmail 1390 invoked from network); 21 Aug 2001 04:46:39 -0000
Received: from unknown (HELO wakko.deltatee.com) ([24.108.173.63]) (envelope-sender <jgg@debian.org>)
by cast-ext.ab.videon.ca (qmail-ldap-1.03) with SMTP
for <56708-done@bugs.debian.org>; 21 Aug 2001 04:46:39 -0000
Received: from localhost
([127.0.0.1] helo=wakko.deltatee.com ident=jgg)
by wakko.deltatee.com with smtp (Exim 3.16 #1 (Debian))
id 15Z3Qt-0003KS-00; Mon, 20 Aug 2001 22:46:31 -0600
Date: Mon, 20 Aug 2001 22:46:30 -0600 (MDT)
From: Jason Gunthorpe <jgg@debian.org>
X-Sender: jgg@wakko.deltatee.com
To: 56708-done@bugs.debian.org, 59432-done@bugs.debian.org,
65691-done@bugs.debian.org, 86954-done@bugs.debian.org,
88913-done@bugs.debian.org, 89066-done@bugs.debian.org,
89066-done@bugs.debian.org, 89121-done@bugs.debian.org,
89152-done@bugs.debian.org, 89671-done@bugs.debian.org,
89762-done@bugs.debian.org, 89854-done@bugs.debian.org,
90027-done@bugs.debian.org, 92025-done@bugs.debian.org,
92033-done@bugs.debian.org, 92757-done@bugs.debian.org,
93057-done@bugs.debian.org, 93652-done@bugs.debian.org,
94286-done@bugs.debian.org, 94618-done@bugs.debian.org,
95823-done@bugs.debian.org, 97364-done@bugs.debian.org,
97520-done@bugs.debian.org, 97520-done@bugs.debian.org,
97809-done@bugs.debian.org, 98272-done@bugs.debian.org,
98353-done@bugs.debian.org, 98468-done@bugs.debian.org,
98695-done@bugs.debian.org, 98928-done@bugs.debian.org,
99671-done@bugs.debian.org, 99974-done@bugs.debian.org,
100046-done@bugs.debian.org, 100325-done@bugs.debian.org,
100590-done@bugs.debian.org, 101071-done@bugs.debian.org,
101565-done@bugs.debian.org, 102293-done@bugs.debian.org,
102421-done@bugs.debian.org, 102867-done@bugs.debian.org,
102951-done@bugs.debian.org, 103020-done@bugs.debian.org,
105377-done@bugs.debian.org, 105606-done@bugs.debian.org,
106591-done@bugs.debian.org, 106911-done@bugs.debian.org,
106914-done@bugs.debian.org, 107362-done@bugs.debian.org,
107362-done@bugs.debian.org, 107395-done@bugs.debian.org,
107395-done@bugs.debian.org, 108968-done@bugs.debian.org
Subject: Fixed in apt 0.5.4
Message-ID: <Pine.LNX.3.96.1010820224454.12485A-100000@wakko.deltatee.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Delivered-To: 90027-done@bugs.debian.org
apt (0.5.4) unstable; urgency=low
* M68k config.guess patch. Closes: #88913
* Bi-yearly test on OpenBSD and Solaris
* Doc updates. Closes: #89121, #89854, #99671, #98353, #95823, #93057,
#97520, #102867, #101071, #102421, #101565, #98272, #106914,
#105606, #105377
* Various cosmetic code updates. Closes: #89066, #89066, #89152
* Add "pre-auto" as an option for DSelect::Clean (run autoclean after
update).
* More patches from Alfredo for Vendors and more SHA-1 stuff
* Fix for AJ's 'desire to remove perl-5.005' and possibly other
similar situations. Closes: #56708, #59432
* no_proxy and ftp. Closes: #89671
* Philippe Batailler's man page patches.
* Fix for display bug. Closes: #92033, #93652, #98468
* Use more than 16bits for the dep ID. Some people ran out..
Closes: #103020, #97809, #102951, #99974, #107362, #107395, #107362,
#106911, #107395, #108968
* Reordered some things to make dante and FTP happier. Closes: #92757
* James R. Van Zandt's guide.sgml updates. Closes: #90027
* apt-ftparchive copes with no uncompressed package files + contents.
* French man pages from philippe batailler - well sort of. They
don't build yet..
* run-parts. Closes: #94286
* 'apt-cache policy' preferences debug tool.
* Whatever. Closes: #89762
* libstdc++ and HURD. Closes: #92025
* More apt-utils verbage. Closes: #86954
* Fliped comparision operator. Closes: #94618
* Used the right copyright file. Closes: #65691
* Randolph's G++3 patches.
* Fixed no_proxy tokanizing. Closes: #100046
* Strip Config-Version when copying status to available. Closes: #97520
* Segfault with missing source files. Closes: #100325
* EINTR check. Closes: #102293
* Various changes to the locking metholodgy for --print-uris.
Closes: #100590
* Lame LD_LIBRARY_PATH thing. Closes: #98928
* apt-cache search searchs provide names too now. Closes: #98695
* Checksum and long lines problem. Closes: #106591
* .aptignr and empty files are just a warning. Closes: #97364
Reply to: