[pacman-dev] Examples in the manpages

[Xavier Chantry]

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.
http://wiki.archlinux.org/index.php/Pacman

So I am happy with how things are now, adding something has the risk
of causing more duplication and more work.