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

[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.
> +
> +pacman -Scc::
> +	Remove *all* packages from cache (-Sc removes only uninstalled ones).

The -Sc description is kind of wrong (think KeepCurrent), so it should 
just be removed.

> +
>   Configuration
>   -------------
>   See linkman:pacman.conf[5] for more details on configuring pacman using the