docs/99835: [patch] works on zh_TW's porter's handbook

Thu Jul 6 09:30:18 UTC 2006

>Number:         99835
>Category:       docs
>Synopsis:       [patch] works on zh_TW's 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 09:30:16 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:
- add one missing subsection "Use the exec statement in wrapper scripts" (translated).
- add one missing table "Useful variables for porting Apache modules" (translated).
- sync table "Variables for ports that use Apache"
- sync subsection "PEAR modules". (docs/99733, docs/99734)
>How-To-Repeat:
>Fix:


Index: book.sgml
===================================================================
RCS file: /home/dcvs/doc/zh_TW.Big5/books/porters-handbook/book.sgml,v
retrieving revision 1.6
diff -u -r1.6 book.sgml

--- book.sgml	6 Jul 2006 07:56:11 -0000	1.6
+++ book.sgml	6 Jul 2006 09:25:50 -0000
@@ -5307,29 +5307,137 @@
 	    <tbody>
 
 	      <row>
-		<entry>USE_APACHE</entry>
+		<entry><makevar>USE_APACHE</makevar></entry>
 
-		<entry>The port requires Apache.</entry>
+		<entry>The port requires Apache.  Possible values:
+		  <literal>yes</literal> (gets any version),
+		  <literal>1.3</literal>, <literal>2.0</literal>,
+		  <literal>2.2</literal>, <literal>2.0+</literal>,
+		  etc.  Default dependency is on version
+		  <literal>1.3</literal>.</entry>
 	      </row>
 
 	      <row>
-		<entry>WITH_APACHE2</entry>
+		<entry><makevar>WITH_APACHE2</makevar></entry>
 
 		<entry>The port requires Apache 2.0.  Without this variable,
-		  the port will depend on Apache 1.3.</entry>
+		  the port will depend on Apache 1.3.  This variable is
+		  deprecated and should not be used anymore.</entry>
 	      </row>
 
 	      <row>
-		<entry>APXS</entry>
+		<entry><makevar>APXS</makevar></entry>
 
-		<entry>Full path to the <command>apxs</command> binary
-		  (read-only variable).</entry>
+		<entry>Full path to the <command>apxs</command> binary.
+		  Can be overriden in your port.</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>HTTPD</makevar></entry>
+
+		<entry>Full path to the <command>httpd</command> binary.
+		  Can be overriden in your port.</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>APACHE_VERSION</makevar></entry>
+
+		<entry>The version of present Apache installation (read-only
+		  variable).  This variable is only available after inclusion
+		  of <filename>bsd.port.pre.mk</filename>.  Possible values:
+		  <literal>13</literal>, <literal>20</literal>,
+		  <literal>22</literal>.</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>APACHEMODDIR</makevar></entry>
+
+		<entry>Directory for Apache modules.  This variable is
+		  automatically expanded in pkg-plist.</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>APACHEINCLUDEDIR</makevar></entry>
+
+		<entry>Directory for Apache headers.  This variable is
+		  automatically expanded in pkg-plist.</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>APACHEETCDIR</makevar></entry>
+
+		<entry>Directory for Apache configuration files.  This
+		  variable is automatically expanded in pkg-plist.</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
+	<table frame="none">
+	  <title>port Apache æ¨¡çµ„æ™‚å¥½ç”¨çš„è®Šæ•¸</title>
+
+	  <tgroup cols="2">
+	    <tbody>
+
+	      <row>
+		<entry><makevar>MODULENAME</makevar></entry>
+
+		<entry>æ¨¡çµ„åç¨±ã€‚  é è¨å€¼ç‚º
+		  <makevar>PORTNAME</makevar>. ç¯„ä¾‹ï¼š
+		  <literal>mod_hello</literal></entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>SHORTMODNAME</makevar></entry>
+
+		<entry>ç°¡åŒ–çš„æ¨¡çµ„åç¨±ã€‚  è‡ªå‹•åœ°ç”±è®Šæ•¸
+		  <makevar>MODULENAME</makevar> ç”¢ç”Ÿï¼Œä¸éŽå¯ä»¥è¦†è“‹å®ƒã€‚
+		  ç¯„ä¾‹ï¼š <literal>hello</literal></entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>AP_FAST_BUILD</makevar></entry>
+
+		<entry>ä½¿ç”¨ <command>apxs</command> 
+		  ä¾†ç·¨è¯åŠå®‰è£é€™å€‹æ¨¡çµ„ã€‚</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>AP_GENPLIST</makevar></entry>
+
+		<entry>åŒæ¨£åœ°ï¼Œä¹Ÿæ˜¯è‡ªå‹•ç”¢ç”Ÿ
+		  <filename>pkg-plist</filename>ã€‚</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>AP_INC</makevar></entry>
+
+		<entry>åœ¨ç·¨è¯æ™‚é–“åŠ å…¥ä¸€å€‹ç›®éŒ„åˆ°æ¨™é æª”æœå°‹è·¯å¾‘ã€‚</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>AP_LIB</makevar></entry>
+
+		<entry>åœ¨ç·¨è¯æ™‚é–“åŠ å…¥ä¸€å€‹ç›®éŒ„åˆ°å‡½å¼åº«æœå°‹è·¯å¾‘ã€‚</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>AP_EXTRAS</makevar></entry>
+
+		<entry>å‚³çµ¦
+		  <command>apxs</command> é¡å¤–çš„ flagsã€‚</entry>
+	      </row>
+
+	    </tbody>
+	  </tgroup>
+	</table>
+
+	<para>Web æ‡‰ç”¨ç¨‹å¼æ‡‰è©²å®‰è£åˆ°
+	  <makevar>PREFIX</makevar><filename>/www/<replaceable>appname</replaceable></filename>
+	  ï¼ŒåŒæ™‚ä¸æ‡‰è©²å‡è¨ Apache å·²å˜åœ¨äº†ï¼Œé™¤éžä»–å€‘æœ‰æ˜Žç¢ºåœ°éœ€è¦ï¼ˆdepend onï¼‰
+	  Apahceã€‚ä½¿ç”¨è€…ä¹Ÿè¨±å¸Œæœ›åœ¨å…¶ä»–éž Apache çš„ Web ä¼ºæœå™¨ä¸ŠåŸ·è¡Œã€‚</para>
+
       </sect2>
 
       <sect2 id="php-variables">
@@ -5414,13 +5522,6 @@
 
 		<entry>Want the Apache module or the CGI version of PHP.</entry>
 	      </row>
-
-	      <row>
-		<entry><makevar>WANT_PHP_PEAR</makevar></entry>
-
-		<entry>Want the PEAR framework.</entry>
-	      </row>
-
 	    </tbody>
 	  </tgroup>
 	</table>
@@ -5441,7 +5542,7 @@
 	  <filename>pkg-plist</filename>.</para>
 
 	<para>Include
-	  <filename>${PORTSDIR}/devel/pear-PEAR/Makefile.common</filename>
+	  <filename>${PORTSDIR}/devel/pear/bsd.pear.mk</filename>
 	  on the last line of the <filename>Makefile</filename>.</para>
 
 	<example id="pear-makefile">
@@ -5468,7 +5569,7 @@
 _DOCSDIR=       .
 
 .include <bsd.port.pre.mk>
-.include "${PORTSDIR}/devel/pear-PEAR/Makefile.common"
+.include "${PORTSDIR}/devel/pear/bsd.pear.mk"
 .include <bsd.port.post.mk></programlisting>
 
 	</example>
@@ -9155,6 +9229,22 @@
 	  for their files.</para>
       </sect1>
 
+      <sect1 id="dads-sh-exec">
+	<title>åœ¨ wrapper scripts ä¸ä½¿ç”¨ <function>exec</function> è¿°å¥</title>
+
+	<para>è‹¥æŸ port ç‚ºäº†åŸ·è¡Œå…¶ä»–ç¨‹å¼è€Œå®‰è£äº†ä¸€å€‹ shell scriptï¼Œ
+	  è€Œè©²ç¨‹å¼åŒæ™‚ä¹Ÿæ˜¯è©² script æœ€å¾Œä¸€å€‹å‹•ä½œï¼Œé‚£éº¼éœ€è¦ç¢ºå®šè©² script 
+	  æ˜¯ç”¨ <function>exec</function> è¿°å¥ï¼ˆstatementï¼‰ï¼Œèˆ‰ä¾‹è€Œè¨€ï¼š</para>
+
+	<programlisting>#!/bin/sh
+exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
+
+	<para><function>exec</function> è¿°å¥ä»¥æ‰€æŒ‡å®šçš„ç¨‹å¼å–ä»£äº†è©² shell 
+	  çš„ç¨‹åºã€‚ è‹¥çœç•¥ <function>exec</function> ï¼Œé‚£éº¼è©² shell ç¨‹åº
+	  å°‡æœƒåœ¨ç¨‹å¼åŸ·è¡Œä¸ä¸€ç›´å˜åœ¨æ–¼è¨˜æ†¶é«”ï¼Œé€™ç„¡ç–‘åœ°æµªè²»äº†ç³»çµ±è³‡æºã€‚</para>
+
+      </sect1>
+
       <sect1 id="dads-uid-and-gids">
 	<title>UIDs and GIDs</title>
 
>Release-Note:
>Audit-Trail:
>Unformatted:

