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:
...
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):
installed package headers
-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
*** 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:
...