On Sun, Jun 13, 2010 at 3:44 PM, Nico Schottelius <nico-pacman-dev@schottelius.org> wrote:
Seems --inline to git send-email wasn't the right then :-/
Ah well, maybe it's just gmail that does not support these inline mails. But if you don't use any arguments, it should work fine by default.
+Examples +-------- + +pacman -Syu:: + Update package list and upgrade all packages afterwards. +
Yeah this is typically the important commands that are not obvious when just quickly browsing the man page. But as I said, it's already covered in the wiki : http://wiki.archlinux.org/index.php/Pacman#Upgrading_packages
Understood. I'm probably stopping my effort right here, if it's agreed that the wiki is the primary documentation for pacman.
I'm probably thinking in different context than the typical archlinux-dev, for me it's important software can be re-used at other places and thus I don't think putting "how to get used to tool x" information into a distribution wiki is a great idea.
But again, it may be that my thinking way is not compatible to what you prefer here.
Well we try to keep pacman/makepkg as general as possible and avoid distrib specific bits. So it can be re-used on other systems. But the project is still developed by ArchLinux developers for ArchLinux and all resources are hosted on archlinux.org All resources on archlinux.org are available from any systems, fortunately the web is standard enough for that :) Anyway I have nothing against your proposal, I think it's fine, and it's not my call anyway. There is another question : if we want to extend these EXAMPLES section with more stuff from http://wiki.archlinux.org/index.php/Pacman (and maybe http://wiki.archlinux.org/index.php/Pacman_Tips ?), should we put everything in the same man page, or make separate pages ?