Index: en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml
@@ -34,7 +34,7 @@
If make describe produces a string rather
- than an error message, you are probably safe. See
+ than an error message, everything is probably safe. See
bsd.port.mk for the meaning of the string
produced.
@@ -47,10 +47,10 @@
Portlint
- Do check your work with Do check the port with portlint
- before you submit or commit it. portlint
- warns you about many common errors, both functional and
+ before submitting or committing it. portlint
+ warns about many common errors, both functional and
stylistic. For a new (or repocopied) port,
portlint -A is the most thorough; for an
existing port, portlint -C is
@@ -71,14 +71,14 @@
program is part of the Ports Collection.port is the front-end script, which can
- help you simplify the testing job. Whenever you want to test a
- new port or update an existing one, you can use
- port test to test your port, including the
+ help simplify the testing job. Whenever a new port or an update
+ to existing one needs testing, use
+ port test to test the port, including the
portlint
checking. This command also detects and lists any files that
- are not listed in pkg-plist. See the
- following example:
+ are not listed in pkg-plist. For
+ example:
&prompt.root; port test /usr/ports/net/csup
@@ -90,7 +90,7 @@
PREFIX determines where the port will be
installed. It defaults to /usr/local, but
can be set by the user to a custom path like
- /opt. Your port must respect the value of
+ /opt. The port must respect the value of
this variable.DESTDIR, if set by the user, determines
@@ -100,7 +100,7 @@
DESTDIR/PREFIX, and register with the
package database in DESTDIR/var/db/pkg. As
DESTDIR is handled automatically by the ports
- infrastructure with &man.chroot.8;, you do not need any
+ infrastructure with &man.chroot.8;, there is no need for
modifications or any extra care to write
DESTDIR-compliant ports.
@@ -114,13 +114,13 @@
Avoiding hard-coded /usr/local paths in
the source makes the port much more flexible and able to cater
to the needs of other sites. Often, this can be accomplished by
- simply replacing occurrences of /usr/local
+ replacing occurrences of /usr/local
in the port's various Makefiles with
${PREFIX}. This variable is
automatically passed down to every stage of the build and
install processes.
- Make sure your application is not installing things in
+ Make sure the application is not installing things in
/usr/local instead of
PREFIX. A quick test for such hard-coded
paths is:
@@ -140,18 +140,18 @@
files, nor will it verify that LOCALBASE is
being used to correctly refer to files from other ports. The
temporarily-installed port in
- /var/tmp/`make -V PORTNAME` should be
+ /var/tmp/`make -V PORTNAME` must be
tested for proper operation to make sure there are no problems
with paths.
- PREFIX should not be set explicitly in a
+ PREFIX must not be set explicitly in a
port's Makefile. Users installing the port
may have set PREFIX to a custom location, and
- the port should respect that setting.
+ the port must respect that setting.Refer to programs and files from other ports with the
variables mentioned above, not explicit pathnames. For
- instance, if your port requires a macro PAGER
+ instance, if the port requires a macro PAGER
to have the full pathname of less, do not use
a literal path of /usr/local/bin/less.
Instead, use ${LOCALBASE}:
@@ -166,9 +166,9 @@
Tinderbox
- If you are an avid ports contributor, you might want to take
+ As an avid ports contributor, take
a look at Tinderbox. It is a
- powerful system for building and testing ports. You can install
+ powerful system for building and testing ports. Install
Tinderbox using
ports-mgmt/tinderbox port. Be
sure to read supplied documentation since the configuration is