From owner-freebsd-doc@FreeBSD.ORG Mon Jul 10 06:40:20 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E005116A4EF for ; Mon, 10 Jul 2006 06:40:20 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id C846843D5A for ; Mon, 10 Jul 2006 06:40:16 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k6A6eGq0037731 for ; Mon, 10 Jul 2006 06:40:16 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k6A6eGVK037730; Mon, 10 Jul 2006 06:40:16 GMT (envelope-from gnats) Resent-Date: Mon, 10 Jul 2006 06:40:16 GMT Resent-Message-Id: <200607100640.k6A6eGVK037730@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Cheng-Lung Sung Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9AF4D16A4E1 for ; Mon, 10 Jul 2006 06:31:37 +0000 (UTC) (envelope-from clsung@FreeBSD.csie.nctu.edu.tw) Received: from FreeBSD.csie.nctu.edu.tw (freebsd.csie.nctu.edu.tw [140.113.17.209]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4355543D64 for ; Mon, 10 Jul 2006 06:31:32 +0000 (GMT) (envelope-from clsung@FreeBSD.csie.nctu.edu.tw) Received: from localhost (localhost.csie.nctu.edu.tw [127.0.0.1]) by FreeBSD.csie.nctu.edu.tw (Postfix) with ESMTP id 039EC7E99C for ; Mon, 10 Jul 2006 14:32:44 +0800 (CST) Received: from FreeBSD.csie.nctu.edu.tw ([127.0.0.1]) by localhost (FreeBSD.csie.nctu.edu.tw [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id LIWllYYp01vt for ; Mon, 10 Jul 2006 14:32:43 +0800 (CST) Received: by FreeBSD.csie.nctu.edu.tw (Postfix, from userid 1038) id 0C6D77E9A0; Mon, 10 Jul 2006 14:32:43 +0800 (CST) Message-Id: <20060710063243.0C6D77E9A0@FreeBSD.csie.nctu.edu.tw> Date: Mon, 10 Jul 2006 14:32:43 +0800 (CST) From: Cheng-Lung Sung To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/99997: [patch] zh_TW porter's handbook: chase to rev. 1.729 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Cheng-Lung Sung List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 10 Jul 2006 06:40:21 -0000 >Number: 99997 >Category: docs >Synopsis: [patch] zh_TW porter's handbook: chase to rev. 1.729 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Mon Jul 10 06:40: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@FreeBSD.csie.nctu.edu.tw:/home/usr.obj/usr/src/sys/FREEBSD i386 >Description: - porter's handbook: chase to rev. 1.729 - the two new bsd.wx.mk and bsd.scons.mk - BROKEN_WITH_PHP to IGNORE_WITH_PHP - sysctl doc (translated) - add a chase revision mark >How-To-Repeat: >Fix: Index: book.sgml =================================================================== RCS file: /home/dcvs/doc/zh_TW.Big5/books/porters-handbook/book.sgml,v retrieving revision 1.8 diff -u -r1.8 book.sgml --- book.sgml 8 Jul 2006 08:55:47 -0000 1.8 +++ book.sgml 10 Jul 2006 00:38:34 -0000 @@ -3,6 +3,7 @@ $FreeBSD: doc/zh_TW.Big5/books/porters-handbook/book.sgml,v 1.8 2006/07/08 08:55:47 vanilla Exp $ Original Revision: 1.675 + Chased Revision: 1.729 --> + + + Using <command>scons</command> + + If your port uses SCons, define + USE_SCONS=yes. + + + Variables for ports that use <command>scons</command> + + + + + Variable + + Means + + + + + + SCONS_ARGS + + Port specific SCons flags passed to the SCons + environment. + + + + SCONS_BUILDENV + + Variables to be set in system environment. + + + + SCONS_ENV + + Variables to be set in SCons environment. + + + + SCONS_TARGET + + Last argument passed to SCons, similar to + MAKE_TARGET. + + + +
+ @@ -5467,7 +5517,7 @@ - BROKEN_WITH_PHP + IGNORE_WITH_PHP The port does not work with PHP of the given version. Possible values: 4, @@ -5912,6 +5962,88 @@ + + Using wxWidgets + + If your port uses wxWidgets + cross-platform toolkit, define USE_WX=yes. + A specific version can be requested by setting + USE_WX=2.6. Ranges (2.4-2.6) + and partial ranges (-2.4, 2.6+) + are also possible. + + List of required wxWidgets components can be set as + WX_COMPS. Unless specified otherwise, port will + depend on wxWidgets library (wx). Available + components are: + + + Possible values for <makevar>WX_COMPS</makevar> + + + + + Value + + Means + + + + + + wx + + wxWidget libraries + + + + contrib + + wxWidget contributed libraries + + + + python + + wxPython + + + + mozilla + + wxMozilla (only available for 2.4) + + + + svg + + wxSVG (only available for 2.6) + + + +
+ + If locating wxWidget libraries needs a configure argument in + addition to the WX_CONFIG variable, define + WX_CONF_ARGS in your port. Possible values + are absolute resulting in + --with-wx-config=${WX_CONFIG}, and + relative resulting in + --with-wx=${X11BASE} being added to configure + script arguments. + + Define WX_UNICODE=yes if your port needs + the Unicode version of the wxWidgets libraries. + + Example of port requiring Unicode versions of wxWidgets 2.6 and + contrib libraries: + + USE_WX= 2.6 +WX_COMPS= wx contrib +WX_UNICODE= yes + + + Starting and stopping services (rc scripts) @@ -9796,6 +9928,21 @@ + + <filename>sysctl</filename> 使用時機 + + sysctl 除了在 targets 之外，都不鼓勵使用。 + 這是因為任何 makevar + 的評估都有可能會使得程序執行速度變慢。例如在 + make index 的過程中就會需要用到 + sysctl。 + + 在 sysctl 的使用上，一定要用完整的路徑， + 也就是以 /sbin/ 開頭，因為有些使用者也許沒有 + 將 /sbin/ 放置在他們的環境變數 + PATH 中。 + + Necessary workarounds >Release-Note: >Audit-Trail: >Unformatted: