From owner-svn-doc-all@FreeBSD.ORG Sun Mar 24 18:31:39 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 64F53972; Sun, 24 Mar 2013 18:31:39 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 5631ADFB; Sun, 24 Mar 2013 18:31:39 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r2OIVcF1077741; Sun, 24 Mar 2013 18:31:38 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r2OIVcJI077737; Sun, 24 Mar 2013 18:31:38 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201303241831.r2OIVcJI077737@svn.freebsd.org> From: Warren Block Date: Sun, 24 Mar 2013 18:31:38 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r41305 - head/en_US.ISO8859-1/books/porters-handbook X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 24 Mar 2013 18:31:39 -0000 Author: wblock Date: Sun Mar 24 18:31:38 2013 New Revision: 41305 URL: http://svnweb.freebsd.org/changeset/doc/41305 Log: Whitespace-only cleanup. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml head/en_US.ISO8859-1/books/porters-handbook/uses.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Sun Mar 24 18:16:16 2013 (r41304) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Sun Mar 24 18:31:38 2013 (r41305) @@ -3799,10 +3799,10 @@ ALWAYS_KEEP_DISTFILES= yes <makevar>USES</makevar> - There several parameters exist for defining different kind - of features and dependencies that the port in question uses. - They can be specified by adding the following line to the - Makefile of the port: + There several parameters exist for defining different + kind of features and dependencies that the port in question + uses. They can be specified by adding the following line to + the Makefile of the port: USES= feature[:arguments] @@ -3810,8 +3810,8 @@ ALWAYS_KEEP_DISTFILES= yes linkend="uses-values"/>. - USES cannot be assigned after inclusion of - bsd.port.pre.mk. + USES cannot be assigned after + inclusion of bsd.port.pre.mk. @@ -4467,7 +4467,7 @@ OPTIONS_SINGLE_SG1= OPT3 OPT4 - OPTIONS_RADIO= RG1 + OPTIONS_RADIO= RG1 OPTIONS_RADIO_RG1= OPT7 OPT8 OPTIONS can also be grouped as @@ -4530,7 +4530,9 @@ RUN_DEPENDS+= bar:${PORTSDIR}/bar/bar - Check for Unset Port <makevar>OPTIONS</makevar> + Check for Unset Port + <makevar>OPTIONS</makevar> + .if ! ${PORT_OPTIONS:MEXAMPLES} CONFIGURE_ARGS+=--without-examples .endif @@ -4583,30 +4585,37 @@ CONFIGURE_ARGS+= --without-examples Default Options - The following options are always on by default. - + + The following options are always on by default. + + DOCS — build and install documentation. + NLS — Native Language Support. - + + - EXAMPLES — build and install - examples. + EXAMPLES — build and + install examples. + - IPV6 — IPv6 protocol support. + IPV6 — IPv6 protocol + support. + There is no need to add these to - OPTIONS_DEFAULT. To have them show up - in the options selection dialog, however, they must be added - to OPTIONS_DEFINE. - + OPTIONS_DEFAULT. To have them show + up in the options selection dialog, however, they must + be added to OPTIONS_DEFINE. + @@ -4982,13 +4991,14 @@ PORTVERSION= 1.0 - The DOCS option only controls additional - documentation installed in DOCSDIR. It - does not apply to standard man pages and info pages. - Things installed in DATADIR and + The DOCS option only controls + additional documentation installed in + DOCSDIR. It does not apply to standard + man pages and info pages. Things installed in + DATADIR and EXAMPLESDIR are controlled by - DATA and - EXAMPLES options, respectively. + DATA and EXAMPLES + options, respectively. These variables are exported to @@ -5022,14 +5032,13 @@ PORTVERSION= 1.0 is listed in PORTDOCS or matched by a glob pattern from this variable, the entire subtree of contained files and directories will be registered in the - final packing list. If the DOCS option has - been unset then files and directories listed in - PORTDOCS would not be installed - or added to port packing list. Installing the - documentation at PORTDOCS as shown above - remains up to the port itself. A typical example of - utilizing PORTDOCS looks as - follows: + final packing list. If the DOCS option + has been unset then files and directories listed in + PORTDOCS would not be installed or added + to port packing list. Installing the documentation at + PORTDOCS as shown above remains up to the + port itself. A typical example of utilizing + PORTDOCS looks as follows: PORTDOCS= README.* ChangeLog docs/* @@ -5916,13 +5925,15 @@ PLIST_SUB+= NLS="@comment " reside under LOCALBASE/share/locale, should rarely be created and removed by a port. The most + popular languages have their respective directories listed - in PORTSDIR/Templates/BSD.local.dist. + in + PORTSDIR/Templates/BSD.local.dist. The directories for many other languages are governed by the devel/gettext port. - Consult its pkg-plist and see - whether the port is going to install a message catalog file - for a unique language. + Consult its pkg-plist and see whether + the port is going to install a message catalog file for a + unique language. @@ -6840,7 +6851,7 @@ do-configure: _run suffixes can be used to force components dependency type (e.g., baseapps_run). If no suffix is set, a - default dependency type will be used. If you want to force + default dependency type will be used. If you want to force both types, add the component twice with both suffixes (e.g., automoc4_build automoc4_run). The most commonly used components are listed below (up-to-date @@ -10622,7 +10633,8 @@ as .putsy.conf and edit it.portsmon). This system attempts to classify port PRs by portname. To search for PRs about a particular port, use the Overview of One Port. + url="http://portsmon.FreeBSD.org/portoverview.py">Overview of + One Port. If there is no pending PR, the next step is to send an email to the port's maintainer, as shown by make @@ -10722,13 +10734,13 @@ as .putsy.conf and edit it. Using <literal>SVN</literal> to Make Patches - If you can, please submit a &man.svn.1; diff — they are - easier to handle than diffs between new and old - directories. Plus it is easier for you to see what you have - changed and to update your diff if something is modified in - the Ports Collection from when you started to work on it until - you submit your changes, or if the committer asks you to fix - something. + If you can, please submit a &man.svn.1; diff — they + are easier to handle than diffs between new and + old directories. Plus it is easier for you to see + what you have changed and to update your diff if something is + modified in the Ports Collection from when you started to work + on it until you submit your changes, or if the committer asks + you to fix something. &prompt.user; cd ~/my_wrkdir &prompt.user; svn co https://svn0.us-west.FreeBSD.org/ports/head/dns/pdnsd @@ -15807,29 +15819,30 @@ Reference: <http://www.freebsd.org/po 901501 November 11, 2012 - 9.1-STABLE after LIST_PREV() added to queue.h. + 9.1-STABLE after LIST_PREV() added to + queue.h. 901502 November 28, 2012 - 9.1-STABLE after USB serial jitter buffer requires - rebuild of USB serial device modules. + 9.1-STABLE after USB serial jitter buffer + requires rebuild of USB serial device modules. 901503 February 21, 2013 - 9.1-STABLE after USB moved to the driver structure - requiring a rebuild of all USB modules. Also indicates - the presence of nmtree. + 9.1-STABLE after USB moved to the driver + structure requiring a rebuild of all USB modules. + Also indicates the presence of nmtree. 901504 March 15, 2013 - 9.1-STABLE after install gained -l, -M, -N and related - flags and cat gained the -l option. + 9.1-STABLE after install gained -l, -M, -N and + related flags and cat gained the -l option. @@ -15998,7 +16011,7 @@ Reference: <http://www.freebsd.org/po October 16, 2012 10-CURRENT after the network interface cloning KPI changed and struct if_clone becoming opaque (rev - 241610). + 241610). @@ -16040,21 +16053,21 @@ Reference: <http://www.freebsd.org/po 1000025 November 17, 2012 - 10-CURRENT after the sin6_scope_id member variable - in struct sockaddr_in6 was changed to being filled by the - kernel before passing the structure to the userland via - sysctl or routing socket. This means the KAME-specific - embedded scope id in sin6_addr.s6_addr[2] is always - cleared in userland application (rev - 243443). + 10-CURRENT after the sin6_scope_id member + variable in struct sockaddr_in6 was changed to being + filled by the kernel before passing the structure to + the userland via sysctl or routing socket. This means + the KAME-specific embedded scope id in + sin6_addr.s6_addr[2] is always cleared in userland + application (rev 243443). 1000026 January 11, 2013 10-CURRENT after install gained the -N flag (rev - 245313). May also be used to indicate - the presense of nmtree. + 245313). May also be used to + indicate the presense of nmtree. @@ -16331,12 +16344,12 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD If building the port errors out with - unrecognized option '-pthread', - it may be desirable to use cc as linker by - setting CONFIGURE_ENV to - LD=${CC}. The - -pthread option is not supported by - ld directly. + unrecognized option '-pthread', it may be + desirable to use cc as linker by setting + CONFIGURE_ENV to + LD=${CC}. The + -pthread option is not supported by + ld directly. @@ -16935,9 +16948,9 @@ pre-install: release of each port with distfiles that have already been fetched. However, as the Internet continually changes, distfiles can quickly go missing. Portscout, the &os; - Ports distfile scanner, attempts to query every download site - for every port to find out if each distfile is still + url="http://portscout.FreeBSD.org">Portscout, the + &os; Ports distfile scanner, attempts to query every download + site for every port to find out if each distfile is still available. Portscout can generate HTML reports and send emails about newly available ports to those who request them. Unless not Modified: head/en_US.ISO8859-1/books/porters-handbook/uses.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses.xml Sun Mar 24 18:16:16 2013 (r41304) +++ head/en_US.ISO8859-1/books/porters-handbook/uses.xml Sun Mar 24 18:31:38 2013 (r41305) @@ -24,27 +24,28 @@ role="package">devel/bison in one way or another. By default, with no arguments or with the build argument, it implies bison as a build-time - dependency, run implies a run-time dependency, and - both implies both run-time and build-time + dependency, run implies a run-time dependency, + and both implies both run-time and build-time dependencies. cmake none, outsource - The port will use CMake for configuring - and building. With the outsource argument, an - out-of-source build will be performed. For more information see - . - + + The port will use CMake for + configuring and building. With the outsource + argument, an out-of-source build will be performed. For more + information see . fuse none - Implies the port will depend on the FUSE library and handle the the dependency on the kernel module depending on the version of - &os;. - + + Implies the port will depend on the FUSE library and handle + the the dependency on the kernel module depending on the version + of &os;. @@ -61,11 +62,12 @@ none, build, run, both, vars Implies that the port uses mail/qmail in one way or another. With - the build argument, it implies qmail - as a build-time dependency. run implies a run-time - dependency. Using no argument or the both argument - implies both run-time and build-time dependencies. vars + role="package">mail/qmail in one way or another. + With the build argument, it implies + qmail as a build-time dependency. + run implies a run-time dependency. Using no + argument or the both argument implies both + run-time and build-time dependencies. vars will only set QMAIL variables for the port to use. @@ -73,7 +75,7 @@ zenoss none Implies the port uses net-mgmt/zenoss in one way or another, but - largely is used for building zenoss related zenpack ports. - + role="package">net-mgmt/zenoss in one way or another, + but largely is used for building zenoss related zenpack + ports.