[pacman-dev] [PATCH] manpage update: add real world examples with full path

[Nico Schottelius]

From: Nico Schottelius <nico at kr.ethz.ch>

Signed-off-by: Nico Schottelius <nico at kr.ethz.ch>
---
 doc/makepkg.8.txt |   18 ++++++++++++++++++
 doc/pacman.8.txt  |   19 +++++++++++++++++++
 2 files changed, 37 insertions(+), 0 deletions(-)

diff --git a/doc/makepkg.8.txt b/doc/makepkg.8.txt
index a2fdb3f..ca99419 100644
--- a/doc/makepkg.8.txt
+++ b/doc/makepkg.8.txt
@@ -187,6 +187,24 @@ Environment Variables
 	corresponding value defined in linkman:makepkg.conf[5].
 
 
+Examples
+--------
+To create a new package from scratch and let makepkg handle integrity checks:
+
+   $ mkdir mypkg
+   $ cd mypkg
+   $ cp /usr/share/pacman/PKGBUILD.proto PKGBUILD
+   # edit PKGBUILD to your needs
+   $ makepkg -g >> PKGBUILD
+   $ makepkg
+
+
+Files
+-----
+PKGBUILD::
+	Package build description file in the *current* directory.
+
+
 Configuration
 -------------
 See linkman:makepkg.conf[5] for more details on configuring makepkg using the
diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt
index 3d14a42..e0314dc 100644
--- a/doc/pacman.8.txt
+++ b/doc/pacman.8.txt
@@ -415,6 +415,25 @@ 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::
+	Install ceofhack from a package file (as genererated by PKGBUILD from AUR).
+
+pacman -Syu::
+	Update package list and upgrade all packages afterwards.
+
+pacman -Scc::
+	Remove *all* packages from cache (-Sc removes only uninstalled ones).
+
+
 Configuration
 -------------
 See linkman:pacman.conf[5] for more details on configuring pacman using the
-- 
1.7.1