Package: aptitude-doc-en
Version: 0.4.11.9-1
Severity: wishlist
File: /usr/share/doc/aptitude/html/en/ch02s03s05.html

     name
         Matches packages whose names match the regular expression name. This is
         the “default” search mode and is used for patterns that don't start 
with ~.

Say if these are bounded regexps, with invisible ^ and $ added at the
ends or not. E.g., dlocate -l and dpkg -l all do it their own way so
say what aptitude does please.

         [Note] Note
                To match packages whose names contain several different 
substrings,
                use the ?name term (described below); for instance, 
“?name(apti)?
                name(tude)”.

Looks complicated. Say what that matches and doesn't match.

    [Note] Note
           To include a “!” in a regular expression, it must be “escaped” to
           prevent aptitude from considering it part of a NOT term: “~!”.

That is a bit ambiguous. Better might be:

           To include a “!” in a regular expression, it must be
           “escaped” using “~!”, to prevent aptitude from considering
           it part of a NOT term.

Please do the same fix for:

    [Note] Note
           To use the character “|” in a regular expression...

           ?any-version(pattern)
           Matches a package if any one of its versions matches the enclosed 
term.

Here you say pattern, then say term.

           ?new, ~N
           Matches packages which are new.

OK, but give a link or say what you mean by "new".
Indeed, the aptitude man page doesn't define "new" either, and even
has this other kind of "new"!:
               The following NEW packages will be installed:
Therefore you have a lot of explaining to do on the man page.
And maybe new is a GUI users' thing, which I would hardly brush up
with as I currently only like the command line.

        For instance, ?vortial!?provides[1](?true[1])...

Spelling.

    For instance, “?conflicts(?maintainer([EMAIL PROTECTED]))” matches any
    package which conflicts with a package I maintain.

Better get all the personal references off the pages soon before you
become like me looking around for relevant wikis to move one's web
pages to while one still has brain cells left. Phew, just dumped
http://wiki.osgeo.org/wiki/Taiwan_datums as it all became foggy...

P.S.,
  $ COLUMNS=2222 man aptitude|grep 'even .* is set'|perl -pwe 's/.*(.{33})/$1/'
  Resolver::No-New-Upgrades is set.
  Resolver::No-New-Installs is set.
Say is set to what, true or false.
As you know with the shell, unset, set to null, set to something, are
all different.

P.S.S. In
Title: Configuration file reference
URL:   file:///usr/share/doc/aptitude/html/en/ch02s04s05.html
perhaps mention that "apt-config dump" will show all the current
value except those from ~/.aptitude I suppose.




--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to