docs/120124: Add ports-mgmt/genplist to pkg-plist section of Porter's Handbook

[Thomas Abthorpe]

>Number:         120124
>Category:       docs
>Synopsis:       Add ports-mgmt/genplist to pkg-plist section of Porter's Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jan 29 18:50:02 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Thomas Abthorpe
>Release:        FreeBSD 7.0-PRERELEASE i386
>Organization:
FreeBSD.GoodKing.Ca
>Environment:
System: FreeBSD freefall.freebsd.org 7.0-PRERELEASE FreeBSD 7.0-PRERELEASE #32: Tue Jan 15 15:07:33 UTC 2008 simon at freefall.freebsd.org:/usr/src/sys/i386/compile/FREEFALL i386


>Description:
- Add ports-mgmt/genplist to pkg-plist section of Porter's Handbook
>How-To-Repeat:
>Fix:
--- patch begins here ---
Index: book.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.901
diff -u -r1.901 book.sgml
--- book.sgml	28 Jan 2008 06:44:37 -0000	1.901
+++ book.sgml	29 Jan 2008 18:29:20 -0000
@@ -8574,9 +8574,12 @@
 	<link linkend="porting-shlibs">shared libraries</link> section.</para>
 
       <para>Alternatively, use the <command>plist</command> script in
-	<filename>/usr/ports/Tools/scripts/</filename> to build the
-	package list automatically.  The first step is the same as
-	above: take the first three lines, that is,
+	<filename>/usr/ports/Tools/scripts/</filename> or install
+	<filename role="package">ports-mgmt/genplist</filename>
+	to build the package list automatically.</para>
+
+      <para>When using the plist script, the first step is
+	the same as above: take the first three lines, that is,
 	<command>mkdir</command>, <command>mtree</command> and
 	<command>make depends</command>.  Then build and install the
 	port:</para>
@@ -8588,8 +8591,12 @@
 
       <screen>&prompt.root; <userinput>/usr/ports/Tools/scripts/plist -Md -m $(make -V MTREE_FILE) /var/tmp/$(make -V PORTNAME) > pkg-plist</userinput></screen>
 
-      <para>The packing list still has to be tidied up by hand as
-	stated above.</para>
+      <para>To use genplist</para>
+
+      <screen>&prompt.root; <userinput>genplist /var/tmp/$(make -V PORTNAME)</userinput></screen>
+ 
+      <para>In either case, the packing list still has to be tidied up by
+	hand as stated above.</para>
 
     </sect1>
--- patch ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted: