[pacman-dev] [PATCH] doc: add man page for pacman-conf

Eli Schwartz eschwartz at archlinux.org
Wed Feb 20 07:57:52 UTC 2019

On 2/20/19 2:43 AM, Allan McRae wrote:
> On 20/2/19 5:35 pm, Eli Schwartz wrote:
>>> +Examples
>>> +--------
>>> +
>>> +pacman-conf -r core Usage::
>>> +	Show the value of the Usage configuration option for core repository.
>>> +
>>> +pacman-conf HoldPkg::
>>> +	Show the value of the HoldPkg configuration option.
>> I'm hesitant to have an Examples section, for the simple fact that if it
>> is needed in order to let users understand how to use the program, then
>> the Description section has probably already failed.
> Like the pacman man page!

I'm not necessarily saying ditch the examples section -- but its
presence made it fairly noticeable that the rest of the page did not
describe how pacman-conf's directive parameter functions (nor indeed
that without it, it will flatten the configuration and return all of it
for you).

OTOH maybe we could go wild and delete stuff from the pacman manpage
too... who doesn't like deleting things...

Eli Schwartz
Bug Wrangler and Trusted User

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 1601 bytes
Desc: OpenPGP digital signature
URL: <https://lists.archlinux.org/pipermail/pacman-dev/attachments/20190220/9f1c8bd6/attachment.sig>

More information about the pacman-dev mailing list