On 3/14/22 15:23, John Reiser wrote:
On 3/14/22 12:23, Samuel Sieb wrote:
> On 3/14/22 09:34, John Reiser wrote:
>>> Just setting `deltarpm` to False in dnf.conf do the same. Just saying.
>> The deltarpm option has low discoverability. The information is
>> but the discovery chain is too long and not explicit enough.
>> The main configuration file /etc/dnf/dnf.conf does not list
>> each option, its default value, and perhaps a short comment.
>> The main configuration file does not reference "# See 'man 5
> Why wouldn't that be the first thing you tried anyway?
The first thing is to look at the manual page "man dnf", whose FILES
section points to the main configuration file /etc/dnf/dnf.conf.
Apparently you missed the "see also" section in the dnf man page:
• dnf.conf(5), DNF Configuration Reference
I expect dnf.conf to list all the options and their default values,
or if not, then to point to the documentation which does.
The manual page "man dnf" says nothing about deltarpm.
The default /etc/dnf/dnf.conf lists only a few options
with no individual documentation, and contains no explicit pointer
to more documentation. I expect better: all reasonable attempts
should lead quickly to the relevant documentation. This is the meaning
of "good discoverability". If I get anywhere close, then I should
find the answer or a direct pointer to the answer. Enable
multiple pathways (both the main manual page AND the configuration tile
should point to "man 5 dnf.conf") so as to reduce the number of steps.
Having the default values listed in the config file can be nice, but it
can also make it difficult to find changes. I certainly don't expect
the config file to point me at the man page. That seems rather
pointless. I do expect the man page to exist though.