Hi,
I found the wording in ports.7 awkward in a few places,
which this patch aims to fix. Besides that, there's
a few small punctuation changes.
I've tried to only touch low-hanging fruit to avoid any
bikeshedding, but if you think any change is too subjective
just let me know.
Regards,
Michael
Index: src/share/man/man7/ports.7
===================================================================
RCS file: /cvs/src/share/man/man7/ports.7,v
retrieving revision 1.103
diff -u -p -r1.103 ports.7
--- src/share/man/man7/ports.7 24 Aug 2015 12:57:14 -0000 1.103
+++ src/share/man/man7/ports.7 21 Sep 2015 20:40:20 -0000
@@ -140,8 +140,7 @@ apply.
.Sh TARGETS
Individual ports are controlled through a few documented targets.
Some of these targets work recursively through subdirectories, so that
-someone can, for example, install all of the net
-ports.
+someone can, for example, install all of the net ports.
.Pp
The variable
.Ev SKIPDIR
@@ -429,7 +428,8 @@ This shows up as undefined references in
is no choice but to proceed the old way: deinstall the offending package
and everything built on top of it, build and install new packages.
.Sh BULK PACKAGE BUILDING
-Building any significant number of packages from the ports tree should use
+Building any significant number of packages from the ports tree should be done
+with
.Xr dpb 1 ,
a tool located inside the ports tree proper
.Po
@@ -439,7 +439,7 @@ normally as
In particular, it can take advantage of machine clusters (same architecture
and same installation), and of multi-core machines.
.Pp
-A few remarks may save a lot of time
+A few remarks may save a lot of time:
.Bl -bullet
.It
The default limits in
@@ -451,7 +451,7 @@ For instance, a lot of C++-based ports w
.Ar datasize
over 1G.
.It
-cluster builds should have shared
+Cluster builds should have shared
.Ev PORTSDIR
and local
.Ev WRKOBJDIR .
@@ -461,10 +461,10 @@ partitions mounted
.Sq noatime,async
will help.
.It
-as far as possible, the log directory should be local to the machine running
+As far as possible, the log directory should be local to the machine running
.Xr dpb 1 .
.It
-a full bulk will fetch over 20G of distfiles, create over 17G of packages.
+A full bulk will fetch over 20G of distfiles and create over 17G of packages.
The largest work directories are about 10G each.
.It
Take notice of
@@ -634,7 +634,7 @@ Location of the ports tree
.Pa /usr/ports ) .
.It Ev DISTDIR
Where to find/put distfiles, normally
-.Pa ${PORTSDIR}/distfiles
+.Pa ${PORTSDIR}/distfiles .
.It Ev PACKAGE_REPOSITORY
Used only for the
.Cm package
