|
Lines 3-8
Link Here
|
| 3 |
|
3 |
|
| 4 |
$FreeBSD: doc/zh_TW.Big5/books/porters-handbook/book.sgml,v 1.8 2006/07/08 08:55:47 vanilla Exp $ |
4 |
$FreeBSD: doc/zh_TW.Big5/books/porters-handbook/book.sgml,v 1.8 2006/07/08 08:55:47 vanilla Exp $ |
| 5 |
Original Revision: 1.675 |
5 |
Original Revision: 1.675 |
|
|
6 |
Chased Revision: 1.729 |
| 6 |
--> |
7 |
--> |
| 7 |
|
8 |
|
| 8 |
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [ |
9 |
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [ |
|
Lines 4159-4164
Link Here
|
| 4159 |
</tgroup> |
4160 |
</tgroup> |
| 4160 |
</table> |
4161 |
</table> |
| 4161 |
</sect2> |
4162 |
</sect2> |
|
|
4163 |
|
| 4164 |
<sect2 id="using-scons"> |
| 4165 |
<title>Using <command>scons</command></title> |
| 4166 |
|
| 4167 |
<para>If your port uses <application>SCons</application>, define |
| 4168 |
<literal>USE_SCONS=yes</literal>.</para> |
| 4169 |
|
| 4170 |
<table frame="none"> |
| 4171 |
<title>Variables for ports that use <command>scons</command></title> |
| 4172 |
|
| 4173 |
<tgroup cols="2"> |
| 4174 |
<thead> |
| 4175 |
<row> |
| 4176 |
<entry>Variable</entry> |
| 4177 |
|
| 4178 |
<entry>Means</entry> |
| 4179 |
</row> |
| 4180 |
</thead> |
| 4181 |
|
| 4182 |
<tbody> |
| 4183 |
<row> |
| 4184 |
<entry><makevar>SCONS_ARGS</makevar></entry> |
| 4185 |
|
| 4186 |
<entry>Port specific SCons flags passed to the SCons |
| 4187 |
environment.</entry> |
| 4188 |
</row> |
| 4189 |
|
| 4190 |
<row> |
| 4191 |
<entry><makevar>SCONS_BUILDENV</makevar></entry> |
| 4192 |
|
| 4193 |
<entry>Variables to be set in system environment.</entry> |
| 4194 |
</row> |
| 4195 |
|
| 4196 |
<row> |
| 4197 |
<entry><makevar>SCONS_ENV</makevar></entry> |
| 4198 |
|
| 4199 |
<entry>Variables to be set in SCons environment.</entry> |
| 4200 |
</row> |
| 4201 |
|
| 4202 |
<row> |
| 4203 |
<entry><makevar>SCONS_TARGET</makevar></entry> |
| 4204 |
|
| 4205 |
<entry>Last argument passed to SCons, similar to |
| 4206 |
<makevar>MAKE_TARGET</makevar>.</entry> |
| 4207 |
</row> |
| 4208 |
</tbody> |
| 4209 |
</tgroup> |
| 4210 |
</table> |
| 4211 |
</sect2> |
| 4162 |
</sect1> |
4212 |
</sect1> |
| 4163 |
|
4213 |
|
| 4164 |
<sect1 id="using-autotools"> |
4214 |
<sect1 id="using-autotools"> |
|
Lines 5467-5473
Link Here
|
| 5467 |
</row> |
5517 |
</row> |
| 5468 |
|
5518 |
|
| 5469 |
<row> |
5519 |
<row> |
| 5470 |
<entry><makevar>BROKEN_WITH_PHP</makevar></entry> |
5520 |
<entry><makevar>IGNORE_WITH_PHP</makevar></entry> |
| 5471 |
|
5521 |
|
| 5472 |
<entry>The port does not work with PHP of the given version. |
5522 |
<entry>The port does not work with PHP of the given version. |
| 5473 |
Possible values: <literal>4</literal>, |
5523 |
Possible values: <literal>4</literal>, |
|
Lines 5912-5917
Link Here
|
| 5912 |
|
5962 |
|
| 5913 |
</sect1> |
5963 |
</sect1> |
| 5914 |
|
5964 |
|
|
|
5965 |
<sect1 id="using-wx"> |
| 5966 |
<title>Using wxWidgets</title> |
| 5967 |
|
| 5968 |
<para>If your port uses <application>wxWidgets</application> |
| 5969 |
cross-platform toolkit, define <literal>USE_WX=yes</literal>. |
| 5970 |
A specific version can be requested by setting |
| 5971 |
<literal>USE_WX=2.6</literal>. Ranges (<literal>2.4-2.6</literal>) |
| 5972 |
and partial ranges (<literal>-2.4</literal>, <literal>2.6+</literal>) |
| 5973 |
are also possible.</para> |
| 5974 |
|
| 5975 |
<para>List of required wxWidgets components can be set as |
| 5976 |
<makevar>WX_COMPS</makevar>. Unless specified otherwise, port will |
| 5977 |
depend on wxWidgets library (<literal>wx</literal>). Available |
| 5978 |
components are:</para> |
| 5979 |
|
| 5980 |
<table frame="none"> |
| 5981 |
<title>Possible values for <makevar>WX_COMPS</makevar></title> |
| 5982 |
|
| 5983 |
<tgroup cols="2"> |
| 5984 |
<thead> |
| 5985 |
<row> |
| 5986 |
<entry>Value</entry> |
| 5987 |
|
| 5988 |
<entry>Means</entry> |
| 5989 |
</row> |
| 5990 |
</thead> |
| 5991 |
|
| 5992 |
<tbody> |
| 5993 |
<row> |
| 5994 |
<entry><literal>wx</literal></entry> |
| 5995 |
|
| 5996 |
<entry>wxWidget libraries</entry> |
| 5997 |
</row> |
| 5998 |
|
| 5999 |
<row> |
| 6000 |
<entry><literal>contrib</literal></entry> |
| 6001 |
|
| 6002 |
<entry>wxWidget contributed libraries</entry> |
| 6003 |
</row> |
| 6004 |
|
| 6005 |
<row> |
| 6006 |
<entry><literal>python</literal></entry> |
| 6007 |
|
| 6008 |
<entry>wxPython</entry> |
| 6009 |
</row> |
| 6010 |
|
| 6011 |
<row> |
| 6012 |
<entry><literal>mozilla</literal></entry> |
| 6013 |
|
| 6014 |
<entry>wxMozilla (only available for 2.4)</entry> |
| 6015 |
</row> |
| 6016 |
|
| 6017 |
<row> |
| 6018 |
<entry><literal>svg</literal></entry> |
| 6019 |
|
| 6020 |
<entry>wxSVG (only available for 2.6)</entry> |
| 6021 |
</row> |
| 6022 |
</tbody> |
| 6023 |
</tgroup> |
| 6024 |
</table> |
| 6025 |
|
| 6026 |
<para>If locating wxWidget libraries needs a configure argument in |
| 6027 |
addition to the <makevar>WX_CONFIG</makevar> variable, define |
| 6028 |
<makevar>WX_CONF_ARGS</makevar> in your port. Possible values |
| 6029 |
are <literal>absolute</literal> resulting in |
| 6030 |
<literal>--with-wx-config=${WX_CONFIG}</literal>, and |
| 6031 |
<literal>relative</literal> resulting in |
| 6032 |
<literal>--with-wx=${X11BASE}</literal> being added to configure |
| 6033 |
script arguments.</para> |
| 6034 |
|
| 6035 |
<para>Define <literal>WX_UNICODE=yes</literal> if your port needs |
| 6036 |
the Unicode version of the wxWidgets libraries.</para> |
| 6037 |
|
| 6038 |
<para>Example of port requiring Unicode versions of wxWidgets 2.6 and |
| 6039 |
contrib libraries:</para> |
| 6040 |
|
| 6041 |
<programlisting>USE_WX= 2.6 |
| 6042 |
WX_COMPS= wx contrib |
| 6043 |
WX_UNICODE= yes</programlisting> |
| 6044 |
|
| 6045 |
</sect1> |
| 6046 |
|
| 5915 |
<sect1 id="rc-scripts"> |
6047 |
<sect1 id="rc-scripts"> |
| 5916 |
<title>Starting and stopping services (rc scripts)</title> |
6048 |
<title>Starting and stopping services (rc scripts)</title> |
| 5917 |
|
6049 |
|
|
Lines 9796-9801
Link Here
|
| 9796 |
|
9928 |
|
| 9797 |
</sect1> |
9929 |
</sect1> |
| 9798 |
|
9930 |
|
|
|
9931 |
<sect1 id="dads-sysctl"> |
| 9932 |
<title><filename>sysctl</filename> 使用時機</title> |
| 9933 |
|
| 9934 |
<para><filename>sysctl</filename> 除了在 targets 之外,都不鼓勵使用。 |
| 9935 |
這是因為任何 <literal>makevar</literal> |
| 9936 |
的評估都有可能會使得程序執行速度變慢。例如在 |
| 9937 |
<command>make index</command> 的過程中就會需要用到 |
| 9938 |
<filename>sysctl</filename>。</para> |
| 9939 |
|
| 9940 |
<para>在 <filename>sysctl</filename> 的使用上,一定要用完整的路徑, |
| 9941 |
也就是以 <filename>/sbin/</filename> 開頭,因為有些使用者也許沒有 |
| 9942 |
將 <filename>/sbin/</filename> 放置在他們的環境變數 |
| 9943 |
<envar>PATH</envar> 中。</para> |
| 9944 |
</sect1> |
| 9945 |
|
| 9799 |
<sect1 id="dads-workarounds"> |
9946 |
<sect1 id="dads-workarounds"> |
| 9800 |
<title>Necessary workarounds</title> |
9947 |
<title>Necessary workarounds</title> |