diff --git a/en_US.ISO8859-1/books/porters-handbook/uses.xml b/en_US.ISO8859-1/books/porters-handbook/uses.xml index 4288ccfdc7..354f82a2a0 100644 --- a/en_US.ISO8859-1/books/porters-handbook/uses.xml +++ b/en_US.ISO8859-1/books/porters-handbook/uses.xml @@ -1,307 +1,343 @@ ada (none) Depends on an Ada-capable compiler, and sets CC accordingly. bison (none), build, run, both Implies that the port uses 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 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 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 . + + compiler + (none), c++11-lang, + c++11-lib, c11, + openmp, 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 C11 or OpenMP, 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. + + + desktop-file-utils (none) Implies that the port uses the 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. 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. 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. fuse (none) Implies 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, build, run Implies that the port uses devel/gettext in one way or another. By default, with no arguments or with the lib argument, implies gettext with build-time and run-time dependencies, build implies a build-time dependency, and run implies a run-time dependency. gmake (none) Implies that the port uses devel/gmake as build-time dependency. iconv (none), lib, build, patch Implies that the port 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) Implies that the port uses devel/imake as build-time dependency. 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. motif (none) Implies that the ports uses devel/open-motif as a library dependency. End users can set WANT_LESSTIF for the dependency to be on devel/lesstif instead of devel/open-motif. ncurses (none), base, port Implies that the port uses ncurses, and causes some useful variables to be set. 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. pkgconfig (none), build, run, both Implies that the port uses devel/pkgconf in one way or another. 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 Implies that the port uses lang/pure in one way or another, but largely is 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 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 will only set QMAIL variables for the port to use. readline (none), port Implies that the port uses readline as library dependency, and sets CPPFLAGS and LDFLAGS as necessary. shared-mime-info (none) Implies that the port uses update-mime-database from misc/shared-mime-info. This uses will automatically add a post-install step in such a way that the port itself still can specify there own post-install step if needed. It also insert lines into the plist for package install and removal to run update-mime-data with the correct arguments. shebangfix (none) A lot of software uses incorrect locations for script interpreters, most notably /usr/bin/perl and /bin/bash. This fixes shebang lines in scripts listed in SHEBANG_FILES. Currently Perl, Python, Bash, Ruby, and PHP are supported by default. To support another interpreter, set SHEBANG_LANG (for example SHEBANG_LANG=lua), then lua_OLD_CMD and lua_CMD. zenoss (none) Implies the port uses net-mgmt/zenoss in one way or another, but largely is used for building zenoss related zenpack ports. zope (none) Implies that the port uses www/zope in one way or another, but is largely used for building zope related ports. ZOPE_VERSION can be used by a port to indicate that a specific version of zope shall be used.