docs/99845: [patch] First introduce porttools to Porter's Handbook

[Cheng-Lung Sung]

>Number:         99845
>Category:       docs
>Synopsis:       [patch] First introduce porttools to Porter's Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jul 06 15:40:14 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Cheng-Lung Sung
>Release:        FreeBSD 6.1-PRERELEASE i386
>Organization:
FreeBSD @ Taiwan
>Environment:
System: FreeBSD.csie.nctu.edu.tw 6.1-STABLE FreeBSD 6.1-STABLE #9: Thu May 11 14:31:45 CST 2006     root at FreeBSD.csie.nctu.edu.tw:/home/usr.obj/usr/src/sys/FREEBSD  i386

>Description:
- devel/porttools is there. But Porter's Handbook didn't mention about it.
  - docs about porttools will be updated/add in the future.
>How-To-Repeat:
>Fix:


Index: book.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.728
diff -u -r1.728 book.sgml
--- book.sgml	6 Jul 2006 06:35:21 -0000	1.728
+++ book.sgml	6 Jul 2006 15:29:51 -0000
@@ -6777,6 +6777,22 @@
 	  doubt, the best thing to do is ask on &a.ports;.</para>
       </sect1>
 
+      <sect1 id="testing-porttools">
+	<title>Port Tools</title>
+
+	<para>The <filename role="package">devel/porttools</filename>
+          program is part of the ports collection.</para>
+
+	<para>The <command>port</command> is the front-end script,
+	  it can help you simplify the testing job. Whenever you want 
+	  to test a new port or update a port, 
+	  <command>port test</command> will automate the process of 
+	  port testing, including <link
+	  linkend="testing-portlint"><command>portlint</command></link>
+	  checking. This command also detects and lists any files not 
+	  listed in <filename>pkg-plist</filename>.</para>
+      </sect1>
+
       <sect1 id="porting-prefix">
 	<title><makevar>PREFIX</makevar></title>
 

>Release-Note:
>Audit-Trail:
>Unformatted: