svn commit: r50387 - head/en_US.ISO8859-1/books/porters-handbook/quick-porting

[Mathieu Arnold]

Author: mat
Date: Tue Jun 20 11:30:00 2017
New Revision: 50387
URL: https://svnweb.freebsd.org/changeset/doc/50387

Log:
  Add a second paragraph on what pkg-descr should be.
  
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml	Tue Jun 20 11:29:58 2017	(r50386)
+++ head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml	Tue Jun 20 11:30:00 2017	(r50387)
@@ -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