Your message dated Thu, 20 Oct 2011 08:47:19 +0000
with message-id <[email protected]>
and subject line Bug#325169: fixed in dctrl-tools 2.19
has caused the Debian Bug report #325169,
regarding grep-dctrl: Man page improvements
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 this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
325169: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=325169
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: grep-dctrl
Version: 2.6.7
Severity: wishlist
Hi,
Looking at the man page for grep-dctrl, it appears to me that
the plethora of lines in the synopsis section (8) obscures the fact
that we are talking about a suite of tools with similar calling
patterns, that operate in two modes:
a) informational; where you get information about the program
itself, and is invoked with these options:
/command/ --copying|-C | --help|-h | --version|-V
Note the grouping, which should make it more obvious that
-C == --copying, and so on
b) operational, where the calling pattern is
/command/ [options] predicate [ file ... ]
Command can be one of
grep-dctrl, grep-status, grep-available, or grep-aptavail.
It would also be nice to point out early that these programs
are aliases to grep-dctrl, but just act on different data sources:
grep-status looks at the DPKG status file (which looks at packages
installed on the system, currently or in the past)
grep-available looks at the DPKG available file (which looks at
packages available, essentially all packages in repositories
that are listed in /etc/apt/sources.list)
grep-aptavail looks at the ....
grep-dctrl is the actual command.
Indeed, looking at what I have written, I think the synopsis
should *NOT* list all 8 variants. It should say
a) ....
grep-dctrl --copying|-C | --help|-h | --version|-V
b) ....
grep-dctrl [options] predicate [ file ... ]
and then mention that
grep-status [args] == grep-dctrl [args] status
grep-available [args] == grep-dctrl [args] available
grep-aptavail [args] == grep-dctrl [args] ????
Those 8 synopsis lines obscure the fact that there is just one
command, and three shortcuts, and one needs only learn one set of
syntax, which makes the man page far less intimidating. One can make
things obscure by too much verbiage.
Secondly, the term predicate is a precise logic term, but is
perhaps not as accessible to the common user (think grandma) as the
term filter, and indeed, these predicates to tend to select and
modify (in other words, filter) the results. Also, Disjunct and
Conjunct are scary. Look at how man perlop explains operators
similar to these with words less scary to non CS people.
It would help if the description also is separated out to
discuss options, filtering expressions and operators for these
expressions, and files, in separate paragraphs;
---------------------------------------------------------------------
The options are divided into those that affect filtering results,
those that affect output formatting, and others.
---------------------------------------------------------------------
---------------------------------------------------------------------
Filtering expressions can be negated and/or combined in any fashion,
and you can specify how the filtering expressions are aggregated.
----------------------------------------------------------------------
======================================================================
You must give a search predicate on the command line ==>
You must give a filter (search predicate) on the command line.
======================================================================
And so on.
Atomic predicate modifiers ==> filter terms/ expression
Predicate connectives ==> operators??
manoj
running out of steam
-- System Information:
Debian Release: testing/unstable
APT prefers unstable
APT policy: (500, 'unstable'), (500, 'stable')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.12.2-skas3-v9-pre4
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Versions of packages grep-dctrl depends on:
ii libc6 2.3.5-4 GNU C Library: Shared libraries an
grep-dctrl recommends no packages.
-- no debconf information
--
Death is nature's way of saying `Howdy'.
Manoj Srivastava <[email protected]> <http://www.golden-gryphon.com/>
1024D/BF24424C print 4966 F272 D093 B493 410B 924B 21BA DABB BF24 424C
--- End Message ---
--- Begin Message ---
Source: dctrl-tools
Source-Version: 2.19
We believe that the bug you reported is fixed in the latest version of
dctrl-tools, which is due to be installed in the Debian FTP archive:
dctrl-tools_2.19.dsc
to main/d/dctrl-tools/dctrl-tools_2.19.dsc
dctrl-tools_2.19.tar.gz
to main/d/dctrl-tools/dctrl-tools_2.19.tar.gz
dctrl-tools_2.19_amd64.deb
to main/d/dctrl-tools/dctrl-tools_2.19_amd64.deb
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to [email protected],
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Antti-Juhani Kaijanaho <[email protected]> (supplier of updated dctrl-tools
package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [email protected])
-----BEGIN PGP SIGNED MESSAGE-----
Hash: RIPEMD160
Format: 1.8
Date: Thu, 20 Oct 2011 09:56:38 +0300
Source: dctrl-tools
Binary: dctrl-tools
Architecture: source amd64
Version: 2.19
Distribution: unstable
Urgency: low
Maintainer: dctrl-tools developers <[email protected]>
Changed-By: Antti-Juhani Kaijanaho <[email protected]>
Description:
dctrl-tools - Command-line tools to process Debian package information
Closes: 209134 325169 525525 589827 615877 624707 628013
Changes:
dctrl-tools (2.19) unstable; urgency=low
.
[ David Prévot ]
* Stylish fix to grep-dctrl(1) manpage (closes: #325169)
* Makes manpages translatable (using po4a), closes: #615877
* Fix example in manpage (closes: #589827)
* Update French runtime translation (closes: #628013)
* Initial French manpages translation
.
[ Antti-Juhani Kaijanaho ]
* Merge 2.18ubuntu1
* debian/control [Standards-Version]: Updated to 3.6.2 (no changes needed).
* grep-dctrl/grep-dctrl.c: Output a stanza separator unconditionally.
Closes: #525525 (do not separate stanzas with empty lines when showing
Description field only)
[Reported by Stefano Zacchiroli <[email protected]>]
* lib/paragraph.[ch], grep-dctrl/grep-dctrl.c: Use the actual spelling of
field names in output, instead of the command line spelling.
Closes: #209134 (keyword case shouldn't be influenced by -s)
Reported by Dan Jacobson <[email protected]>.
* grep-dctrl/grep-dctrl.c: Clean up some dead code.
* grep-dctrl: Rewrite predicate code to use a tree instead of a bytecode.
.
dctrl-tools (2.18ubuntu1) oneiric; urgency=low
.
* lib/msg.h, grep-dctrl/rc.c, join-dctrl/join-dctrl.c: Pass the arguments to
message() in the right order (fixes FTBFS; lp: #774391, Closes: #624707)
Checksums-Sha1:
61bbfacef7ec2df2a47b8ec5331cecc46fd6e64e 1051 dctrl-tools_2.19.dsc
fb1ef7aa8e8bb6c23d0c44aa64bbff3ff446bd6a 3368661 dctrl-tools_2.19.tar.gz
8efed20d68ff2944aee768923e80d2d5e741ea80 151392 dctrl-tools_2.19_amd64.deb
Checksums-Sha256:
7585224959a788aed6995e530fdad04a304d40a15754d728e950d8247ef82487 1051
dctrl-tools_2.19.dsc
59a280c8ceae21816ba43994e8784c4bb1061960e8fb876dd7bd3a9146bb1410 3368661
dctrl-tools_2.19.tar.gz
903bcd55da211b28d83aec0d703aebbc9b944c2d88492dd950fe9e3a6450275c 151392
dctrl-tools_2.19_amd64.deb
Files:
f2e626aae44d0caec210735621ff4565 1051 utils optional dctrl-tools_2.19.dsc
d1906b55fb2da3b7677669f9bd8ea64b 3368661 utils optional dctrl-tools_2.19.tar.gz
78550da21f65ad0131b17139d30415d8 151392 utils optional
dctrl-tools_2.19_amd64.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
iEYEAREDAAYFAk6f2HkACgkQHsI32VNFhOgFpACggVHO+yktAHXFd0MYpGoTrDgi
wJwAoJem1JonIjWKN7Xlq/xJ2yBOCC0J
=NPlI
-----END PGP SIGNATURE-----
--- End Message ---
