[pacman-dev] [PATCH 3/3] manpage: add real world examples

[Matthias Gorissen]

  Am 01.07.2010 03:21, schrieb Allan McRae:
> On 01/07/10 06:23, Xavier Chantry wrote:
>> From: Nico Schottelius<nico at kr.ethz.ch>
>>
>> Signed-off-by: Nico Schottelius<nico at kr.ethz.ch>
>> Signed-off-by: Xavier Chantry<chantry.xavier at gmail.com>
>> ---
>
> I like these examples.  A couple of small changes and you get a 
> Signed-off-by: Allan
>
>
>>   doc/pacman.8.txt |   22 ++++++++++++++++++++++
>>   1 files changed, 22 insertions(+), 0 deletions(-)
>>
>> diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt
>> index 3d14a42..e66e25c 100644
>> --- a/doc/pacman.8.txt
>> +++ b/doc/pacman.8.txt
>> @@ -415,6 +415,28 @@ original=X, current=Y, new=Z::
>>       necessary changes into the original file.
>>
>>
>> +Examples
>> +--------
>> +
>> +pacman -Ss ne.hack::
>> +    Search for regexp "ne.hack" in package database.
>> +
>> +pacman -S gpm::
>> +    Download and install gpm including dependencies.
>> +
>> +pacman -U /home/nico/ceofhack-0.6-1-x86_64.pkg.tar.gz::
>
> Generalize to /home/user/
>
>> +    Install ceofhack from a package file (as genererated by PKGBUILD 
>> from AUR).
>
> We should not be mentioning the AUR.   How about:
> Install ceofhack-0.6-1 package from a local file.
>
>> +
>> +pacman -Syu::
>> +    Update package list and upgrade all packages afterwards.
>> +
>> +pacman -Syu gpm::
>> +    Update package list, upgrade all packages, and then install or 
>> upgrade gpm.
This should read "and then install gpm", or "and then install gpm 
additionally". If gpm was previously installed, it should be up-to-date 
after an -Syu - you cannot upgrade any further atm, you can only install 
new packages.