svn commit: r40306 - head/en_US.ISO8859-1/books/porters-handbook

[Eitan Adler]

Author: eadler
Date: Sat Dec  8 13:32:22 2012
New Revision: 40306
URL: http://svnweb.freebsd.org/changeset/doc/40306

Log:
  Wording tweaks to the pkg-descr section of the porter's handbook.
  
  Submitted by:	wblock
  Approved by:	bcr (mentor)

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/book.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/book.xml	Sat Dec  8 00:09:39 2012	(r40305)
+++ head/en_US.ISO8859-1/books/porters-handbook/book.xml	Sat Dec  8 13:32:22 2012	(r40306)
@@ -185,18 +185,17 @@ USE_IMAKE=	yes
 	    fonts).</para>
 	</note>
 
-	<para>Well-written description text should describe the port
-	  completely enough that users would not have to consult its
-	  documentation or visit its website to understand what does it
-	  do, how it can be useful for them, what particularly nice
-	  features (if any) does it have, etc.  You might want to
-	  mention certain requirements (e.g. the graphical toolkit),
-	  heavy dependencies, runtime environment, or implementation
-	  languages, to help users to decide if they want to install
-	  this port or not.</para>
+	<para>A well-written <filename>pkg-descr</filename> describes
+	  the port completely enough that users would not have to
+	  consult the documentation or visit the website to understand
+	  what the software does, how it can be useful, or what
+	  particularly nice features it has.  Mentioning certain
+	  requirements like a graphical toolkit, heavy dependencies,
+	  runtime environment, or implementation languages help users
+	  whether this port will work for them.</para>
 
-	<para>If the ported software has an official WWW homepage, it
-	  should be listed here.  Prepend <emphasis>one</emphasis> of
+	<para>Include a URL to the official WWW homepage.
+	  Prepend <emphasis>one</emphasis> of
 	  the websites (pick the most common one) with
 	  <literal>WWW:</literal> (followed by single space) so that
 	  automated tools will work correctly.  If the URI is the root