Index: en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
@@ -3539,7 +3539,7 @@
If the port anchors its man tree somewhere other than
PREFIX, use
MANDIRS to specify those directories. Note
- that the files corresponding to manual pages must be be placed in
+ that the files corresponding to manual pages must be placed in
pkg-plist along with the rest of the files.
The purpose of MANDIRS is to enable automatic
compression of manual pages, therefore the file names are
@@ -4382,6 +4382,14 @@
+
+ Some variables are not in this list, in particular
+ PKGNAMEPREFIX and
+ PKGNAMESUFFIX. This is intentional. A
+ port must not change its name when
+ its option set changes.
+
+
Some of these variables, at least
ALL_TARGET and
@@ -4481,7 +4489,7 @@
directory, foo-1.0, and the rest of the
files are located under that directory.
- A number of variables can overriden if that is
+ A number of variables can be overridden if that is
not the case.
@@ -4591,12 +4599,14 @@
targets. Set ownership directly in
pkg-plist with the corresponding entries,
such as
- @owner owner and
+ @(owner,group,),
+ @owner owner, and
@group group.
- These operators work until being overridden, or until the end
+ These operators work until overridden, or until the end
of pkg-plist, so do not forget to reset
them after they are no longer needed. The default ownership
- is root:wheel.
+ is root:wheel. See for more information.
@@ -4634,31 +4644,31 @@
- These are the install
- command with all the appropriate flags.
+ These variables are set to the &man.install.1; command
+ with the appropriate flags for each situation.
-
+
Do not use INSTALL_LIB to install
- static libraries, because stripping them render them
+ static libraries, because stripping them renders them
useless. Use INSTALL_DATA
instead.
-
+
Stripping Binaries and Shared Libraries
Installed binaries should be stripped. Do not strip
- binaries manually unless forced to. The
- INSTALL_PROGRAM macro will install and
- strip a binary at the same time (see the next section). The
+ binaries manually unless absolutely required. The
+ INSTALL_PROGRAM macro installs and
+ strips a binary at the same time. The
INSTALL_LIB macro does the same thing to
shared libraries.
When a file must be stripped, but neither
INSTALL_PROGRAM nor
INSTALL_LIB macros are desirable,
- ${STRIP_CMD} will strip the program or
+ ${STRIP_CMD} strips the program or
shared library. This is typically done within the
post-install target. For
example: