diff --git a/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
index 57d8b23a7d..c2d4d95ffb 100644
--- a/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
@@ -179,7 +179,8 @@
LOCALBASE, DATADIR,
DOCSDIR, EXAMPLESDIR,
WWWDIR, and ETCDIR. Any
- line beginning with @comment will be deleted
+ line beginning with @comment folowed by a
+ space, will be deleted
from resulting files after a variable substitution.
This example replaces
diff --git a/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
index d231df9022..19fed718f9 100644
--- a/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
@@ -190,8 +190,9 @@ PLIST_SUB+= X11I386="@comment "
If there is a very good reason not to install a working
configuration file by default, only list the sample filename in
- pkg-plist, without the @sample
- part, and add a pkg-plist, without the
+ @sample followed by a space part, and add a
+ message pointing out that the
user must copy and edit the file before the software will
work.