[pacman-dev] Examples in the manpages
chantry.xavier at gmail.com
Sun Jun 13 05:55:46 EDT 2010
On Sun, Jun 13, 2010 at 2:53 AM, Nico Schottelius
<nico-pacman-dev at schottelius.org> wrote:
> Dear pacman-devs,
> after a funny replace pacman-with-pacman-git evening, I digged
> around a bit into makepkg and pacman and noticed there are no
> examples in the manpages.
> Is that intented or would you like to/accept patches which add
> the EXAMPLES section?
I remember a discussion about this on irc a while ago.
I completely agree that EXAMPLES section is very nice, it's always the
first thing I look up in a man page of a new program, and I am
disappointed when I don't find any, and delighted when I find one :)
However, I was also wondering some times ago what the purpose of our
wiki page was. It seemed like a duplicate of our man pages, and thus
two places we needed to keep in sync and update.
Then I realized the wiki page was actually the EXAMPLES section we
don't have, it doesn't present options like in our man pages, it
presents them by examples.
So I am happy with how things are now, adding something has the risk
of causing more duplication and more work.
More information about the pacman-dev