From owner-svn-doc-head@FreeBSD.ORG Wed Jul 16 20:07:58 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id F1513865; Wed, 16 Jul 2014 20:07:57 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id DCE3A2DC0; Wed, 16 Jul 2014 20:07:57 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s6GK7vrv078926; Wed, 16 Jul 2014 20:07:57 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s6GK7vSf078924; Wed, 16 Jul 2014 20:07:57 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201407162007.s6GK7vSf078924@svn.freebsd.org> From: Warren Block Date: Wed, 16 Jul 2014 20:07:57 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r45317 - in head/en_US.ISO8859-1/books/porters-handbook: uses versions X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 16 Jul 2014 20:07:58 -0000 Author: wblock Date: Wed Jul 16 20:07:57 2014 New Revision: 45317 URL: http://svnweb.freebsd.org/changeset/doc/45317 Log: Whitespace-only fixes, indentation and wrapping long lines. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/versions/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Wed Jul 16 20:02:06 2014 (r45316) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Wed Jul 16 20:07:57 2014 (r45317) @@ -14,7 +14,9 @@ FEATURE + ARGUMENTS + DESCRIPTION @@ -22,329 +24,369 @@ - Values of <varname>USES</varname> - - - Values of <varname>USES</varname> - - - - - Feature - Arguments - Description - - - - - - - ada - - (none) - - Depends on an Ada-capable - compiler, and sets CC accordingly. - - - - bison - - (none), build, run, - both - - Uses devel/bison - By default, with no arguments or with the - build argument, it implies - bison is a build-time dependency, - run implies a run-time dependency, and - both implies both run-time and build-time - dependencies. - - - - charsetfix - - (none) - - Prevents the port from installing - charset.alias. This should be installed only - by converters/libiconv. - CHARSETFIX_MAKEFILEIN can be set to a path - relative to WRKSRC if - charset.alias is not installed by - WRKSRC/Makefile.in. - - - - cmake - - (none), outsource, - run - - Uses CMake for configuring and - building. With the outsource argument, an - out-of-source build will be performed. With the - run argument, a run-time dependency is - registered. For more information see - . - - - - compiler - - (none), c++0x, - c++11-lang, c++11-lib, - c11, openmp, - nestedfct, features - - Determines which compiler to use based on any given wishes. - Use c++11-lang if the port needs a - C++11-capable compiler, and c++11-lib if the - port also needs a C++11-ready standard library. If the port needs - a compiler understanding C++0X, C11, OpenMP, or nested functions, - the corresponding parameters can be used. Use - features to request a list of features - supported by the default compiler. After including - bsd.port.pre.mk the port can inspect the - results using these variables: - - - - COMPILER_TYPE: the default compiler - on the system, either gcc or clang - - - - ALT_COMPILER_TYPE: the alternative - compiler on the system, either gcc or clang. Only set if - two compilers are present in the base - system. - - - - COMPILER_VERSION: the first two - digits of the version of the default compiler. - - - - ALT_COMPILER_VERSION: the first two - digits of the version of the alternative compiler, if - present. - - - - CHOSEN_COMPILER_TYPE: the chosen - compiler, either gcc or clang - - - - COMPILER_FEATURES: the features - supported by the default compiler. It currently lists the - C++ library. - - - - - - cran + Values of + <varname>USES</varname> - (none), auto-plist +
+ Values of <varname>USES</varname> - Uses the Comprehensive R Archive Network. Specify - auto-plist to automatically generate - pkg-plist. - - - - desktop-file-utils - - (none) - - Uses update-desktop-database from - devel/desktop-file-utils. An extra - post-install step will be run without interfering with any - post-install steps already in the port - Makefile. Lines will be inserted into the - plist to run update-desktop-database on - package install or removal. - - - - desthack - - (none) - - Changes the behavior of GNU configure to properly support - DESTDIR in case the original software does - not. - - - - display - - (none), ARGS - - Set up a virtual display environment. If the environment - variable DISPLAY is not set, then - Xvfb is added as a build dependency, - and CONFIGURE_ENV is extended with the port - number of the currently running instance of - Xvfb. The ARGS - parameter defaults to install and controls the - phase around which to start and stop the virtual display. - - - - dos2unix - - (none) - - The port has files with line endings in - DOS format which need to be converted. Three - variables can be set to control which files will be converted. - The default is to convert all files, - including binaries. See for examples. - - - - DOS2UNIX_REGEX: match file names - based on a regular expression. - - - - DOS2UNIX_FILES: match literal file - names. - - - - DOS2UNIX_GLOB: match file names based - on a glob pattern. - - - - - - fam - - (none), fam, gamin - - Uses a File Alteration Monitor as a library dependency, - either devel/fam or - devel/gamin. End users can set - WITH_FAM_SYSTEM to specify their preference. - - - - fmake - - (none) - - Uses devel/fmake as a - build-time dependency. - + + + + Feature + + Arguments + + Description + + + + + + ada + + (none) + + Depends on an Ada-capable + compiler, and sets CC + accordingly. + + + + bison + + (none), build, + run, both + + Uses devel/bison + By default, with no arguments or with the + build argument, it implies + bison is a build-time dependency, + run implies a run-time dependency, and + both implies both run-time and + build-time dependencies. + + + + charsetfix + + (none) + + Prevents the port from installing + charset.alias. This should be + installed only by + converters/libiconv. + CHARSETFIX_MAKEFILEIN can be set to a + path relative to WRKSRC if + charset.alias is not installed by + WRKSRC/Makefile.in. + + + + cmake + + (none), outsource, + run + + Uses CMake for configuring + and building. With the outsource + argument, an out-of-source build will be performed. With + the run argument, a run-time dependency + is registered. For more information see + . + + + + compiler + + (none), c++0x, + c++11-lang, + c++11-lib, c11, + openmp, nestedfct, + features + + Determines which compiler to use based on any given + wishes. Use c++11-lang if the port + needs a C++11-capable compiler, and + c++11-lib if the port also needs a + C++11-ready standard library. If the port needs a + compiler understanding C++0X, C11, OpenMP, or nested + functions, the corresponding parameters can be used. Use + features to request a list of features + supported by the default compiler. After including + bsd.port.pre.mk the port can inspect + the results using these variables: + + + + COMPILER_TYPE: the default + compiler on the system, either gcc or clang + + + + ALT_COMPILER_TYPE: the + alternative compiler on the system, either gcc or + clang. Only set if two compilers are present in the + base system. + + + + COMPILER_VERSION: the first + two digits of the version of the default + compiler. + + + + + ALT_COMPILER_VERSION: the + first two digits of the version of the alternative + compiler, if present. + + + + CHOSEN_COMPILER_TYPE: the + chosen compiler, either gcc or clang + + + + COMPILER_FEATURES: the + features supported by the default compiler. It + currently lists the C++ library. + + + + + + cran + + (none), auto-plist + + Uses the Comprehensive R Archive Network. Specify + auto-plist to automatically generate + pkg-plist. + + + + desktop-file-utils + + (none) + + Uses + update-desktop-database from + devel/desktop-file-utils. + An extra post-install step will be run without interfering + with any post-install steps already in the port + Makefile. Lines will be inserted + into the plist to run + update-desktop-database on + package install or removal. + + + + desthack + + (none) + + Changes the behavior of GNU configure to properly + support DESTDIR in case the original + software does not. + + + + display + + (none), ARGS + + Set up a virtual display environment. If the + environment variable DISPLAY is not + set, then Xvfb is added as a + build dependency, and CONFIGURE_ENV is + extended with the port number of the currently running + instance of Xvfb. The + ARGS parameter defaults to + install and controls the phase around + which to start and stop the virtual display. + + + + dos2unix + + (none) + + The port has files with line endings in + DOS format which need to be converted. + Three variables can be set to control which files will be + converted. The default is to convert + all files, including binaries. See + for + examples. + + + + DOS2UNIX_REGEX: match file + names based on a regular expression. + + + + DOS2UNIX_FILES: match literal + file names. + + + + DOS2UNIX_GLOB: match file + names based on a glob pattern. + + + + + + fam + + (none), fam, gamin + + Uses a File Alteration Monitor as a library + dependency, either + devel/fam or + devel/gamin. End users can + set WITH_FAM_SYSTEM to specify their preference. + + + + fmake + + (none) + + Uses devel/fmake as a + build-time dependency. + + + + fortran + + gcc (default), + ifort + + Uses the Fortran compiler from either GNU or + Intel. + + + + fuse + + (none) + + The port will depend on the FUSE library and handle + the dependency on the kernel module depending on the + version of &os;. + + + + gettext + + (none), lib (default), + build, run + + Uses devel/gettext. + By default, with no arguments or with the + lib argument, implies a library + dependency on libintl.so. + build and run + implies, respectively a build-time and a run-time + dependency on xgettext. + + + + gmake + + (none) + + Uses devel/gmake as a + build-time dependency and sets up the environment to use + gmake as the default + make for the build. + + + + gssapi + + (none), base (default), + heimdal, mit, + flags, + bootstrap + + + Handle dependencies needed by consumers of the + GSS-API. Only libraries that provide + the Kerberos mechanism are + available. By default, or set to + base, the GSS-API + library from the base system is used. Can also be set + to heimdal to use + security/heimdal, or + mit to use + security/krb5. + + When the local Kerberos + installation is not in LOCALBASE, set + HEIMDAL_HOME (for + heimdal) or + KRB5_HOME (for + krb5) to the location of the + Kerberos installation. + + These variables are exported for the ports to + use: + + + + GSSAPIBASEDIR + + + + GSSAPICPPFLAGS + + + + GSSAPIINCDIR + + + + GSSAPILDFLAGS + + + + GSSAPILIBDIR + + + + GSSAPILIBS + + + + GSSAPI_CONFIGURE_ARGS + + + + The flags option can be given + alongside base, + heimdal, or mit to + automatically add GSSAPICPPFLAGS, + GSSAPILDFLAGS, and + GSSAPILIBS to + CFLAGS, LDFLAGS, + and LDADD, respectively. For + example, use base,flags. + + The bootstrap option is a special + prefix only for use by + security/krb5 and + security/heimdal. For + example, use bootstrap,mit. - - fortran + + Typical Use - gcc (default), - ifort - - Uses the Fortran compiler from either GNU or Intel. - - - - fuse - - (none) - - The port will depend on the FUSE library and handle the - dependency on the kernel module depending on the version of - &os;. - - - - gettext - - (none), lib (default), - build, run - - Uses devel/gettext. By - default, with no arguments or with the lib - argument, implies a library dependency on - libintl.so. build and - run implies, respectively a build-time and a - run-time dependency on xgettext. - - - - gmake - - (none) - - Uses devel/gmake as a - build-time dependency and sets up the environment to use - gmake as the default make - for the build. - - - - gssapi - - (none), base (default), - heimdal, mit, - flags, bootstrap - - - Handle dependencies needed by consumers of the - GSS-API. Only libraries that provide the - Kerberos mechanism are available. - By default, or set to base, - the GSS-API library from the base system is used. - Can also be set to heimdal to use security/heimdal, or - mit to use security/krb5. - - When the local Kerberos - installation is not in LOCALBASE, set - HEIMDAL_HOME (for heimdal) - or KRB5_HOME (for krb5) to - the location of the Kerberos - installation. - - These variables are exported for the ports to use: - - - GSSAPIBASEDIR - GSSAPICPPFLAGS - GSSAPIINCDIR - GSSAPILDFLAGS - GSSAPILIBDIR - GSSAPILIBS - GSSAPI_CONFIGURE_ARGS - - - The flags option can be given alongside - base, heimdal, or - mit to automatically add - GSSAPICPPFLAGS, - GSSAPILDFLAGS, and - GSSAPILIBS to CFLAGS, - LDFLAGS, and LDADD, - respectively. For example, use - base,flags. - - The bootstrap option is a special prefix - only for use by security/krb5 - and security/heimdal. For - example, use bootstrap,mit. - - - Typical Use - - OPTIONS_SINGLE= GSSAPI + OPTIONS_SINGLE= GSSAPI OPTIONS_SINGLE_GSSAPI= GSSAPI_BASE GSSAPI_HEIMDAL GSSAPI_MIT GSSAPI_NONE GSSAPI_BASE_USES= gssapi @@ -354,621 +396,668 @@ GSSAPI_HEIMDAL_CONFIGURE_ON= --with-gssa GSSAPI_MIT_USES= gssapi:mit GSSAPI_MIT_CONFIGURE_ON= --with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS} GSSAPI_NONE_CONFIGURE_ON= --without-gssapi - - - - - iconv - - (none), lib, build, - patch - - Uses iconv functions, either from the port - converters/libiconv as a build-time - and run-time dependency, or from the base system on 10-CURRENT - after a native iconv was committed in - 254273. By default, with no arguments or - with the lib argument, implies - iconv with build-time and run-time - dependencies. build implies a build-time - dependency, and patch implies a patch-time - dependency. For more information see - . - - - - imake - - (none), env, - notall - - Uses devel/imake as - build-time dependency. If the env argument is - given, only setup the environment and do not define any target. - If the notall argument is given does not pass - -a to xmkmf. - - - - kmod - - (none) - - Fills in the boilerplate for kernel module ports, currently: - - - - Add kld to - CATEGORIES. - - - - Set SSP_UNSAFE. - - - - Set IGNORE if the kernel sources are - not found in SRC_BASE. - - - - Define KMODDIR to - /boot/modules by - default, add it to PLIST_SUB and - MAKE_ENV, and create it upon - installation. If KMODDIR is set to - /boot/kernel, it will - be rewritten to - /boot/modules. This - prevents breaking packages when upgrading the kernel due to - /boot/kernel being - renamed to - /boot/kernel.old in - the process. - - - - Handle cross-referencing kernel modules upon - installation and deinstallation. - - - - - - lha - (none) - Set EXTRACT_SUFX to - .lzh - - - - libtool - - (none) - - Patches libtool scripts. This should be - added to all ports that use libtool. - - - - lua - - (none), XY+, XY, - build, run - - Adds a dependency on Lua. By - default this is a library undependency, unless overridden by the - build or run option. The - default version is 5.2, unless set by the XY - parameter (e.g., 51 or - 52+). - - - - makeself - - (none) - - Indicates that the distribution files are makeself - archives and sets the appropriate dependencies. - - - - mono - - (none) - - Adds a dependency on the Mono - (currently only C#) framework by setting the appropriate - dependencies. - - - - motif - - (none) - - Uses x11-toolkits/open-motif - as a library dependency. End users can set - WANT_LESSTIF for the dependency to be on - x11-toolkits/lesstif instead of - x11-toolkits/open-motif. - - - - ncurses - - (none), base, - port - - Uses ncurses, and causes some - useful variables to be set. - - - - ninja - - (none) - - Uses ninja to build the port. End - users can set NINJA_VERBOSE for verbose - output. - - - - openal - - al, soft (default), - si, alut - - Uses OpenAL. The backend can be - specified, with the software implementation as the default. The - user can specify a preferred backend with the - WANT_OPENAL knob. Valid values for this knob - are soft (default) and - si. - - - - pathfix - - (none) - - Look for the Makefile.in and - configure files in the port's associated - sources and fix common paths to make sure they respect the &os; - hierarchy. - - - - perl5 - - (none) - - Depends on Perl. These variables - can be set: - - - - PERL_VERSION: Full version of - Perl to use, or the default if - not set - - - - PERL_ARCH: Directory name of - architecture dependent libraries, defaults to - mach - - - - PERL_PORT: Name of the - Perl port to be installed, the - default is derived from - PERL_VERSION - - - - SITE_PERL: Directory name for - site specific Perl - packages - - - - USE_PERL5: Phases in which to - use Perl, can be - extract, patch, - build, install, or - run. It can also be - configure, modbuild, - or modbuildtiny when - Makefile.PL, - Build.PL, or the Module::Build::Tiny - flavor of Build.PL is required. If - there is a .packlist referencing - ${STAGEDIR}, then - fixpacklist should be used to patch it. - It defaults to build run. - - - - - - pgsql - - (none), X.Y, X.Y+, - X.Y- - - - Provide support for PostgreSQL. Maintainer can set version - required. Minimum and maximum versions can be specified; e.g., - 9.0-, 8.4+. - - Add PostgreSQL component dependency, using - WANT_PGSQL=component[:target]. e.g., - WANT_PGSQL=server:configure pltcl plperl For - the full list use - make -V _USE_PGSQL_DEP. - - - - pkgconfig - - (none), build (default), - run, both - - Uses devel/pkgconf. With no - arguments or with the build argument, it - implies pkg-config as a build-time dependency. - run implies a run-time dependency and - both implies both run-time and build-time - dependencies. - - - - pure - - (none), ffi - - Uses lang/pure. Largely used - for building related pure ports. With - the ffi argument, it implies - devel/pure-ffi as a run-time - dependency. - - - - qmail - - (none), build, run, - both, vars - - Uses mail/qmail. 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 *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***