[pkgsrc/trunk]: pkgsrc/pkgtools/pkg_rolling-replace/files Use more markup. Ne...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/75cd758797ca
branches:  trunk
changeset: 522239:75cd758797ca
user:      wiz <wiz%pkgsrc.org@localhost>
date:      Wed Dec 06 10:41:29 2006 +0000

description:
Use more markup. New sentence, new line. Various minor improvements.

diffstat:

 pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8 |  65 ++++++++++-----
 1 files changed, 41 insertions(+), 24 deletions(-)

diffs (119 lines):

diff -r a546ba52f88f -r 75cd758797ca pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8
--- a/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8  Wed Dec 06 10:36:42 2006 +0000
+++ b/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8  Wed Dec 06 10:41:29 2006 +0000
@@ -1,37 +1,49 @@
-.\" $NetBSD: pkg_rolling-replace.8,v 1.1.1.1 2006/12/05 18:23:52 gdt Exp $
+.\" $NetBSD: pkg_rolling-replace.8,v 1.2 2006/12/06 10:41:29 wiz Exp $
 .Dd August 7, 2006
 .Dt PKG_ROLLING-REPLACE 8
+.Os
 .Sh NAME
 .Nm pkg_rolling-replace
 .Nd rebuild or update packages using 'make replace' in tsorted order
 .Sh SYNOPSIS
 .Nm
-.Op Fl hnuvx
+.Op Fl hnuv
 .Op Fl x Ar pkgs
 .Sh DESCRIPTION
 .Nm
-runs 'make replace' on packages that have been marked with the
- 'unsafe_depends=YES' flag or the 'rebuild=YES' flag, optionally
-replacing any outdated packages (as reported by
+runs
+.Dq make replace
+on packages that have been marked with the
+.Dq unsafe_depends=YES
+flag or the
+.Dq rebuild=YES
+flag, optionally replacing any outdated packages (as reported by
 .Xr pkg_chk 8 )
 as well.
 .Pp
-Whenever 'make replace' is run on a package, all installed packages
-that depend on it are marked with the 'unsafe_depends=YES' flag, which
-indicates that they may no longer be ABI-compatible with the replaced
-package.  Running
+Whenever
+.Dq make replace
+is run on a package, all installed packages
+that depend on it are marked with the
+.Dq unsafe_depends=YES
+flag, which indicates that they may no longer be ABI-compatible
+with the replaced package.
+Running
 .Nm
 with no arguments will restore such packages to a safe state by
 building a dependency graph, running
 .Xr tsort 1
-on it, and running 'make replace' in the resulting topological order.
+on it, and running
+.Dq make replace
+in the resulting topological order.
 The dependency graph and topological sort are re-calculated after each
-'make replace', in case it causes additional
-packages to be marked unsafe.
+.Dq make replace ,
+in case it causes additional packages to be marked unsafe.
 .Pp
 The user can mark additional packages to be rebuilt by setting the
- 'rebuild=YES' flag on them using the command 
-.Dl % pkg_admin set rebuild=YES <pkg>
+.Dq rebuild=YES
+flag on them using the command
+.Dl % pkg_admin set rebuild=YES Aq pkg
 .Pp
 If the
 .Fl u
@@ -40,21 +52,24 @@
 will use
 .Xl pkg_chk 8
 to check for packages for which the version in pkgsrc is different
-than the installed version, and run 'make replace' on those packages
-as well (tsorting them along with the unsafe/rebuild packages).
+than the installed version, and run
+.Dq make replace
+on those packages as well (tsorting them along with the unsafe/rebuild
+packages).
 (Usually this results in packages being upgraded to newer versions,
 assuming the pkgsrc tree is more recent than the currently installed
 packages.)
-.Pp
 .Ss Options
 .Bl -tag -width xxxxxxxx
 .It Fl h
 Brief help.
 .It Fl n
-Display actions that would be taken, but don't actually run 'make
-replace' or change any flags on installed packages.  This option
-attempts to calculate the new packages that would be marked unsafe
-after each 'make replace'.
+Display actions that would be taken, but don't actually run
+.Dq make replace
+or change any flags on installed packages.
+This option attempts to calculate the new packages that would be
+marked unsafe after each
+.Dq make replace .
 .It Fl u
 Use
 .Xl pkg_chk 8
@@ -72,14 +87,16 @@
 uses the following environment variables.
 .Bl -tag -width xxxx
 .It Ev PKGSRCDIR
-Base of pkgsrc tree.  Defaults to
-.Pa /usr/pkgsrc
+Base of pkgsrc tree.
+Defaults to
+.Pa /usr/pkgsrc .
 .It Ev PKG_DBDIR
 pkgsrc database directory.
 If not set in environment then defaults to
-.Pa /var/db/pkg
+.Pa /var/db/pkg .
 .El
 .Sh AUTHORS
+.An -nosplit
 .An Nick Goffee
 .Aq ngoffee%bbn.com@localhost ,
 with initial idea and many suggestions from