Bug#54824: marked as done (man pages omit information)
Your message dated Thu, 13 Jan 2000 20:05:41 -0700 (MST)
with message-id <[🔎] Pine.LNX.3.96.1000113200523.7965E-100000@wakko.deltatee.com>
and subject line Bug#54824: man pages omit information
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; 11 Jan 2000 23:30:57 +0000
Received: (qmail 9572 invoked by alias); 11 Jan 2000 23:30:57 -0000
Delivered-To: bugs@debian.org
Received: (qmail 9557 invoked from network); 11 Jan 2000 23:30:57 -0000
Received: from smtp7.atl.mindspring.net (207.69.128.51)
by master.debian.org with SMTP; 11 Jan 2000 23:30:57 -0000
Received: from wheat (user-33qtg2c.dialup.mindspring.com [199.174.192.76])
by smtp7.atl.mindspring.net (8.9.3/8.8.5) with SMTP id SAA01637
for <bugs@debian.org>; Tue, 11 Jan 2000 18:30:55 -0500 (EST)
Message-Id: <[🔎] 3.0.5.32.20000111150609.019f7c70@pop.mindspring.com>
X-Sender: rboylan@pop.mindspring.com
X-Mailer: QUALCOMM Windows Eudora Light Version 3.0.5 (32)
Date: Tue, 11 Jan 2000 15:06:09 -0800
To: bugs@debian.org
From: Ross Boylan <RossBoylan@stanfordalumni.org>
Subject: man pages omit information
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Package: apt
Version: Debian 2.1 (slink) man pages
apt.conf(5) refers to apt-get(8), apt-cache(8), and apt-cdrom(8) for
further information. They refer back to apt.conf, so it seems nobody has
the information.
For example, apt.conf, "The Apt Group," subhead "get" says to see
apt-get(8) for information about the options. apt-get, under "OPTIONS" for
-d says "See APT::Get::Download-Only"
Now maybe this is just a question of wording--that is, apt-get(8) includes
all relevant information about how those options work. Even if this is so,
I think the section (8) pages need two things:
1) They need to say "This man page contains entries like APT::xxx::yyy.
This notation refers to section in the apt.conf(5) file, which describes
the meaning of this syntax more fully." My concern here is that "See
APT::..." is a meaningless cross-reference for someone who hasn't looked at
apt.conf.
2) Use a phrase such as "The corresponding apt.conf entry is
APT::Get::Download-Only" in the individual item entries. This clarifies
that apt.conf offers no additional information about how those options work
(if that is the case). I can't really tell from the current docs what the
correct syntax is. Is it
APT::Get::Download-Only ;
or APT::Get::Download-Only "true" ;
Finally, as wishlist item, I think the apt.conf page should have a
complete, self-contained description of the options.
---------------------------------------
Received: (at 54824-done) by bugs.debian.org; 14 Jan 2000 03:05:30 +0000
Received: (qmail 18532 invoked from network); 14 Jan 2000 03:05:29 -0000
Received: from crash.ab.videon.ca (root@206.75.216.220)
by master.debian.org with SMTP; 14 Jan 2000 03:05:29 -0000
Received: from wakko.deltatee.com (mail@wakko.powersurfr.com [24.108.53.97])
by crash.ab.videon.ca (8.9.2/8.9.2) with ESMTP id UAA09586;
Thu, 13 Jan 2000 20:05:22 -0700 (MST)
Received: from localhost (wakko.deltatee.com) [127.0.0.1] (jgg)
by wakko.deltatee.com with smtp (Exim 2.11 #1)
id 128x3V-0002BU-00 (Debian); Thu, 13 Jan 2000 20:05:41 -0700
Date: Thu, 13 Jan 2000 20:05:41 -0700 (MST)
From: Jason Gunthorpe <jgg@ualberta.ca>
X-Sender: jgg@wakko.deltatee.com
To: Ross Boylan <RossBoylan@stanfordalumni.org>, 54824-done@bugs.debian.org
cc: APT Development Team <deity@lists.debian.org>
Subject: Re: Bug#54824: man pages omit information
In-Reply-To: <[🔎] 3.0.5.32.20000111150609.019f7c70@pop.mindspring.com>
Message-ID: <[🔎] Pine.LNX.3.96.1000113200523.7965E-100000@wakko.deltatee.com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
On Tue, 11 Jan 2000, Ross Boylan wrote:
> apt.conf(5) refers to apt-get(8), apt-cache(8), and apt-cdrom(8) for
> further information. They refer back to apt.conf, so it seems nobody has
> the information.
This is clarified in the potato version.
Jason
Reply to: