Tue Mar 11 01:53:05 2008 UTC ()
Add an EXAMPLES section.


(tnn)
diff -r1.9 -r1.10 pkgsrc/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8
cvs diff -r1.9 -r1.10 pkgsrc/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8 (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8 2008/02/17 10:47:47 1.9
+++ pkgsrc/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8 2008/03/11 01:53:05 1.10
@@ -1,15 +1,15 @@ @@ -1,15 +1,15 @@
1.\" $NetBSD: pkg_rolling-replace.8,v 1.9 2008/02/17 10:47:47 apb Exp $ 1.\" $NetBSD: pkg_rolling-replace.8,v 1.10 2008/03/11 01:53:05 tnn Exp $
2.Dd February 17, 2008 2.Dd March 11, 2008
3.Dt PKG_ROLLING-REPLACE 8 3.Dt PKG_ROLLING-REPLACE 8
4.Os 4.Os
5.Sh NAME 5.Sh NAME
6.Nm pkg_rolling-replace 6.Nm pkg_rolling-replace
7.Nd rebuild or update packages using 'make replace' in tsorted order 7.Nd rebuild or update packages using 'make replace' in tsorted order
8.Sh SYNOPSIS 8.Sh SYNOPSIS
9.Nm 9.Nm
10.Op Fl hnrsuv 10.Op Fl hnrsuv
11.Op Fl x Ar pkgs 11.Op Fl x Ar pkgs
12.Op Fl X Ar pkgs 12.Op Fl X Ar pkgs
13.Sh DESCRIPTION 13.Sh DESCRIPTION
14.Nm 14.Nm
15runs 15runs
@@ -101,26 +101,43 @@ and does not prevent packages from being @@ -101,26 +101,43 @@ and does not prevent packages from being
101(such as being a dependency of another package that is also rebuilt, 101(such as being a dependency of another package that is also rebuilt,
102or having any of the 102or having any of the
103.Xr pkg_admin 8 103.Xr pkg_admin 8
104.Dq unsafe_depends , 104.Dq unsafe_depends ,
105.Dq unsafe_depends_strict , 105.Dq unsafe_depends_strict ,
106or 106or
107.Dq rebuild 107.Dq rebuild
108variables set to 108variables set to
109.Dq YES ) . 109.Dq YES ) .
110.It Fl X Ar pkgs 110.It Fl X Ar pkgs
111Exclude the comma-separated list of package base names 111Exclude the comma-separated list of package base names
112from being rebuilt for any reason. 112from being rebuilt for any reason.
113.El 113.El
 114.Sh EXAMPLES
 115.Pp
 116To update all packages on the system and ensure correct shared library dependencies:
 117.Bd -literal -offset indent
 118pkg_rolling-replace -rsuv
 119.Ed
 120.Pp
 121To update all packages on the system, do as little rebuilding as possible, and also produce binary packages:
 122.Bd -literal -offset indent
 123pkg_rolling-replace -uv
 124.Ed
 125.Pp
 126To update gtk2+ and all packages that depend on it, except openoffice2:
 127.Bd -literal -offset indent
 128pkg_admin set rebuild=YES gtk2+
 129pkg_rolling-replace -rsv -X openoffice2
 130.Ed
114.Sh ENVIRONMENT 131.Sh ENVIRONMENT
115.Nm 132.Nm
116uses the following environment variables. 133uses the following environment variables.
117.Bl -tag -width xxxx 134.Bl -tag -width xxxx
118.It Ev MAKECONF 135.It Ev MAKECONF
119Path to 136Path to
120.Pa mk.conf . 137.Pa mk.conf .
121Defaults to 138Defaults to
122.Pa /etc/mk.conf 139.Pa /etc/mk.conf
123or 140or
124.Pa ${PREFIX}/etc/mk.conf 141.Pa ${PREFIX}/etc/mk.conf
125(if using bmake). 142(if using bmake).
126.It Ev PKGSRCDIR 143.It Ev PKGSRCDIR