RPM

Comment 11 for bug 633656

Revision history for this message
In , Denys (denys-redhat-bugs) wrote :

Ok, let's put popt discussion aside.

What is your position on the other part of my proposal: to start rpm --help text with "Operation modes" section and then describe allowable options for each section? (I am repeating the example below):

Usage: rpm [OPTION...] [PARAM...]

 *** first we let user know which modes exist and what they do: ***

Operation modes (one of these options must be present to select the operation):
  -q,--query Query database of installed packages
  -V,--verify ...
  -i,--install Install package(s)
  -e,--erase Erase (remove) installed package(s)
  -U,--update ...
  ...
  ...
  --initdb Initialize database
  --rebuilddb Rebuild database inverted lists from
                   installed package headers

 *** then we go deeper into options for each mode (or group of modes with similar options), starting from the most used ones: ***

Query options (with -q or --query):
  ...

Query/Verify package selection options:
  ...

Install/Upgrade/Erase options (with -i, -U, or -e):
        *** current --help doesn't mention -i, -U, -e in the above line, I
propose adding it ***
  --aid add suggested packages to transaction
  ...
  ...

Signature options (with -??, -?? or -??):
        *** similarly, here above i'd like to see mode options for which the
below "modifier" options are valid ***
  ...

Common options for all rpm modes and executables:
  ...