[pacman-dev] [PATCH 1/2] add two entries to pacman manpage examples section

[Xavier Chantry]

On Sun, Jun 13, 2010 at 3:44 PM, Nico Schottelius
<nico-pacman-dev at 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 ?