View | Details | Raw Unified | Return to bug 99997
Collapse All | Expand All

(-)book.sgml (-1 / +148 lines)
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>

Return to bug 99997