diff --git a/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml
index 757cb0f674..279c1c62da 100644
--- a/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml
@@ -101,6 +101,12 @@ COMMENT=	Cat chasing a mouse all over the screen
 	  are in an awkward format.  For example, manpages have
 	  justified spacing, which looks particularly bad with
 	  monospaced fonts.</para>
+
+	<para>On the other hand, the content of
+	  <filename>pkg-descr</filename> must be longer than the <link
+	    linkend="makefile-comment"><varname>COMMENT</varname></link>
+	  line from the Makefile.  It must explain in more depth what
+	  the port is all about.</para>
       </note>
 
       <para>A well-written <filename>pkg-descr</filename> describes