docs/54380: [PATCH] document additional perl variables from bsd.port.mk in porter's handbook

[Oliver Eikemeier]

>Number:         54380
>Category:       docs
>Synopsis:       [PATCH] document additional perl variables from bsd.port.mk in porter's handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 11 08:00:31 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Oliver Eikemeier
>Release:        FreeBSD 4.8-STABLE i386
>Organization:
Fillmore Labs - http://www.fillmore-labs.com
>Environment:
System: FreeBSD nuuk.fillmore-labs.com 4.8-STABLE

>Description:

The variables added in revision 1.433 in bsd.port.mk
  <http://www.freebsd.org/cgi/cvsweb.cgi/ports/Mk/bsd.port.mk#rev1.433>
should be documented in the FreeBSD Porter's Handbook 5.3 Using Perl
  <http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/using-perl.html>

>How-To-Repeat:
>Fix:

--- porters-handbook-using-perl.patch begins here ---
--- doc/en_US.ISO8859-1/books/porters-handbook/book.sgml.orig	Thu Jul 10 04:58:46 2003
+++ doc/en_US.ISO8859-1/books/porters-handbook/book.sgml	Fri Jul 11 16:49:21 2003
@@ -3218,7 +3218,30 @@
 	    </row>
 	    
 	    <row>
-	      <entry><makevar>PERL</makevar></entry>
+	      <entry><makevar>USE_PERL5_BUILD<makevar></entry>
+
+	      <entry>Says that the port uses Perl 5 to build.</entry>
+	    </row>
+	    
+	    <row>
+	      <entry><makevar>USE_PERL5_RUN<makevar></entry>
+
+	      <entry>Says that the port uses Perl 5 to run.</entry>
+	    </row>
+	    
+	    <row>
+	      <entry><makevar>PERL5<makevar></entry>
+
+	      <entry>The full path of perl5, either in the system or
+		installed from a port.</entry>
+	    </row>
+	    
+	    <row>
+	      <entry><makevar>PERL<makevar></entry>
+
+	      <entry>The full path of perl5, either in the system or
+		installed from a port, but without the version number.
+		Use this if you need to replace <quote><literal>#!</literal></quote> lines in scripts.</entry>
 	    </row>
 	    
 	    <row>
@@ -3247,6 +3270,20 @@
 	      
 	      <entry>Where Perl stores architecture dependent libraries.
 		Defaults to <literal>${ARCH}-freebsd</literal>.</entry>
+	    </row>
+	    
+	    <row>
+	      <entry><makevar>PERL_PORT<makevar></entry>
+
+	      <entry>Name of the perl port that is installed (e.g.,
+		<literal>perl5</literal>).</entry>
+	    </row>
+	    
+	    <row>
+	      <entry><makevar>SITE_PERL<makevar></entry>
+
+	      <entry>Directory name where site specific perl packages go.
+		This value is added to PLIST_SUB.</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
--- porters-handbook-using-perl.patch ends here ---

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