On Sun, Jun 13, 2010 at 2:53 AM, Nico Schottelius <nico-pacman-dev@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.