os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- add one missing subsection "Use the exec statement in wrapper scripts" (translated).

Browse source 
- 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)

PR:		docs/99835
Submitted by:	clsung@
This commit is contained in:
Vanilla I. Shu 2006-07-06 15:24:16 +00:00
parent 247d40ee68
commit 627840e455
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=28207
1 changed files with 133 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

149
zh_TW.Big5/books/porters-handbook/book.sgml
View file

@ -5307,29 +5307,137 @@ BUILD_DEPENDS+= Xvfb:${X_VFBSERVER_PORT} \
<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 @@ BUILD_DEPENDS+= Xvfb:${X_VFBSERVER_PORT} \
<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 @@ BUILD_DEPENDS+= Xvfb:${X_VFBSERVER_PORT} \
<filename>pkg-plist</filename>.</para>
<para>Include
<filename>&dollar;{PORTSDIR}/devel/pear-PEAR/Makefile.common</filename>
<filename>&dollar;{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 @@ DOCS= TODO
_DOCSDIR= .
.include &lt;bsd.port.pre.mk&gt;
.include "&dollar;{PORTSDIR}/devel/pear-PEAR/Makefile.common"
.include "&dollar;{PORTSDIR}/devel/pear/bsd.pear.mk"
.include &lt;bsd.port.post.mk&gt;</programlisting>
</example>
@ -9155,6 +9256,22 @@ post-install:
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>