[pkgsrc/trunk]: pkgsrc/pkgtools/pkg_rolling-replace/files Add an EXAMPLES sec...

[tnn <tnn%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/e5aaeeb98585
branches:  trunk
changeset: 539668:e5aaeeb98585
user:      tnn <tnn%pkgsrc.org@localhost>
date:      Tue Mar 11 01:53:05 2008 +0000

description:
Add an EXAMPLES section.

diffstat:

 pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8 |  21 ++++++++++++++-
 1 files changed, 19 insertions(+), 2 deletions(-)

diffs (35 lines):

diff -r 7533d001dca2 -r e5aaeeb98585 pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8
--- a/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8  Tue Mar 11 01:28:55 2008 +0000
+++ b/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8  Tue Mar 11 01:53:05 2008 +0000
@@ -1,5 +1,5 @@
-.\" $NetBSD: pkg_rolling-replace.8,v 1.9 2008/02/17 10:47:47 apb Exp $
-.Dd February 17, 2008
+.\" $NetBSD: pkg_rolling-replace.8,v 1.10 2008/03/11 01:53:05 tnn Exp $
+.Dd March 11, 2008
 .Dt PKG_ROLLING-REPLACE 8
 .Os
 .Sh NAME
@@ -111,6 +111,23 @@
 Exclude the comma-separated list of package base names
 from being rebuilt for any reason.
 .El
+.Sh EXAMPLES
+.Pp
+To update all packages on the system and ensure correct shared library dependencies:
+.Bd -literal -offset indent
+pkg_rolling-replace -rsuv
+.Ed
+.Pp
+To update all packages on the system, do as little rebuilding as possible, and also produce binary packages:
+.Bd -literal -offset indent
+pkg_rolling-replace -uv
+.Ed
+.Pp
+To update gtk2+ and all packages that depend on it, except openoffice2:
+.Bd -literal -offset indent
+pkg_admin set rebuild=YES gtk2+
+pkg_rolling-replace -rsv -X openoffice2
+.Ed
 .Sh ENVIRONMENT
 .Nm
 uses the following environment variables.