diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index c571a7d15a..ce23b68af7 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -1,2408 +1,2408 @@ --- title: Chapter 17. Using USES Macros prev: books/porters-handbook/keeping-up next: books/porters-handbook/versions description: USES macros make it easy to declare requirements and settings for a FreeBSD Port tags: ["uses", "macros", "introduction", "guide"] showBookMenu: true weight: 17 path: "/books/porters-handbook/uses/" --- [[uses]] = Using `USES` Macros :doctype: book :toc: macro :toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :sectnumoffset: 17 :partnums: :source-highlighter: rouge :experimental: :images-path: books/porters-handbook/ ifdef::env-beastie[] ifdef::backend-html5[] :imagesdir: ../../../../images/{images-path} endif::[] ifndef::book[] include::shared/authors.adoc[] include::shared/mirrors.adoc[] include::shared/releases.adoc[] include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] include::shared/{{% lang %}}/urls.adoc[] toc::[] endif::[] ifdef::backend-pdf,backend-epub3[] include::../../../../../shared/asciidoctor.adoc[] endif::[] endif::[] ifndef::env-beastie[] toc::[] include::../../../../../shared/asciidoctor.adoc[] endif::[] [[uses-intro]] == An Introduction to `USES` `USES` macros make it easy to declare requirements and settings for a port. They can add dependencies, change building behavior, add metadata to packages, and so on, all by selecting simple, preset values. Each section in this chapter describes a possible value for `USES`, along with its possible arguments. Arguments are appended to the value after a colon (`:`). Multiple arguments are separated by commas (`,`). [[uses-intro-ex1]] .Using Multiple Values [example] ==== [.programlisting] .... USES= bison perl .... ==== [[uses-intro-ex2]] .Adding an Argument [example] ==== [.programlisting] .... USES= tar:xz .... ==== [[uses-intro-ex3]] .Adding Multiple Arguments [example] ==== [.programlisting] .... USES= drupal:7,theme .... ==== [[uses-intro-ex4]] .Mixing it All Together [example] ==== [.programlisting] .... USES= pgsql:9.3+ cpe python:2.7,build .... ==== [[uses-7z]] == `7z` Possible arguments: (none), `p7zip`, `partial` Extract using man:7z[1] instead of man:bsdtar[1] and sets `EXTRACT_SUFX=.7z`. The `p7zip` option forces a dependency on the `7z` from package:archivers/p7zip[] if the one from the base system is not able to extract the files. `EXTRACT_SUFX` is not changed if the `partial` option is used, this can be used if the main distribution file does not have a [.filename]#.7z# extension. [[uses-ada]] == `ada` Possible arguments: (none), `6`, `12`, `(run)` Depends on an Ada-capable compiler, and sets `CC` accordingly. Defaults to use `gcc6-aux` from ports. [[uses-autoreconf]] == `autoreconf` Possible arguments: (none), `build` Runs `autoreconf`. It encapsulates the `aclocal`, `autoconf`, `autoheader`, `automake`, `autopoint`, and `libtoolize` commands. Each command applies to [.filename]#${AUTORECONF_WRKSRC}/configure.ac# or its old name, [.filename]#${AUTORECONF_WRKSRC}/configure.in#. If [.filename]#configure.ac# defines subdirectories with their own [.filename]#configure.ac# using `AC_CONFIG_SUBDIRS`, `autoreconf` will recursively update those as well. The `:build` argument only adds build time dependencies on those tools but does not run `autoreconf`. A port can set `AUTORECONF_WRKSRC` if `WRKSRC` does not contain the path to [.filename]#configure.ac#. [[uses-blaslapack]] == `blaslapack` Possible arguments: (none), `atlas`, `netlib` (default), `gotoblas`, `openblas` Adds dependencies on Blas / Lapack libraries. [[uses-bdb]] == `bdb` Possible arguments: (none), `48`, `5` (default), `6` Add dependency on the Berkeley DB library. Default to package:databases/db5[]. It can also depend on package:databases/db48[] when using the `:48` argument or package:databases/db6[] with `:6`. It is possible to declare a range of acceptable values, `:48+` finds the highest installed version, and falls back to 4.8 if nothing else is installed. `INVALID_BDB_VER` can be used to specify versions which do not work with this port. The framework exposes the following variables to the port: `BDB_LIB_NAME`:: The name of the Berkeley DB library. For example, when using package:databases/db5[], it contains `db-5.3`. `BDB_LIB_CXX_NAME`:: The name of the Berkeley DBC++ library. For example, when using package:databases/db5[], it contains `db_cxx-5.3`. `BDB_INCLUDE_DIR`:: The location of the Berkeley DB include directory. For example, when using package:databases/db5[], it will contain `${LOCALBASE}/include/db5`. `BDB_LIB_DIR`:: The location of the Berkeley DB library directory. For example, when using package:databases/db5[], it contains `${LOCALBASE}/lib`. `BDB_VER`:: The detected Berkeley DB version. For example, if using `USES=bdb:48+` and Berkeley DB 5 is installed, it contains `5`. [IMPORTANT] ==== package:databases/db48[] is deprecated and unsupported. It must not be used by any port. ==== [[uses-bison]] == `bison` Possible arguments: (none), `build`, `run`, `both` Uses package: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. [[uses-budgie]] == `budgie` Possible arguments: (none) Provide support for the Budgie desktop environment. Use `USE_BUDGIE` to select the components needed for the port. See crossref:special[using-budgie,Using Budgie] for more information. [[uses-cabal]] == `cabal` [IMPORTANT] ==== Ports should not be created for Haskell libraries, see crossref:special[haskell-libs,Haskell Libraries] for more information. ==== Possible arguments: (none), `hpack`, `nodefault` Sets default values and targets used to build Haskell software using Cabal. A build dependency on the Haskell compiler port (package:lang/ghc[]) is added. If there is some other version of GHC already listed in the `BUILD_DEPENDS` variable (for example, package:lang/ghc810[]), it would be used instead. If the `hpack` argument is given, a build dependency on package:devel/hs-hpack[] is added and `hpack` is invoked at configuration step to generate .cabal file. If the `nodefault` argument is given, the framework will not try to pull the main distribution file from the Hackage. This argument is implicitly added if `USE_GITHUB` or `USE_GITLAB` is present. The framework provides the following variables: `CABAL_REVISION`:: Haskell packages hosted on Hackage may have revisions. Set this knob to an integer number to pull in revised package description. `USE_CABAL`:: If the software uses Haskell dependencies, list them in this variable. Each item should be present on Hackage and be listed in form `packagename-_0.1.2_`. Dependencies can have revisions too, which are specified after the `_` symbol. Automatic generation of the dependency list is supported, see crossref:special[using-cabal,Building Haskell Applications with `cabal`]. `CABAL_FLAGS`:: List of flags to be passed to `cabal-install` during the configuring and building stage. The flags are passed verbatim. This variable is usually used to enable or disable flags that are declared in the .cabal file. Pass `foo` to enable the `foo` flag and `-foo` to disable it. `CABAL_EXECUTABLES`:: List of executable files installed by the port. Default value: `${PORTNAME}`. Consult the .cabal file of the project being ported to get a list of possible values for this variable. Each value corresponds to an `executable` stanza in the .cabal file. Items from this list are automatically added to pkg-plist. `SKIP_CABAL_PLIST`:: If defined, do not add items from `${CABAL_EXECUTABLES}` to pkg-plist. `opt_USE_CABAL`:: Adds items to `${USE_CABAL}` depending on `opt` option. `opt_CABAL_EXECUTABLES`:: Adds items to `${CABAL_EXECUTABLES}` depending on `opt` option. `opt_CABAL_FLAGS`:: If `opt` is enabled, append the value to `${CABAL_FLAGS}`. Otherwise, append `-value` to disable the flag. Note that this behavior is slightly different from the plain `CABAL_FLAGS` as it does not accept values starting with `-`. `CABAL_WRAPPER_SCRIPTS`:: A subset of `${CABAL_EXECUTABLES}` containing Haskell programs to be wrapped into a shell script that sets `*_datadir` environment variables before running the program. This also causes the actual Haskell binary to be installed under `libexec/cabal/` directory. This knob is needed for Haskell programs that install their data files under `share/` directory. `FOO_DATADIR_VARS`:: List of extra Haskell packages, whose data files should be accessible by the executable named `FOO`. The executable should be a part of `${CABAL_WRAPPER_SCRIPTS}`. Haskell packages listed there should not have a version suffix. `CABAL_PROJECT`:: Some Haskell projects may already have a `cabal.project` file, which is also generated by the ports framework. If that is the case, use this variable to specify what to do with the original `cabal.project`. Setting this variable to `remove` will cause the original file to be removed. Setting this variable to `append` will: . Move the original file to `cabal.project.${PORTNAME}` during the `extract` stage. . Concatenate the original `cabal.project.${PORTNAME}` and the generated `cabal.project` into a single file after the `patch` stage. Using `append` makes it possible to perform patching on the original file before it gets merged. [[uses-cargo]] == `cargo` Possible arguments: (none) Uses Cargo for configuring, building, and testing. It can be used to port Rust applications that use the Cargo build system. For more information see crossref:special[using-cargo,Building Rust Applications with `cargo`]. [[uses-charsetfix]] == `charsetfix` Possible arguments: (none) Prevents the port from installing [.filename]#charset.alias#. This must be installed only by package:converters/libiconv[]. `CHARSETFIX_MAKEFILEIN` can be set to a path relative to `WRKSRC` if [.filename]#charset.alias# is not installed by [.filename]#${WRKSRC}/Makefile.in#. [[uses-cmake]] == `cmake` Possible arguments: (none), `insource`, `noninja`, `run`, `testing` Use CMake for configuring the port and generating a build system. By default an out-of-source build is performed, leaving the sources in `WRKSRC` free from build artifacts. With the `insource` argument, an in-source build will be performed instead. This argument should be an exception, used only when a regular out-of-source build does not work. By default Ninja (package:devel/ninja[]) is used for the build. In some cases this does not work correctly. With the `noninja` argument, the build will use regular `make` for builds. This argument should only be used if a Ninja-based build does not work. With the `run` argument, a run dependency is registered in addition to a build dependency. With the `testing` argument, a test-target is added that uses CTest. When running tests the port will be re-configured for testing and re-built. For more information see crossref:special[using-cmake,Using `cmake`]. [[uses-compiler]] == `compiler` Possible arguments: (none), `env` (default, implicit), `{cpp}17-lang`, `{cpp}14-lang`, `{cpp}11-lang`, `gcc-{cpp}11-lib`, `{cpp}11-lib`, `{cpp}0x`, `c11`, `nestedfct`, `features` Determines which compiler to use based on any given wishes. Use `{cpp}17-lang` if the port needs a {cpp}17-capable compiler, `{cpp}14-lang` if the port needs a {cpp}14-capable compiler, `{cpp}11-lang` if the port needs a {cpp}11-capable compiler, `gcc-{cpp}11-lib` if the port needs the `g++` compiler with a {cpp}11 library, or `{cpp}11-lib` if the port needs a {cpp}11-ready standard library. If the port needs a compiler understanding {cpp}0X, C11 or nested functions, the corresponding parameters should be used. Use `features` to request a list of features supported by the default compiler. After including [.filename]#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 {cpp} library. [[uses-cpe]] == `cpe` Possible arguments: (none) Include Common Platform Enumeration (CPE) information in package manifest as a CPE 2.3 formatted string. See the https://scap.nist.gov/specifications/cpe/[CPE specification] for details. To add CPE information to a port, follow these steps: [.procedure] . Search for the official CPE entry for the software product either by using the NVD's https://web.nvd.nist.gov/view/cpe/search[CPE search engine] or in the https://nvd.nist.gov/feeds/xml/cpe/dictionary/official-cpe-dictionary_v2.3.xml.gz[official CPE dictionary] (warning, very large XML file). _Do not ever make up CPE data._ . Add `cpe` to `USES` and compare the result of `make -V CPE_STR` to the CPE dictionary entry. Continue one step at a time until `make -V CPE_STR` is correct. . If the product name (second field, defaults to `PORTNAME`) is incorrect, define `CPE_PRODUCT`. . If the vendor name (first field, defaults to `CPE_PRODUCT`) is incorrect, define `CPE_VENDOR`. . If the version field (third field, defaults to `PORTVERSION`) is incorrect, define `CPE_VERSION`. . If the update field (fourth field, defaults to empty) is incorrect, define `CPE_UPDATE`. . If it is still not correct, check [.filename]#Mk/Uses/cpe.mk# for additional details, or contact the {ports-secteam}. . Derive as much as possible of the CPE name from existing variables such as `PORTNAME` and `PORTVERSION`. Use variable modifiers to extract the relevant portions from these variables rather than hardcoding the name. . _Always_ run `make -V CPE_STR` and check the output before committing anything that changes `PORTNAME` or `PORTVERSION` or any other variable which is used to derive `CPE_STR`. [[uses-cran]] == `cran` Possible arguments: (none), `auto-plist`, `compiles` Uses the Comprehensive R Archive Network. Specify `auto-plist` to automatically generate [.filename]#pkg-plist#. Specify `compiles` if the port has code that need to be compiled. [[uses-desktop-file-utils]] == `desktop-file-utils` Possible arguments: (none) Uses update-desktop-database from package:devel/desktop-file-utils[]. An extra post-install step will be run without interfering with any post-install steps already in the port [.filename]#Makefile#. A line with <> will be added to the plist. Only use this macro if the port provides a `.desktop` file which contains a `MimeType` entry. [[uses-desthack]] == `desthack` Possible arguments: (none) Changes the behavior of GNU configure to properly support `DESTDIR` in case the original software does not. [[uses-display]] == `display` Possible arguments: (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. [[uses-dos2unix]] == `dos2unix` Possible arguments: (none) The port has files with line endings in DOS format which need to be converted. Several variables can be set to control which files will be converted. The default is to convert _all_ files, including binaries. See crossref:slow-porting[slow-patch-automatic-replacements,Simple Automatic Replacements] 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. * `DOS2UNIX_WRKSRC`: the directory from which to start the conversions. Defaults to `${WRKSRC}`. [[uses-drupal]] == `drupal` Possible arguments: `7`, `module`, `theme` Automate installation of a port that is a Drupal theme or module. Use with the version of Drupal that the port is expecting. For example, `USES=drupal:7,module` says that this port creates a Drupal 7 module. A Drupal 7 theme can be specified with `USES=drupal:7,theme`. [[uses-ebur128]] == `ebur128` Possible arguments: (none), `build`, `lib`, `run`, `test` Adds a dependency on package:audio/ebur128[]. It allows to transparently depend on the `rust` or `legacy` variants by using `DEFAULT_VERSIONS` in [.filename]#make.conf#. For instance, to use the legacy version, use `DEFAULT_VERSIONS+=ebur128=legacy` When no arguments are used, the behavior is the same as if the `lib` argument was provided. The rest of the arguments provide the corresponding category of dependency. [[uses-eigen]] == `eigen` Possible arguments: 2, 3, build (default), run Add dependency on package:math/eigen[]. [[uses-elfctl]] == `elfctl` Possible arguments: (none) Change an ELF binary's feature control note by setting ELF_FEATURES. [[uses-elfct-ex1]] .Uses=elfctl [example] ==== [.programlisting] .... USES= elfctl ELF_FEATURES= featurelist:path/to/file1 \ featurelist:path/to/file1 \ featurelist:path/to/file2 .... ==== The format of `featurelist` is described in man:elfctl[1]. The file paths are relative to ${BUILD_WRKSRC}. [[uses-erlang]] == `erlang` Possible arguments: (none), `enc`, `rebar`, `rebar3` Adds a build and run time dependency on package:lang/erlang[]. Depending on the argument, it adds additional build dependencies. `enc` adds a dependency on package:devel/erlang-native-compiler[], `rebar` adds a dependency on package:devel/rebar[] and `rebar3` adds a dependency on package:devel/rebar3[]. In addition, the following variables are available to the port: * `ERL_APP_NAME`: Erlang app name as installed in Erlang's lib dir (minus version) * `ERL_APP_ROOT`: Root directory for this Erlang app * `REBAR_CMD`: Path to the "rebar" command * `REBAR3_CMD`: Path to the "rebar3" command * `REBAR_PROFILE`: Rebar profile * `REBAR_TARGETS`: Rebar target list (usually compile, maybe escriptize) * `ERL_BUILD_NAME`: Build name for rebar3 * `ERL_BUILD_DEPS`: List of BUILD_DEPENDS in category/portname format * `ERL_RUN_DEPS`: List of RUN_DEPENDS in category/portname format * `ERL_DOCS`: List of documentation files and directories [[uses-fakeroot]] == `fakeroot` Possible arguments: (none) Changes some default behavior of build systems to allow installing as a user. See https://wiki.debian.org/FakeRoot[] for more information on `fakeroot`. [[uses-fam]] == `fam` Possible arguments: (none), `fam`, `gamin` Uses a File Alteration Monitor as a library dependency, either package:devel/fam[] or package:devel/gamin[]. End users can set WITH_FAM_SYSTEM to specify their preference. [[uses-firebird]] == `firebird` Possible arguments: (none), `25` Add a dependency to the client library of the Firebird database. [[uses-fonts]] == `fonts` Possible arguments: (none), `fc`, `fontsdir` (default), `none` Adds a runtime dependency on tools needed to register fonts. Depending on the argument, add a `crossref:plist[plist-keywords-fc,@fc] ${FONTSDIR}` line, `crossref:plist[plist-keywords-fontsdir,@fontsdir] ${FONTSDIR}` line, or no line if the argument is `none`, to the plist. `FONTSDIR` defaults to [.filename]#${PREFIX}/share/fonts/${FONTNAME}# and `FONTNAME` to `${PORTNAME}`. Add `FONTSDIR` to `PLIST_SUB` and `SUB_LIST` [[uses-fortran]] == `fortran` Possible arguments: `gcc` (default) Uses the GNU Fortran compiler. [[uses-fuse]] == `fuse` Possible arguments: `2` (default), `3` The port will depend on the FUSE library and handle the dependency on the kernel module depending on the version of FreeBSD. [[uses-gem]] == `gem` Possible arguments: (none), `noautoplist` Handle building with RubyGems. If `noautoplist` is used, the packing list is not generated automatically. This implies `USES=ruby`. [[uses-gettext]] == `gettext` Possible arguments: (none) Deprecated. Will include both <> and <>. [[uses-gettext-runtime]] == `gettext-runtime` Possible arguments: (none), `lib` (default), `build`, `run` Uses package:devel/gettext-runtime[]. By default, with no arguments or with the `lib` argument, implies a library dependency on [.filename]#libintl.so#. `build` and `run` implies, respectively a build-time and a run-time dependency on [.filename]#gettext#. [[uses-gettext-tools]] == `gettext-tools` Possible arguments: (none), `build` (default), `run` Uses package:devel/gettext-tools[]. By default, with no argument, or with the `build` argument, a build time dependency on [.filename]#msgfmt# is registered. With the `run` argument, a run-time dependency is registered. [[uses-ghostscript]] == `ghostscript` Possible arguments: _X_, `build`, `run`, `nox11` A specific version _X_ can be used. Possible versions are `7`, `8`, `9`, and `agpl` (default). `nox11` indicates that the `-nox11` version of the port is required. `build` and `run` add build- and run-time dependencies on Ghostscript. The default is both build- and run-time dependencies. [[uses-gl]] == `gl` Possible arguments: (none) Provides an easy way to depend on GL components. The components should be listed in `USE_GL`. The available components are: `egl`:: add a library dependency on [.filename]#libEGL.so# from package:graphics/libglvnd[] `gbm`:: Add a library dependency on [.filename]#libgbm.so# from package:graphics/mesa-libs[] `gl`:: Add a library dependency on [.filename]#libGL.so# from package:graphics/libglvnd[] `glesv2`:: Add a library dependency on [.filename]#libGLESv2.so# from package:graphics/libglvnd[] `glew`:: Add a library dependency on [.filename]#libGLEW.so# from package:graphics/glew[] `glu`:: Add a library dependency on [.filename]#libGLU.so# from package:graphics/libGLU[] `glut`:: Add a library dependency on [.filename]#libglut.so# from package:graphics/freeglut[] `opengl`:: Add a library dependency on [.filename]#libOpenGL.so# from package:graphics/libglvnd[] [[uses-gmake]] == `gmake` Possible arguments: (none) Uses package:devel/gmake[] as a build-time dependency and sets up the environment to use `gmake` as the default `make` for the build. [[uses-gnome]] == `gnome` Possible arguments: (none) Provides an easy way to depend on GNOME components. The components should be listed in `USE_GNOME`. The available components are: * `atk` * `atkmm` * `cairo` * `cairomm` * `dconf` * `esound` * `evolutiondataserver3` * `gconf2` * `gconfmm26` * `gdkpixbuf` * `gdkpixbuf2` * `glib12` * `glib20` * `glibmm` * `gnomecontrolcenter3` * `gnomedesktop3` * `gnomedocutils` * `gnomemenus3` * `gnomemimedata` * `gnomeprefix` * `gnomesharp20` * `gnomevfs2` * `gsound` * `gtk-update-icon-cache` * `gtk12` * `gtk20` * `gtk30` * `gtkhtml3` * `gtkhtml4` * `gtkmm20` * `gtkmm24` * `gtkmm30` * `gtksharp20` * `gtksourceview` * `gtksourceview2` * `gtksourceview3` * `gtksourceviewmm3` * `gvfs` * `intlhack` * `intltool` * `introspection` * `libartlgpl2` * `libbonobo` * `libbonoboui` * `libgda5` * `libgda5-ui` * `libgdamm5` * `libglade2` * `libgnome` * `libgnomecanvas` * `libgnomekbd` * `libgnomeprint` * `libgnomeprintui` * `libgnomeui` * `libgsf` * `libgtkhtml` * `libgtksourceviewmm` * `libidl` * `librsvg2` * `libsigc++12` * `libsigc++20` * `libwnck` * `libwnck3` * `libxml++26` * `libxml2` * `libxslt` * `metacity` * `nautilus3` * `orbit2` * `pango` * `pangomm` * `pangox-compat` * `py3gobject3` * `pygnome2` * `pygobject` * `pygobject3` * `pygtk2` * `pygtksourceview` * `referencehack` * `vte` * `vte3` The default dependency is build- and run-time, it can be changed with `:build` or `:run`. For example: [.programlisting] .... USES= gnome USE_GNOME= gnomemenus3:build intlhack .... See crossref:special[using-gnome,Using GNOME] for more information. [[uses-go]] == `go` [IMPORTANT] ==== Ports should not be created for Go libs, see crossref:special[go-libs,Go Libraries] for more information. ==== Possible arguments: (none), `N.NN`, `N.NN-devel`, `modules`, `no_targets`, `run` Sets default values and targets used to build Go software. A build dependency on the Go compiler port is added, port maintainers can set version required. By default the build is performed in GOPATH mode. If Go software uses modules, the modules-aware mode can be switched on with `modules` argument. `no_targets` will setup build environment like `GO_ENV`, `GO_BUILDFLAGS` but skip creating extract and build targets. `run` will also add a run dependency on the Go compiler port. The build process is controlled by several variables: `GO_MODULE`:: The name of the application module as specified by the `module` directive in `go.mod`. In most cases, this is the only required variable for ports that use Go modules. `GO_PKGNAME`:: The name of the Go package when building in GOPATH mode. This is the directory that will be created in `${GOPATH}/src`. If not set explicitly and `GH_SUBDIR` or `GL_SUBDIR` is present, `GO_PKGNAME` will be inferred from it. It is not needed when building in modules-aware mode. `GO_TARGET`:: The packages to build. The default value is `${GO_PKGNAME}`. `GO_TARGET` can also be a tuple in the form `package:path` where path can be either a simple filename or a full path starting with `${PREFIX}`. `GO_TESTTARGET`:: The packages to test. The default value is `./...` (the current package and all subpackages). `CGO_CFLAGS`:: Additional `CFLAGS` values to be passed to the C compiler by `go`. `CGO_LDFLAGS`:: Additional `LDFLAGS` values to be passed to the C compiler by `go`. `GO_BUILDFLAGS`:: Additional build arguments to be passed to `go build`. `GO_TESTFLAGS`:: Additional build arguments to be passed to `go test`. See crossref:special[using-go,Building Go Applications] for usage examples. [[uses-gperf]] == `gperf` Possible arguments: (none) Add a buildtime dependency on package:devel/gperf[] if `gperf` is not present in the base system. [[uses-grantlee]] == `grantlee` Possible arguments: `5`, `selfbuild` Handle dependency on Grantlee. Specify `5` to depend on the Qt5 based version, package:devel/grantlee5[]. `selfbuild` is used internally by package:devel/grantlee5[] to get their versions numbers. [[uses-groff]] == `groff` Possible arguments: `build`, `run`, `both` Registers a dependency on package:textproc/groff[] if not present in the base system. [[uses-gssapi]] == `gssapi` Possible arguments: (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 package:security/heimdal[], or `mit` to use package: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 package:security/krb5[] and package:security/heimdal[]. For example, use `bootstrap,mit`. [[uses-gssapi-ex1]] .Typical Use [example] ==== [.programlisting] .... OPTIONS_SINGLE= GSSAPI OPTIONS_SINGLE_GSSAPI= GSSAPI_BASE GSSAPI_HEIMDAL GSSAPI_MIT GSSAPI_NONE GSSAPI_BASE_USES= gssapi GSSAPI_BASE_CONFIGURE_ON= --with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS} GSSAPI_HEIMDAL_USES= gssapi:heimdal GSSAPI_HEIMDAL_CONFIGURE_ON= --with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS} GSSAPI_MIT_USES= gssapi:mit GSSAPI_MIT_CONFIGURE_ON= --with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS} GSSAPI_NONE_CONFIGURE_ON= --without-gssapi .... ==== [[uses-gstreamer]] == `gstreamer` Possible arguments: (none) Provides an easy way to depend on GStreamer components. The components should be listed in `USE_GSTREAMER`. The available components are: * `a52dec` * `aalib` * `amrnb` * `amrwbdec` * `aom` * `assrender` * `bad` * `bs2b` * `cairo` * `cdio` * `cdparanoia` * `chromaprint` * `curl` * `dash` * `dtls` * `dts` * `dv` * `dvd` * `dvdread` * `editing-services` * `faac` * `faad` * `flac` * `flite` * `gdkpixbuf` * `gl` * `gme` * `gnonlin` * `good` * `gsm` * `gtk4` * `gtk` * `hal` * `hls` * `jack` * `jpeg` * `kate` * `kms` * `ladspa` * `lame` * `libav` * `libcaca` * `libde265` * `libmms` * `libvisual` * `lv2` * `mm` * `modplug` * `mpeg2dec` * `mpeg2enc` * `mpg123` * `mplex` * `musepack` * `neon` * `ogg` * `opencv` * `openexr` * `openh264` * `openjpeg` * `openmpt` * `opus` * `pango` * `png` * `pulse` * `qt` * `resindvd` * `rsvg` * `rtmp` * `shout2` * `sidplay` * `smoothstreaming` * `sndfile` * `sndio` * `soundtouch` * `soup` * `spandsp` * `speex` * `srtp` * `taglib` * `theora` * `ttml` * `twolame` * `ugly` * `v4l2` * `vorbis` * `vpx` * `vulkan` * `wavpack` * `webp` * `webrtcdsp` * `x264` * `x265` * `x` * `ximagesrc` * `zbar` [[uses-guile]] == `guile` Possible arguments: (none), `_X.Y_`, `flavors`, `build`, `run`, `alias`, `conflicts` Adds a dependency on Guile. By default this is a library dependency on the appropriate `libguile*.so`, unless overridden by the `build` and/or `run` option. The `alias` option configures `BINARY_ALIAS` appropriately (see crossref:makefiles[binary-alias,Use `BINARY_ALIAS`]). The default version is set by the usual `DEFAULT_VERSIONS` mechanism; if the default version is not one of the listed versions, then the latest available listed version is used. Applications using Guile are normally built for only a single Guile version. However, extension or library modules should use the `flavors` option to build with multiple flavors. For more information see crossref:special[using-guile,Using Guile]. [[uses-horde]] == `horde` Possible arguments: (none) Add buildtime and runtime dependencies on package:devel/pear-channel-horde[]. Other Horde dependencies can be added with `USE_HORDE_BUILD` and `USE_HORDE_RUN`. See crossref:special[php-horde,Horde Modules] for more information. [[uses-iconv]] == `iconv` Possible arguments: (none), `lib`, `build`, `patch`, `translit`, `wchar_t` Uses `iconv` functions, either from the port package:converters/libiconv[] as a build-time and run-time dependency, or from the base system. 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. If the port uses the `WCHAR_T` or `//TRANSLIT` iconv extensions, add the relevant arguments so that the correct iconv is used. For more information see crossref:special[using-iconv,Using `iconv`]. [[uses-imake]] == `imake` Possible arguments: (none), `env`, `notall`, `noman` Add package:devel/imake[] as a build-time dependency and run `xmkmf -a` during the `configure` stage. If the `env` argument is given, the `configure` target is not set. If the `-a` flag is a problem for the port, add the `notall` argument. If `xmkmf` does not generate a `install.man` target, add the `noman` argument. [[uses-kde]] == `kde` Possible arguments: `5` Add dependency on KDE components. See crossref:special[using-kde,Using KDE] for more information. [[uses-kmod]] == `kmod` Possible arguments: (none), `debug` 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 [.filename]#/boot/modules# by default, add it to `PLIST_SUB` and `MAKE_ENV`, and create it upon installation. If `KMODDIR` is set to [.filename]#/boot/kernel#, it will be rewritten to [.filename]#/boot/modules#. This prevents breaking packages when upgrading the kernel due to [.filename]#/boot/kernel# being renamed to [.filename]#/boot/kernel.old# in the process. * Handle cross-referencing kernel modules upon installation and deinstallation, using crossref:plist[plist-keywords-kld,`@kld`]. * If the `debug` argument is given, the port can install a debug version of the module into [.filename]#KERN_DEBUGDIR#/[.filename]#KMODDIR#. By default, `KERN_DEBUGDIR` is copied from `DEBUGDIR` and set to [.filename]#/usr/lib/debug#. The framework will take care of creating and removing any required directories. [[uses-ldap]] == `ldap` Possible arguments: (none), , client, server Registers a dependency on package:net/openldap[]. It uses the specific `` (without the dot notation) if set. Otherwise it tries to find the currently installed version. If necessary it falls back to the default version found in `bsd.default-versions.mk`. `client` specifies a runtime dependency on the client library. This is also the default. `server` specifies a runtime dependency on the server. The following variables can be accessed by the port: `IGNORE_WITH_OPENLDAP`:: This variable can be defined if the ports does not support one or more versions of OpenLDAP. `WITH_OPENLDAP_VER`:: User defined variable to set OpenLDAP version. `OPENLDAP_VER`:: Detected OpenLDAP version. [[uses-lha]] == `lha` Possible arguments: (none) Set `EXTRACT_SUFX` to `.lzh` [[uses-libarchive]] == `libarchive` Possible arguments: (none) Registers a dependency on package:archivers/libarchive[]. Any ports depending on libarchive must include `USES=libarchive`. [[uses-libedit]] == `libedit` Possible arguments: (none) Registers a dependency on package:devel/libedit[]. Any ports depending on libedit must include `USES=libedit`. [[uses-libtool]] == `libtool` Possible arguments: (none), `keepla`, `build` Patches `libtool` scripts. This must be added to all ports that use `libtool`. The `keepla` argument can be used to keep [.filename]#.la# files. Some ports do not ship with their own copy of libtool and need a build time dependency on package:devel/libtool[], use the `:build` argument to add such dependency. [[uses-linux]] == `linux` Possible arguments: `c6`, `c7` Ports Linux compatibility framework. Specify `c6` to depend on CentOS 6 packages. Specify `c7` to depend on CentOS 7 packages. The available packages are: * `allegro` * `alsa-plugins-oss` * `alsa-plugins-pulseaudio` * `alsalib` * `atk` * `avahi-libs` * `base` * `cairo` * `cups-libs` * `curl` * `cyrus-sasl2` * `dbusglib` * `dbuslibs` * `devtools` * `dri` * `expat` * `flac` * `fontconfig` * `gdkpixbuf2` * `gnutls` * `graphite2` * `gtk2` * `harfbuzz` * `jasper` * `jbigkit` * `jpeg` * `libasyncns` * `libaudiofile` * `libelf` * `libgcrypt` * `libgfortran` * `libgpg-error` * `libmng` * `libogg` * `libpciaccess` * `libsndfile` * `libsoup` * `libssh2` * `libtasn1` * `libthai` * `libtheora` * `libv4l` * `libvorbis` * `libxml2` * `mikmod` * `naslibs` * `ncurses-base` * `nspr` * `nss` * `openal` * `openal-soft` * `openldap` * `openmotif` * `openssl` * `pango` * `pixman` * `png` * `pulseaudio-libs` * `qt` * `qt-x11` * `qtwebkit` * `scimlibs` * `sdl12` * `sdlimage` * `sdlmixer` * `sqlite3` * `tcl85` * `tcp_wrappers-libs` * `tiff` * `tk85` * `ucl` * `xorglibs` [[uses-llvm]] == `llvm` Possible arguments: (none), `_XY_`, min=`_XY_`, max=`_XY_`, build, run, lib Adds a dependency on LLVM. By default this is a build dependency unless overridden by the `run` or `lib` options. The default version is the one set in `LLVM_DEFAULT`. A specific version can be specified as well. The minimum and maximum versions can be specified with the `min` and `max` parameters respectively. The ports framework export the following variables to the port: `LLVM_VERSION`:: Version chosen from the arguments to llvm.mk `LLVM_PORT`:: Chosen llvm port `LLVM_CONFIG`:: llvm-config of the chosen port `LLVM_LIBLLVM`:: libLLVM.so of the chosen port `LLVM_PREFIX`:: Installation prefix of the chosen port [[uses-localbase]] == `localbase` Possible arguments: (none), `ldflags` Ensures that libraries from dependencies in `LOCALBASE` are used instead of the ones from the base system. Specify `ldflags` to add `-L${LOCALBASE}/lib` to `LDFLAGS` instead of `LIBS`. Ports that depend on libraries that are also present in the base system should use this. It is also used internally by a few other `USES`. [[uses-lua]] == `lua` Possible arguments: (none), `_XY_`, `_XY_+`, `-_XY_`, `_XY_-_ZA_`, `module`, `flavors`, `build`, `run`, `env` Adds a dependency on Lua. By default this is a library dependency, unless overridden by the `build` and/or `run` option. The `env` option prevents the addition of any dependency, while still defining all the usual variables. The default version is set by the usual `DEFAULT_VERSIONS` mechanism, unless a version or range of versions is specified as an argument, for example, `51` or `51-54`. Applications using Lua are normally built for only a single Lua version. However, library modules intended to be loaded by Lua code should use the `module` option to build with multiple flavors. For more information see crossref:special[using-lua,Using Lua]. [[uses-luajit]] == `luajit` Possible arguments: (none), `_X_` Adds a dependency on luajit runtime. A specific version _X_ can be used. Possible versions are `luajit`, `luajit-devel`, `luajit-openresty` After including [.filename]#bsd.port.options.mk# or [.filename]#bsd.port.pre.mk# the port can inspect these variables: `LUAJIT_VER`:: The selected luajit version `LUAJIT_INCDIR`:: The path to luajit's header files `LUAJIT_LUAVER`:: Which luajit spec version is selected (2.0 for luajit, else 2.1) For more information see crossref:special[using-lua,Using Lua]. [[uses-lxqt]] == `lxqt` Possible arguments: (none) Handle dependencies for the LXQt Desktop Environment. Use `USE_LXQT` to select the components needed for the port. See crossref:special[using-lxqt,Using LXQt] for more information. [[uses-magick]] == `magick` Possible arguments: (none), `_X_`, `build`, `nox11`, `run`, `test` Add a library dependency on `ImageMagick`. A specific version _X_ can be used. Possible versions are `6` and `7` (default). `nox11` indicates that the `-nox11` version of the port is required. `build`, `run` and `test` add build-, run-time and test dependencies on ImageMagick. [[uses-makeinfo]] == `makeinfo` Possible arguments: (none) Add a build-time dependency on `makeinfo` if it is not present in the base system. [[uses-makeself]] == `makeself` Possible arguments: (none) Indicates that the distribution files are makeself archives and sets the appropriate dependencies. [[uses-mate]] == `mate` Possible arguments: (none) Provides an easy way to depend on MATE components. The components should be listed in `USE_MATE`. The available components are: * `autogen` * `caja` * `common` * `controlcenter` * `desktop` * `dialogs` * `docutils` * `icontheme` * `intlhack` * `intltool` * `libmatekbd` * `libmateweather` * `marco` * `menus` * `notificationdaemon` * `panel` * `pluma` * `polkit` * `session` * `settingsdaemon` The default dependency is build- and run-time, it can be changed with `:build` or `:run`. For example: [.programlisting] .... USES= mate USE_MATE= menus:build intlhack .... [[uses-meson]] == `meson` Possible arguments: (none) Provide support for Meson based projects. For more information see crossref:special[using-meson,Using `meson`]. [[uses-metaport]] == `metaport` Possible arguments: (none) Sets the following variables to make it easier to create a metaport: `MASTER_SITES`, `DISTFILES`, `EXTRACT_ONLY`, `NO_BUILD`, `NO_INSTALL`, `NO_MTREE`, `NO_ARCH`. [[uses-minizip]] == `minizip` Possible arguments: (none), `ng` Adds a library dependency on package:archivers/minizip[] or package:archivers/minizip-ng[] respectively. [[uses-mysql]] == `mysql` Possible arguments: (none), `_version_`, `client` (default), `server`, `embedded` Provide support for MySQL If no version is given, try to find the current installed version. Fall back to the default version, MySQL-5.6. The possible versions are `55`, `55m`, `55p`, `56`, `56p`, `56w`, `57`, `57p`, `80`, `100m`, `101m`, and `102m`. The `m` and `p` suffixes are for the MariaDB and Percona variants of MySQL. `server` and `embedded` add a build- and run-time dependency on the MySQL server. When using `server` or `embedded`, add `client` to also add a dependency on [.filename]#libmysqlclient.so#. A port can set `IGNORE_WITH_MYSQL` if some versions are not supported. The framework sets `MYSQL_VER` to the detected MySQL version. [[uses-mono]] == `mono` Possible arguments: (none), `nuget` Adds a dependency on the Mono (currently only C#) framework by setting the appropriate dependencies. Specify `nuget` when the port uses nuget packages. `NUGET_DEPENDS` needs to be set with the names and versions of the nuget packages in the format `_name_=_version_`. An optional package origin can be added using `_name_=_version_:_origin_`. The helper target, `buildnuget`, will output the content of the `NUGET_DEPENDS` based on the provided [.filename]#packages.config#. [[uses-motif]] == `motif` Possible arguments: (none) Uses package:x11-toolkits/open-motif[] as a library dependency. End users can set `WANT_LESSTIF` in [.filename]#make.conf# to use package:x11-toolkits/lesstif[] as dependency instead of package:x11-toolkits/open-motif[]. Similarly setting `WANT_OPEN_MOTIF_DEVEL` in [.filename]#make.conf# will add a dependency on package:x11-toolkits/open-motif-devel[] [[uses-ncurses]] == `ncurses` Possible arguments: (none), `base`, `port` Uses ncurses, and causes some useful variables to be set. [[uses-nextcloud]] == `nextcloud` Possible arguments: (none) Adds support for Nextcloud applications by adding a run time dependency on package:www/nextcloud[]. [[uses-ninja]] == `ninja` Possible arguments: (none), `build`, `make` (default), `run` If `build` or `run` arguments are specify, it respectively adds a build or run time dependency on package:devel/ninja[]. If `make` or no arguments are provided, use ninja to build the port instead of make. `make` implies `build`. If the variable `NINJA_DEFAULT` is set to `samurai`, then the dependencies are set on package:devel/samurai[] instead. [[uses-nodejs]] == `nodejs` Possible arguments: (none), `build`, `run`, `current`, `lts`, `10`, `14`, `16`, `17`. Uses nodejs. Adds a dependency on package:www/node*[]. If a supported version is specified then `run` and/or `build` must be specified too. [[uses-objc]] == `objc` Possible arguments: (none) Add objective C dependencies (compiler, runtime library) if the base system does not support it. [[uses-octave]] == `octave` Possible arguments: (none), env Uses package:math/octave[]. `env` loads only one `OCTAVE_VERSION` environmental variable. [[uses-openal]] == `openal` Possible arguments: `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 `WANT_OPENAL`. Valid values for this knob are `soft` (default) and `si`. [[uses-pathfix]] == `pathfix` Possible arguments: (none) Look for [.filename]#Makefile.in# and [.filename]#configure# in `PATHFIX_WRKSRC` (defaults to `WRKSRC`) and fix common paths to make sure they respect the FreeBSD hierarchy. For example, it fixes the installation directory of `pkgconfig`'s [.filename]#.pc# files to [.filename]#${PREFIX}/libdata/pkgconfig#. If the port uses `USES=autoreconf`, [.filename]#Makefile.am# will be added to `PATHFIX_MAKEFILEIN` automatically. If the port <> it will look for [.filename]#CMakeLists.txt# in `PATHFIX_WRKSRC`. If needed, that default filename can be changed with `PATHFIX_CMAKELISTSTXT`. [[uses-pear]] == `pear` Possible arguments: `env` Adds a dependency on package:devel/pear[]. It will setup default behavior for software using the PHP Extension and Application Repository. Using the `env` arguments only sets up the PEAR environment variables. See crossref:special[php-pear,PEAR Modules] for more information. [[uses-perl5]] == `perl5` Possible arguments: (none) Depends on Perl. The configuration is done using `USE_PERL5`. `USE_PERL5` can contain the phases in which to use Perl, can be `extract`, `patch`, `build`, `run`, or `test`. `USE_PERL5` can also contain `configure`, `modbuild`, or `modbuildtiny` when [.filename]#Makefile.PL#, [.filename]#Build.PL#, or Module::Build::Tiny's flavor of [.filename]#Build.PL# is required. `USE_PERL5` defaults to `build run`. When using `configure`, `modbuild`, or `modbuildtiny`, `build` and `run` are implied. See crossref:special[using-perl,Using Perl] for more information. [[uses-pgsql]] == `pgsql` Possible arguments: (none), `_X.Y_`, `_X.Y_+`, `_X.Y_-`, `_X.Y_-_Z.A_` Provide support for PostgreSQL. Port maintainer can set version required. Minimum and maximum versions or a range can be specified; for example, `9.0-`, `8.4+`, `8.4-9.2.` By default, the added dependency will be the client, but if the port requires additional components, this can be done using `WANT_PGSQL=_component[:target]_`; for example, `WANT_PGSQL=server:configure pltcl plperl`. The available components are: * `client` * `contrib` * `docs` * `pgtcl` * `plperl` * `plpython` * `pltcl` * `server` [[uses-php]] == `php` Possible arguments: (none), `phpize`, `ext`, `zend`, `build`, `cli`, `cgi`, `mod`, `web`, `embed`, `pecl`, `flavors`, `noflavors` Provide support for PHP. Add a runtime dependency on the default PHP version, package:lang/php81[]. `phpize`:: Use to build a PHP extension. Enables flavors. `ext`:: Use to build, install and register a PHP extension. Enables flavors. `zend`:: Use to build, install and register a Zend extension. Enables flavors. `build`:: Set PHP also as a build-time dependency. `cli`:: Needs the CLI version of PHP. `cgi`:: Needs the CGI version of PHP. `mod`:: Needs the Apache module for PHP. `web`:: Needs the Apache module or the CGI version of PHP. `embed`:: Needs the embedded library version of PHP. `pecl`:: Provide defaults for fetching PHP extensions from the PECL repository. Enables flavors. `flavors`:: Enable automatic crossref:flavors[flavors-auto-php,PHP flavors] generation. Flavors will be generated for all PHP versions, except the ones present in <>. `noflavors`:: Disable automatic PHP flavors generation. _Must only_ be used with extensions provided by PHP itself. Variables are used to specify which PHP modules are required, as well as which version of PHP are supported. `USE_PHP`:: The list of required PHP extensions at run-time. Add `:build` to the extension name to add a build-time dependency. Example: `pcre xml:build gettext` [[uses-php-ignore]] `IGNORE_WITH_PHP`:: The port does not work with PHP of the given version. For possible values look at the content of `_ALL_PHP_VERSIONS` in [.filename]#Mk/Uses/php.mk#. When building a PHP or Zend extension with `:ext` or `:zend`, these variables can be set: `PHP_MODNAME`:: The name of the PHP or Zend extension. Default value is `${PORTNAME}`. `PHP_HEADER_DIRS`:: A list of subdirectories from which to install header files. The framework will always install the header files that are present in the same directory as the extension. `PHP_MOD_PRIO`:: The priority at which to load the extension. It is a number between `00` and `99`. + For extensions that do not depend on any extension, the priority is automatically set to `20`, for extensions that depend on another extension, the priority is automatically set to `30`. Some extensions may need to be loaded before every other extension, for example package:www/php56-opcache[]. Some may need to be loaded after an extension with a priority of `30`. In that case, add `PHP_MOD_PRIO=_XX_` in the port's Makefile. For example: + [.programlisting] .... USES= php:ext USE_PHP= wddx PHP_MOD_PRIO= 40 .... These variables are available to use in `PKGNAMEPREFIX` or `PKGNAMESUFFIX`: `PHP_PKGNAMEPREFIX`:: Contains `php_XY_-` where _XY_ is the current flavor's PHP version. Use with PHP extensions and modules. `PHP_PKGNAMESUFFIX`:: Contains `-php_XY_` where _XY_ is the current flavor's PHP version. Use with PHP applications. `PECL_PKGNAMEPREFIX`:: Contains `php_XY_-pecl-` where _XY_ is the current flavor's PHP version. Use with PECL modules. [IMPORTANT] ==== With flavors, all PHP extensions, PECL extensions, PEAR modules _must have_ a different package name, so they must all use one of these three variables in their `PKGNAMEPREFIX` or `PKGNAMESUFFIX`. ==== [[uses-pkgconfig]] == `pkgconfig` Possible arguments: (none), `build` (default), `run`, `both` Uses package: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. [[uses-pure]] == `pure` Possible arguments: (none), `ffi` Uses package:lang/pure[]. Largely used for building related pure ports. With the `ffi` argument, it implies package:devel/pure-ffi[] as a run-time dependency. [[uses-pyqt]] == `pyqt` Possible arguments: (none), `4`, `5` Uses PyQt. If the port is part of PyQT itself, set `PYQT_DIST`. Use `USE_PYQT` to select the components the port needs. The available components are: * `core` * `dbus` * `dbussupport` * `demo` * `designer` * `designerplugin` * `doc` * `gui` * `multimedia` * `network` * `opengl` * `qscintilla2` * `sip` * `sql` * `svg` * `test` * `webkit` * `xml` * `xmlpatterns` These components are only available with PyQT4: * `assistant` * `declarative` * `help` * `phonon` * `script` * `scripttools` These components are only available with PyQT5: * `multimediawidgets` * `printsupport` * `qml` * `serialport` * `webkitwidgets` * `widgets` The default dependency for each component is build- and run-time, to select only build or run, add `_build` or `_run` to the component name. For example: [.programlisting] .... USES= pyqt USE_PYQT= core doc_build designer_run .... [[uses-pytest]] == `pytest` Possible arguments: (none), 4 Introduces a new dependency on package:devel/pytest[]. It defines a `do-test` target which will run the tests properly. Use the argument to depend on a specific package:devel/pytest[] version. For ports using package:devel/pytest[] consider using this instead of a specific `do-test` target. The framework exposes the following variables to the port: `PYTEST_ARGS`:: Additional arguments to pytest (defaults to empty). `PYTEST_IGNORED_TESTS`:: lists of `pytest -k` patterns of tests to ignore (defaults to empty). For tests which are not expected to pass, such as ones requiring a database access. `PYTEST_BROKEN_TESTS`:: lists of `pytest -k` patterns of tests to ignore (defaults to empty). For broken tests which require fixing. In addition the following variables may be set by the user: `PYTEST_ENABLE_IGNORED_TESTS`:: Enable tests which are otherwise ignored by `PYTEST_IGNORED_TESTS`. `PYTEST_ENABLE_BROKEN_TESTS`:: Enable tests which are otherwise ignored by `PYTEST_BROKEN_TESTS`. `PYTEST_ENABLE_ALL_TESTS`:: Enable tests which are otherwise ignored by `PYTEST_IGNORED_TESTS` and `PYTEST_BROKEN_TESTS`. [[uses-python]] == `python` Possible arguments: (none), `_X.Y_`, `_X.Y+_`, `_-X.Y_`, `_X.Y-Z.A_`, `patch`, `build`, `run`, `test` Uses Python. A supported version or version range can be specified. If Python is only needed at build time, run time or for the tests, it can be set as a build, run or test dependency with `build`, `run`, or `test`. If Python is also needed during the patch phase, use `patch`. See crossref:special[using-python, Using Python] for more information. -`PYTHON_NO_DEPENDS=yes` can be used when the variables exported by the framework are needed but a dependency on Python is not. +`USES=python:env` can be used when the variables exported by the framework are needed but a dependency on Python is not. It can happen when using with <>, and the goal is only to fix the shebangs but not add a dependency on Python. [[uses-qmail]] == `qmail` Possible arguments: (none), `build`, `run`, `both`, `vars` Uses package: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` will only set QMAIL variables for the port to use. [[uses-qmake]] == `qmake` Possible arguments: (none), `norecursive`, `outsource`, `no_env`, `no_configure` Uses QMake for configuring. For more information see crossref:special[using-qmake,Using `qmake`]. [[uses-qt]] == `qt` Possible arguments: `5`, `6`, `no_env` Add dependency on Qt components. `no_env` is passed directly to `USES= qmake`. See crossref:special[using-qt,Using Qt] for more information. [[uses-qt-dist]] == `qt-dist` Possible arguments: (none) or `5` and (none) or `6` and (none) or one of `3d`, `5compat`, `base`, `charts`, `connectivity`, `datavis3d`, `declarative`, `doc` `languageserver`, `gamepad`, `graphicaleffects`, `imageformats`, `locat ion`, `lottie`, `multimedia`, `networkauth`, `positioning`, `quick3d`, `quickcontrols2`, `quickcontrols`, `quicktimeline`, `remoteobjects`, `script`, `scxml `, `sensors`, `serialbus`, `serialport`, `shadertools`, `speech`, `svg`, `tools`, `translations`, `virtualkeyboard`, `wayland`, `webchannel`, `webengine`, `webglplugin`, `websockets`, `webview`, `x11extras`, `xmlpatterns`. Provides support for building Qt 5 and Qt 6 components. It takes care of setting up the appropriate configuration environment for the port to build. [[qt5-dist-example]] .Building Qt 5 Components [example] ==== The port is Qt 5's `networkauth` component, which is part of the `networkauth` distribution file. [.programlisting] .... PORTNAME= networkauth DISTVERSION= ${QT5_VERSION} USES= qt-dist:5 .... ==== [[qt6-dist-example]] .Building Qt 6 Components [example] ==== The port is Qt 6's `websockets` component, which is part of the `websockets` distribution file. [.programlisting] .... PORTNAME= websockets PORTVERSION= ${QT6_VERSION} USES= qt-dist:6 .... ==== If `PORTNAME` does not match the component name, it can be passed as an argument to `qt-dist`. [[qt5-dist-example-explicit]] .Building Qt 5 Components with Different Names [example] ==== The port is Qt 5's `gui` component, which is part of the `base` distribution file. [.programlisting] .... PORTNAME= gui DISTVERSION= ${QT5_VERSION} USES= qt-dist:5,base .... ==== [[uses-readline]] == `readline` Possible arguments: (none), `port` Uses readline as a library dependency, and sets `CPPFLAGS` and `LDFLAGS` as necessary. If the `port` argument is used or if readline is not present in the base system, add a dependency on package:devel/readline[] [[uses-ruby]] == `ruby` Possible arguments: (none), `build`, `extconf`, `run`, `setup` Provide support for Ruby related ports. `(none)` without arguments adds runtime dependency on package:lang/ruby[]. `build` adds a dependency on package:lang/ruby[] at build time. `extconf` states that the port uses extconf.rb to configure. `run` adds a dependency on package:lang/ruby[] at run time. This is also the default. `setup` states that the port uses setup.rb to configure and build. The user may have the following variables defined: `RUBY_VER`:: Alternative short version of ruby in the form of `x.y'. `RUBY_DEFAULT_VER`:: Set to (e.g.) `2.7` to use `ruby27` as the default version. `RUBY_ARCH`:: Set the architecture name (e.g. i386-freebsd7). The following variables are exported to be used by the port: `RUBY`:: Set to full path of ruby. If set, the values of the following variables are automatically obtained from the ruby executable: `RUBY_ARCH`, `RUBY_ARCHLIBDIR`, `RUBY_LIBDIR`, `RUBY_SITEARCHLIBDIR`, `RUBY_SITELIBDIR`, `RUBY_VER` and `RUBY_VERSION` `RUBY_VER`:: Set to the alternative short version of ruby in the form of `x.y'. `RUBY_EXTCONF`:: Set to the alternative name of extconf.rb (default: extconf.rb). `RUBY_EXTCONF_SUBDIRS`:: Set to list of subdirectories, if multiple modules are included. `RUBY_SETUP`:: Set to the alternative name of setup.rb (default: setup.rb). [[uses-samba]] == `samba` Possible arguments: `build`, `env`, `lib`, `run` Handle dependency on Samba. `env` will not add any dependency and only set up the variables. `build` and `run` will add build-time and run-time dependency on [.filename]#smbd#. `lib` will add a dependency on [.filename]#libsmbclient.so#. The variables that are exported are: `SAMBAPORT`:: The origin of the default Samba port. `SAMBAINCLUDES`:: The location of the Samba header files. `SAMBALIBS`:: The directory where the Samba shared libraries are available. [[uses-scons]] == `scons` Possible arguments: (none) Provide support for the use of package:devel/scons[]. See crossref:special[using-scons,Using `scons`] for more information. [[uses-shared-mime-info]] == `shared-mime-info` Possible arguments: (none) Uses update-mime-database from package: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 add an crossref:plist[plist-keywords-shared-mime-info,`@shared-mime-info`] entry to the plist. [[uses-shebangfix]] == `shebangfix` Possible arguments: (none) A lot of software uses incorrect locations for script interpreters, most notably [.filename]#/usr/bin/perl# and [.filename]#/bin/bash#. The shebangfix macro fixes shebang lines in scripts listed in `SHEBANG_REGEX`, `SHEBANG_GLOB`, or `SHEBANG_FILES`. `SHEBANG_REGEX`:: Contains _one_ extended regular expressions, and is used with the `-iregex` argument of man:find[1]. See <>. `SHEBANG_GLOB`:: Contains a list of patterns used with the `-name` argument of man:find[1]. See <>. `SHEBANG_FILES`:: Contains a list of files or man:sh[1] globs. The shebangfix macro is run from `${WRKSRC}`, so `SHEBANG_FILES` can contain paths that are relative to `${WRKSRC}`. It can also deal with absolute paths if files outside of `${WRKSRC}` require patching. See <>. Currently Bash, Java, Ksh, Lua, Perl, PHP, Python, Ruby, Tcl, and Tk are supported by default. There are three configuration variables: `SHEBANG_LANG`:: The list of supported interpreters. `_interp__CMD`:: The path to the command interpreter on FreeBSD. The default value is `${LOCALBASE}/bin/_interp_`. `_interp__OLD_CMD`:: The list of wrong invocations of interpreters. These are typically obsolete paths, or paths used on other operating systems that are incorrect on FreeBSD. They will be replaced by the correct path in `_interp__CMD`. + [NOTE] ==== These will _always_ be part of `_interp__OLD_CMD`: `"/usr/bin/env _interp_" /bin/_interp_ /usr/bin/_interp_ /usr/local/bin/_interp_`. ==== + [TIP] ==== `_interp__OLD_CMD` contain multiple values. Any entry with spaces must be quoted. See <>. ==== [IMPORTANT] ==== The fixing of shebangs is done during the `patch` phase. If scripts are created with incorrect shebangs during the `build` phase, the build process (for example, the [.filename]#configure# script, or the [.filename]#Makefiles#) must be patched or given the right path (for example, with `CONFIGURE_ENV`, `CONFIGURE_ARGS`, `MAKE_ENV`, or `MAKE_ARGS`) to generate the right shebangs. Correct paths for supported interpreters are available in `_interp__CMD`. ==== [TIP] ==== -When used with <>, and the aim is only to fix the shebangs but a dependency on Python itself is not wanted, use `PYTHON_NO_DEPENDS=yes`. +When used with <>, and the aim is only to fix the shebangs but a dependency on Python itself is not wanted, use `USES=python:env` instead. ==== [[uses-shebangfix-ex-lua]] .Adding Another Interpreter to `USES=shebangfix` [example] ==== To add another interpreter, set `SHEBANG_LANG`. For example: [.programlisting] .... SHEBANG_LANG= lua .... ==== [[uses-shebangfix-ex-ksh]] .Specifying all the Paths When Adding an Interpreter to `USES=shebangfix` [example] ==== If it was not already defined, and there were no default values for `_interp__OLD_CMD` and `_interp__CMD` the Ksh entry could be defined as: [.programlisting] .... SHEBANG_LANG= ksh ksh_OLD_CMD= "/usr/bin/env ksh" /bin/ksh /usr/bin/ksh ksh_CMD= ${LOCALBASE}/bin/ksh .... ==== [[uses-shebangfix-ex-strange]] .Adding a Strange Location for an Interpreter [example] ==== Some software uses strange locations for an interpreter. For example, an application might expect Python to be located in [.filename]#/opt/bin/python2.7#. The strange path to be replaced can be declared in the port [.filename]#Makefile#: [.programlisting] .... python_OLD_CMD= /opt/bin/python2.7 .... ==== [[uses-shebangfix-ex-regex]] .`USES=shebangfix` with `SHEBANG_REGEX` [example] ==== To fix all the files in `${WRKSRC}/scripts` ending in [.filename]#.pl#, [.filename]#.sh#, or [.filename]#.cgi# do: [.programlisting] .... USES= shebangfix SHEBANG_REGEX= ./scripts/.*\.(sh|pl|cgi) .... [NOTE] ====== `SHEBANG_REGEX` is used by running `find -E`, which uses modern regular expressions also known as extended regular expressions. See man:re_format[7] for more information. ====== ==== [[uses-shebangfix-ex-glob]] .`USES=shebangfix` with `SHEBANG_GLOB` [example] ==== To fix all the files in `${WRKSRC}` ending in [.filename]#.pl# or [.filename]#.sh#, do: [.programlisting] .... USES= shebangfix SHEBANG_GLOB= *.sh *.pl .... ==== [[uses-shebangfix-ex-files]] .`USES=shebangfix` with `SHEBANG_FILES` [example] ==== To fix the files [.filename]#script/foobar.pl# and [.filename]#script/*.sh# in `${WRKSRC}`, do: [.programlisting] .... USES= shebangfix SHEBANG_FILES= scripts/foobar.pl scripts/*.sh .... ==== [[uses-sqlite]] == `sqlite` Possible arguments: (none), `2`, `3` Add a dependency on SQLite. The default version used is 3, but version 2 is also possible using the `:2` modifier. [[uses-ssl]] == `ssl` Possible arguments: (none), `build`, `run` Provide support for OpenSSL. A build- or run-time only dependency can be specified using `build` or `run`. These variables are available for the port's use, they are also added to `MAKE_ENV`: `OPENSSLBASE`:: Path to the OpenSSL installation base. `OPENSSLDIR`:: Path to OpenSSL's configuration files. `OPENSSLLIB`:: Path to the OpenSSL libraries. `OPENSSLINC`:: Path to the OpenSSL includes. `OPENSSLRPATH`:: If defined, the path the linker needs to use to find the OpenSSL libraries. [TIP] ==== If a port does not build with an OpenSSL flavor, set the `BROKEN_SSL` variable, and possibly the `BROKEN_SSL_REASON__flavor_`: [.programlisting] .... BROKEN_SSL= libressl BROKEN_SSL_REASON_libressl= needs features only available in OpenSSL .... ==== [[uses-tar]] == `tar` Possible arguments: (none), `Z`, `bz2`, `bzip2`, `lzma`, `tbz`, `tbz2`, `tgz`, `txz`, `xz`, `zst`, `zstd` Set `EXTRACT_SUFX` to `.tar`, `.tar.Z`, `.tar.bz2`, `.tar.bz2`, `.tar.lzma`, `.tbz`, `.tbz2`, `.tgz`, `.txz`, `.tar.xz`, `.tar.zst` or `.tar.zstd` respectively. [[uses-tcl]] == `tcl` Possible arguments: _version_, `wrapper`, `build`, `run`, `tea` Add a dependency on Tcl. A specific version can be requested using _version_. The version can be empty, one or more exact version numbers (currently `84`, `85`, or `86`), or a minimal version number (currently `84+`, `85+` or `86+`). To only request a non version specific wrapper, use `wrapper`. A build- or run-time only dependency can be specified using `build` or `run`. To build the port using the Tcl Extension Architecture, use `tea`. After including [.filename]#bsd.port.pre.mk# the port can inspect the results using these variables: * `TCL_VER`: chosen major.minor version of Tcl * `TCLSH`: full path of the Tcl interpreter * `TCL_LIBDIR`: path of the Tcl libraries * `TCL_INCLUDEDIR`: path of the Tcl C header files * `TK_VER`: chosen major.minor version of Tk * `WISH`: full path of the Tk interpreter * `TK_LIBDIR`: path of the Tk libraries * `TK_INCLUDEDIR`: path of the Tk C header files [[uses-terminfo]] == `terminfo` Possible arguments: (none) Adds crossref:plist[plist-keywords-terminfo,`@terminfo`] to the [.filename]#plist#. Use when the port installs [.filename]#*.terminfo# files in [.filename]#${PREFIX}/share/misc#. [[uses-tex]] == `tex` Possible arguments: (none) Provide support for tex. Loads all the default variables for TEX related ports and does not add any dependency on any ports. Variables are used to specify which TEX modules are required. `USE_TEX`:: The list of required TEX extensions at run-time. Add `:build` to the extension name to add a build-time dependency, `:run` to add runtime dependency, `:test` for test time dependency, `:extract` for extract time dependency. Example: `base texmf:build source:run` Current possible arguments are as follows: * `base` * `texmf` * `source` * `docs` * `web2c` * `kpathsea` * `ptexenc` * `basic` * `tlmgr` * `texlua` * `texluajit` * `synctex` * `xpdfopen` * `dvipsk` * `dvipdfmx` * `xdvik` * `gbklatex` * `formats` * `tex` * `latex` * `pdftex` * `jadetex` * `luatex` * `ptex` * `xetex` * `xmltex` * `texhash` * `updmap` * `fmtutil` [[uses-tk]] == `tk` Same as arguments for `tcl` Small wrapper when using both Tcl and Tk. The same variables are returned as when using Tcl. [[uses-uidfix]] == `uidfix` Possible arguments: (none) Changes some default behavior (mostly variables) of the build system to allow installing this port as a normal user. Try this in the port before using <> or patching. [[uses-uniquefiles]] == `uniquefiles` Possible arguments: (none), `dirs` Make files or directories 'unique', by adding a prefix or suffix. If the `dirs` argument is used, the port needs a prefix (and only a prefix) based on `UNIQUE_PREFIX` for standard directories `DOCSDIR`, `EXAMPLESDIR`, `DATADIR`, `WWWDIR`, `ETCDIR`. These variables are available for ports: * `UNIQUE_PREFIX`: The prefix to be used for directories and files. Default: `${PKGNAMEPREFIX}`. * `UNIQUE_PREFIX_FILES`: A list of files that need to be prefixed. Default: empty. * `UNIQUE_SUFFIX`: The suffix to be used for files. Default: `${PKGNAMESUFFIX}`. * `UNIQUE_SUFFIX_FILES`: A list of files that need to be suffixed. Default: empty. [[uses-vala]] == `vala` Possible arguments: `build`, `lib`, `no_depend` Adds build or library dependencies on package:lang/vala[]. The `no_depend` argument is reserved for package:lang/vala[] itself. [[uses-varnish]] == `varnish` Possible arguments: `4` (default), `6`, `7` Handle dependencies on Varnish Cache. Adds a dependency on package:www/varnish*[]. [[uses-webplugin]] == `webplugin` Possible arguments: (none), `ARGS` Automatically create and remove symbolic links for each application that supports the webplugin framework. `ARGS` can be one of: * `gecko`: support plug-ins based on Gecko * `native`: support plug-ins for Gecko, Opera, and WebKit-GTK * `linux`: support Linux plug-ins * `all` (default, implicit): support all plug-in types * (individual entries): support only the browsers listed These variables can be adjusted: * `WEBPLUGIN_FILES`: No default, must be set manually. The plug-in files to install. * `WEBPLUGIN_DIR`: The directory to install the plug-in files to, default [.filename]#PREFIX/lib/browser_plugins/WEBPLUGIN_NAME#. Set this if the port installs plug-in files outside of the default directory to prevent broken symbolic links. * `WEBPLUGIN_NAME`: The final directory to install the plug-in files into, default `PKGBASE`. [[uses-xfce]] == `xfce` Possible arguments: (none), `gtk2` Provide support for Xfce related ports. See crossref:special[using-xfce,Using Xfce] for details. The `gtk2` argument specifies that the port requires GTK2 support. It adds additional features provided by some core components, for example, package:x11/libxfce4menu[] and package:x11-wm/xfce4-panel[]. [[uses-xorg]] == `xorg` Possible arguments: (none) Provides an easy way to depend on X.org components. The components should be listed in `USE_XORG`. The available components are: [[using-x11-components]] .Available X.Org Components [cols="1,1", frame="none", options="header"] |=== | Name | Description |`dmx` |DMX extension library |`fontenc` |The fontenc Library |`fontutil` |Create an index of X font files in a directory |`ice` |Inter Client Exchange library for X11 |`libfs` |The FS library |`pciaccess` |Generic PCI access library |`pixman` |Low-level pixel manipulation library |`sm` |Session Management library for X11 |`x11` |X11 library |`xau` |Authentication Protocol library for X11 |`xaw` |X Athena Widgets library |`xaw6` |X Athena Widgets library |`xaw7` |X Athena Widgets library |`xbitmaps` |X.Org bitmaps data |`xcb` |The X protocol C-language Binding (XCB) library |`xcomposite` |X Composite extension library |`xcursor` |X client-side cursor loading library |`xdamage` |X Damage extension library |`xdmcp` |X Display Manager Control Protocol library |`xext` |X11 Extension library |`xfixes` |X Fixes extension library |`xfont` |X font library |`xfont2` |X font library |`xft` |Client-sided font API for X applications |`xi` |X Input extension library |`xinerama` |X11 Xinerama library |`xkbfile` |XKB file library |`xmu` |X Miscellaneous Utilities libraries |`xmuu` |X Miscellaneous Utilities libraries |`xorg-macros` |X.Org development aclocal macros |`xorg-server` |X.Org X server and related programs |`xorgproto` |xorg protocol headers |`xpm` |X Pixmap library |`xpresent` |X Present Extension library |`xrandr` |X Resize and Rotate extension library |`xrender` |X Render extension library |`xres` |X Resource usage library |`xscrnsaver` |The XScrnSaver library |`xshmfence` |Shared memory 'SyncFence' synchronization primitive |`xt` |X Toolkit library |`xtrans` |Abstract network code for X |`xtst` |X Test extension |`xv` |X Video Extension library |`xvmc` |X Video Extension Motion Compensation library |`xxf86dga` |X DGA Extension |`xxf86vm` |X Vidmode Extension |=== [[uses-xorg-cat]] == `xorg-cat` Possible arguments: `app`, `data`, `doc`, `driver`, `font`, `lib`, `proto`, `util`, `xserver` and (none) or one off `autotools` (default), `meson` Provide support for building Xorg components. It takes care of setting up common dependencies and an appropriate configuration environment needed. This is intended only for Xorg components. The category has to match upstream categories. The second argument is the build system to use. autotools is the default, but meson is also supported. [[uses-zip]] == `zip` Possible arguments: (none), `infozip` Indicates that the distribution files use the ZIP compression algorithm. For files using the InfoZip algorithm the `infozip` argument must be passed to set the appropriate dependencies. diff --git a/documentation/content/en/books/porters-handbook/uses/_index.po b/documentation/content/en/books/porters-handbook/uses/_index.po index c7618a006d..59f08e0103 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.po +++ b/documentation/content/en/books/porters-handbook/uses/_index.po @@ -1,6575 +1,6575 @@ # SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" "POT-Creation-Date: 2024-01-17 20:34-0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: YAML Front Matter: description #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1 #, no-wrap msgid "USES macros make it easy to declare requirements and settings for a FreeBSD Port" msgstr "" #. type: YAML Front Matter: title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1 #, no-wrap msgid "Chapter 17. Using USES Macros" msgstr "" #. type: Title = #: documentation/content/en/books/porters-handbook/uses/_index.adoc:13 #, no-wrap msgid "Using `USES` Macros" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:51 #, no-wrap msgid "An Introduction to `USES`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:55 msgid "" "`USES` macros make it easy to declare requirements and settings for a port. " "They can add dependencies, change building behavior, add metadata to " "packages, and so on, all by selecting simple, preset values." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:59 msgid "" "Each section in this chapter describes a possible value for `USES`, along " "with its possible arguments. Arguments are appended to the value after a " "colon (`:`). Multiple arguments are separated by commas (`,`)." msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:61 #, no-wrap msgid "Using Multiple Values" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:67 #, no-wrap msgid "USES=\tbison perl\n" msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:71 #, no-wrap msgid "Adding an Argument" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:77 #, no-wrap msgid "USES=\ttar:xz\n" msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:81 #, no-wrap msgid "Adding Multiple Arguments" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:87 #, no-wrap msgid "USES=\tdrupal:7,theme\n" msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:91 #, no-wrap msgid "Mixing it All Together" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:97 #, no-wrap msgid "USES=\tpgsql:9.3+ cpe python:2.7,build\n" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:101 #, no-wrap msgid "`7z`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:104 msgid "Possible arguments: (none), `p7zip`, `partial`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:108 msgid "" "Extract using man:7z[1] instead of man:bsdtar[1] and sets " "`EXTRACT_SUFX=.7z`. The `p7zip` option forces a dependency on the `7z` from " "package:archivers/p7zip[] if the one from the base system is not able to " "extract the files. `EXTRACT_SUFX` is not changed if the `partial` option is " "used, this can be used if the main distribution file does not have a [." "filename]#.7z# extension." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:110 #, no-wrap msgid "`ada`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:113 msgid "Possible arguments: (none), `6`, `12`, `(run)`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:116 msgid "" "Depends on an Ada-capable compiler, and sets `CC` accordingly. Defaults to " "use `gcc6-aux` from ports." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:118 #, no-wrap msgid "`autoreconf`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:121 msgid "Possible arguments: (none), `build`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:128 msgid "" "Runs `autoreconf`. It encapsulates the `aclocal`, `autoconf`, `autoheader`, " "`automake`, `autopoint`, and `libtoolize` commands. Each command applies to " "[.filename]#${AUTORECONF_WRKSRC}/configure.ac# or its old name, [." "filename]#${AUTORECONF_WRKSRC}/configure.in#. If [.filename]#configure.ac# " "defines subdirectories with their own [.filename]#configure.ac# using " "`AC_CONFIG_SUBDIRS`, `autoreconf` will recursively update those as well. " "The `:build` argument only adds build time dependencies on those tools but " "does not run `autoreconf`. A port can set `AUTORECONF_WRKSRC` if `WRKSRC` " "does not contain the path to [.filename]#configure.ac#." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:130 #, no-wrap msgid "`blaslapack`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:133 msgid "" "Possible arguments: (none), `atlas`, `netlib` (default), `gotoblas`, " "`openblas`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:135 msgid "Adds dependencies on Blas / Lapack libraries." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:137 #, no-wrap msgid "`bdb`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:140 msgid "Possible arguments: (none), `48`, `5` (default), `6`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:147 msgid "" "Add dependency on the Berkeley DB library. Default to package:databases/" "db5[]. It can also depend on package:databases/db48[] when using the `:48` " "argument or package:databases/db6[] with `:6`. It is possible to declare a " "range of acceptable values, `:48+` finds the highest installed version, and " "falls back to 4.8 if nothing else is installed. `INVALID_BDB_VER` can be " "used to specify versions which do not work with this port. The framework " "exposes the following variables to the port:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:148 #, no-wrap msgid "`BDB_LIB_NAME`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:151 msgid "" "The name of the Berkeley DB library. For example, when using package:" "databases/db5[], it contains `db-5.3`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:152 #, no-wrap msgid "`BDB_LIB_CXX_NAME`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:155 msgid "" "The name of the Berkeley DBC++ library. For example, when using package:" "databases/db5[], it contains `db_cxx-5.3`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:156 #, no-wrap msgid "`BDB_INCLUDE_DIR`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:159 msgid "" "The location of the Berkeley DB include directory. For example, when using " "package:databases/db5[], it will contain `${LOCALBASE}/include/db5`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:160 #, no-wrap msgid "`BDB_LIB_DIR`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:163 msgid "" "The location of the Berkeley DB library directory. For example, when using " "package:databases/db5[], it contains `${LOCALBASE}/lib`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:164 #, no-wrap msgid "`BDB_VER`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:167 msgid "" "The detected Berkeley DB version. For example, if using `USES=bdb:48+` and " "Berkeley DB 5 is installed, it contains `5`." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:172 msgid "" "package:databases/db48[] is deprecated and unsupported. It must not be used " "by any port." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:175 #, no-wrap msgid "`bison`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:178 msgid "Possible arguments: (none), `build`, `run`, `both`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:180 msgid "" "Uses package: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." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:182 #, no-wrap msgid "`budgie`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:185 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:271 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:280 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:331 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:360 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:369 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:385 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:431 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:477 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:534 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:570 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:603 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:610 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:764 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:835 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:957 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1031 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1038 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1046 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1214 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1233 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1240 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1247 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1286 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1294 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1337 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1355 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1383 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1408 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1430 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1857 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1865 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1874 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2103 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2111 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2166 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2235 msgid "Possible arguments: (none)" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:189 msgid "" "Provide support for the Budgie desktop environment. Use `USE_BUDGIE` to " "select the components needed for the port. See crossref:special[using-" "budgie,Using Budgie] for more information." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:191 #, no-wrap msgid "`cabal`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:196 msgid "" "Ports should not be created for Haskell libraries, see crossref:" "special[haskell-libs,Haskell Libraries] for more information." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:199 msgid "Possible arguments: (none), `hpack`, `nodefault`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:207 msgid "" "Sets default values and targets used to build Haskell software using Cabal. " "A build dependency on the Haskell compiler port (package:lang/ghc[]) is " "added. If there is some other version of GHC already listed in the " "`BUILD_DEPENDS` variable (for example, package:lang/ghc810[]), it would be " "used instead. If the `hpack` argument is given, a build dependency on " "package:devel/hs-hpack[] is added and `hpack` is invoked at configuration " "step to generate .cabal file. If the `nodefault` argument is given, the " "framework will not try to pull the main distribution file from the Hackage. " "This argument is implicitly added if `USE_GITHUB` or `USE_GITLAB` is present." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:209 msgid "The framework provides the following variables:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:210 #, no-wrap msgid "`CABAL_REVISION`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:213 msgid "" "Haskell packages hosted on Hackage may have revisions. Set this knob to an " "integer number to pull in revised package description." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:214 #, no-wrap msgid "`USE_CABAL`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:219 msgid "" "If the software uses Haskell dependencies, list them in this variable. Each " "item should be present on Hackage and be listed in form `packagename-" "_0.1.2_`. Dependencies can have revisions too, which are specified after " "the `_` symbol. Automatic generation of the dependency list is supported, " "see crossref:special[using-cabal,Building Haskell Applications with `cabal`]." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:220 #, no-wrap msgid "`CABAL_FLAGS`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:225 msgid "" "List of flags to be passed to `cabal-install` during the configuring and " "building stage. The flags are passed verbatim. This variable is usually " "used to enable or disable flags that are declared in the .cabal file. Pass " "`foo` to enable the `foo` flag and `-foo` to disable it." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:226 #, no-wrap msgid "`CABAL_EXECUTABLES`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:232 msgid "" "List of executable files installed by the port. Default value: `${PORTNAME}" "`. Consult the .cabal file of the project being ported to get a list of " "possible values for this variable. Each value corresponds to an `executable` " "stanza in the .cabal file. Items from this list are automatically added to " "pkg-plist." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:233 #, no-wrap msgid "`SKIP_CABAL_PLIST`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:235 msgid "If defined, do not add items from `${CABAL_EXECUTABLES}` to pkg-plist." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:236 #, no-wrap msgid "`opt_USE_CABAL`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:238 msgid "Adds items to `${USE_CABAL}` depending on `opt` option." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:239 #, no-wrap msgid "`opt_CABAL_EXECUTABLES`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:241 msgid "Adds items to `${CABAL_EXECUTABLES}` depending on `opt` option." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:242 #, no-wrap msgid "`opt_CABAL_FLAGS`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:246 msgid "" "If `opt` is enabled, append the value to `${CABAL_FLAGS}`. Otherwise, " "append `-value` to disable the flag. Note that this behavior is slightly " "different from the plain `CABAL_FLAGS` as it does not accept values starting " "with `-`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:247 #, no-wrap msgid "`CABAL_WRAPPER_SCRIPTS`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:252 msgid "" "A subset of `${CABAL_EXECUTABLES}` containing Haskell programs to be wrapped " "into a shell script that sets `*_datadir` environment variables before " "running the program. This also causes the actual Haskell binary to be " "installed under `libexec/cabal/` directory. This knob is needed for Haskell " "programs that install their data files under `share/` directory." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:253 #, no-wrap msgid "`FOO_DATADIR_VARS`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:257 msgid "" "List of extra Haskell packages, whose data files should be accessible by the " "executable named `FOO`. The executable should be a part of " "`${CABAL_WRAPPER_SCRIPTS}`. Haskell packages listed there should not have a " "version suffix." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:258 #, no-wrap msgid "`CABAL_PROJECT`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:263 msgid "" "Some Haskell projects may already have a `cabal.project` file, which is also " "generated by the ports framework. If that is the case, use this variable to " "specify what to do with the original `cabal.project`. Setting this variable " "to `remove` will cause the original file to be removed. Setting this " "variable to `append` will:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:264 msgid "" "Move the original file to `cabal.project.${PORTNAME}` during the `extract` " "stage." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:266 msgid "" "Concatenate the original `cabal.project.${PORTNAME}` and the generated " "`cabal.project` into a single file after the `patch` stage. Using `append` " "makes it possible to perform patching on the original file before it gets " "merged." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:268 #, no-wrap msgid "`cargo`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:275 msgid "" "Uses Cargo for configuring, building, and testing. It can be used to port " "Rust applications that use the Cargo build system. For more information see " "crossref:special[using-cargo,Building Rust Applications with `cargo`]." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:277 #, no-wrap msgid "`charsetfix`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:284 msgid "" "Prevents the port from installing [.filename]#charset.alias#. This must be " "installed only by package:converters/libiconv[]. `CHARSETFIX_MAKEFILEIN` " "can be set to a path relative to `WRKSRC` if [.filename]#charset.alias# is " "not installed by [.filename]#${WRKSRC}/Makefile.in#." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:286 #, no-wrap msgid "`cmake`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:289 msgid "Possible arguments: (none), `insource`, `noninja`, `run`, `testing`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:291 msgid "Use CMake for configuring the port and generating a build system." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:295 msgid "" "By default an out-of-source build is performed, leaving the sources in " "`WRKSRC` free from build artifacts. With the `insource` argument, an in-" "source build will be performed instead. This argument should be an " "exception, used only when a regular out-of-source build does not work." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:300 msgid "" "By default Ninja (package:devel/ninja[]) is used for the build. In some " "cases this does not work correctly. With the `noninja` argument, the build " "will use regular `make` for builds. This argument should only be used if a " "Ninja-based build does not work." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:302 msgid "" "With the `run` argument, a run dependency is registered in addition to a " "build dependency." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:305 msgid "" "With the `testing` argument, a test-target is added that uses CTest. When " "running tests the port will be re-configured for testing and re-built." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:307 msgid "For more information see crossref:special[using-cmake,Using `cmake`]." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:309 #, no-wrap msgid "`compiler`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:312 msgid "" "Possible arguments: (none), `env` (default, implicit), `{cpp}17-lang`, `{cpp}" "14-lang`, `{cpp}11-lang`, `gcc-{cpp}11-lib`, `{cpp}11-lib`, `{cpp}0x`, " "`c11`, `nestedfct`, `features`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:316 msgid "" "Determines which compiler to use based on any given wishes. Use `{cpp}17-" "lang` if the port needs a {cpp}17-capable compiler, `{cpp}14-lang` if the " "port needs a {cpp}14-capable compiler, `{cpp}11-lang` if the port needs a " "{cpp}11-capable compiler, `gcc-{cpp}11-lib` if the port needs the `g++` " "compiler with a {cpp}11 library, or `{cpp}11-lib` if the port needs a {cpp}" "11-ready standard library. If the port needs a compiler understanding {cpp}" "0X, C11 or nested functions, the corresponding parameters should be used." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:319 msgid "" "Use `features` to request a list of features supported by the default " "compiler. After including [.filename]#bsd.port.pre.mk# the port can inspect " "the results using these variables:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:321 msgid "" "`COMPILER_TYPE`: the default compiler on the system, either gcc or clang" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:322 msgid "" "`ALT_COMPILER_TYPE`: the alternative compiler on the system, either gcc or " "clang. Only set if two compilers are present in the base system." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:323 msgid "" "`COMPILER_VERSION`: the first two digits of the version of the default " "compiler." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:324 msgid "" "`ALT_COMPILER_VERSION`: the first two digits of the version of the " "alternative compiler, if present." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:325 msgid "`CHOSEN_COMPILER_TYPE`: the chosen compiler, either gcc or clang" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:326 msgid "" "`COMPILER_FEATURES`: the features supported by the default compiler. It " "currently lists the {cpp} library." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:328 #, no-wrap msgid "`cpe`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:335 msgid "" "Include Common Platform Enumeration (CPE) information in package manifest as " "a CPE 2.3 formatted string. See the https://scap.nist.gov/specifications/" "cpe/[CPE specification] for details. To add CPE information to a port, " "follow these steps:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:338 msgid "" "Search for the official CPE entry for the software product either by using " "the NVD's https://web.nvd.nist.gov/view/cpe/search[CPE search engine] or in " "the https://nvd.nist.gov/feeds/xml/cpe/dictionary/official-cpe-" "dictionary_v2.3.xml.gz[official CPE dictionary] (warning, very large XML " "file). _Do not ever make up CPE data._" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:339 msgid "" "Add `cpe` to `USES` and compare the result of `make -V CPE_STR` to the CPE " "dictionary entry. Continue one step at a time until `make -V CPE_STR` is " "correct." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:340 msgid "" "If the product name (second field, defaults to `PORTNAME`) is incorrect, " "define `CPE_PRODUCT`." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:341 msgid "" "If the vendor name (first field, defaults to `CPE_PRODUCT`) is incorrect, " "define `CPE_VENDOR`." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:342 msgid "" "If the version field (third field, defaults to `PORTVERSION`) is incorrect, " "define `CPE_VERSION`." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:343 msgid "" "If the update field (fourth field, defaults to empty) is incorrect, define " "`CPE_UPDATE`." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:344 msgid "" "If it is still not correct, check [.filename]#Mk/Uses/cpe.mk# for additional " "details, or contact the {ports-secteam}." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:345 msgid "" "Derive as much as possible of the CPE name from existing variables such as " "`PORTNAME` and `PORTVERSION`. Use variable modifiers to extract the relevant " "portions from these variables rather than hardcoding the name." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:346 msgid "" "_Always_ run `make -V CPE_STR` and check the output before committing " "anything that changes `PORTNAME` or `PORTVERSION` or any other variable " "which is used to derive `CPE_STR`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:348 #, no-wrap msgid "`cran`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:351 msgid "Possible arguments: (none), `auto-plist`, `compiles`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:355 msgid "" "Uses the Comprehensive R Archive Network. Specify `auto-plist` to " "automatically generate [.filename]#pkg-plist#. Specify `compiles` if the " "port has code that need to be compiled." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:357 #, no-wrap msgid "`desktop-file-utils`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:364 msgid "" "Uses update-desktop-database from package:devel/desktop-file-utils[]. An " "extra post-install step will be run without interfering with any post-" "install steps already in the port [.filename]#Makefile#. A line with " "<> will be added to " "the plist." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:366 #, no-wrap msgid "`desthack`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:371 msgid "" "Changes the behavior of GNU configure to properly support `DESTDIR` in case " "the original software does not." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:373 #, no-wrap msgid "`display`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:376 msgid "Possible arguments: (none), _ARGS_" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:380 msgid "" "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." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:382 #, no-wrap msgid "`dos2unix`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:390 msgid "" "The port has files with line endings in DOS format which need to be " "converted. Several variables can be set to control which files will be " "converted. The default is to convert _all_ files, including binaries. See " "crossref:slow-porting[slow-patch-automatic-replacements,Simple Automatic " "Replacements] for examples." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:392 msgid "`DOS2UNIX_REGEX`: match file names based on a regular expression." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:393 msgid "`DOS2UNIX_FILES`: match literal file names." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:394 msgid "`DOS2UNIX_GLOB`: match file names based on a glob pattern." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:395 msgid "" "`DOS2UNIX_WRKSRC`: the directory from which to start the conversions. " "Defaults to `${WRKSRC}`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:397 #, no-wrap msgid "`drupal`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:400 msgid "Possible arguments: `7`, `module`, `theme`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:405 msgid "" "Automate installation of a port that is a Drupal theme or module. Use with " "the version of Drupal that the port is expecting. For example, " "`USES=drupal:7,module` says that this port creates a Drupal 7 module. A " "Drupal 7 theme can be specified with `USES=drupal:7,theme`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:407 #, no-wrap msgid "`ebur128`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:410 msgid "Possible arguments: (none), `build`, `lib`, `run`, `test`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:415 msgid "" "Adds a dependency on package:audio/ebur128[]. It allows to transparently " "depend on the `rust` or `legacy` variants by using `DEFAULT_VERSIONS` in [." "filename]#make.conf#. For instance, to use the legacy version, use " "`DEFAULT_VERSIONS+=ebur128=legacy`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:419 msgid "" "When no arguments are used, the behavior is the same as if the `lib` " "argument was provided. The rest of the arguments provide the corresponding " "category of dependency." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:421 #, no-wrap msgid "`eigen`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:424 msgid "Possible arguments: 2, 3, build (default), run" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:426 msgid "Add dependency on package:math/eigen[]." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:428 #, no-wrap msgid "`elfctl`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:433 msgid "Change an ELF binary's feature control note by setting ELF_FEATURES." msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:435 #, no-wrap msgid "Uses=elfctl" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:444 #, no-wrap msgid "" "USES= elfctl\n" "ELF_FEATURES=\tfeaturelist:path/to/file1 \\\n" "\t\tfeaturelist:path/to/file1 \\\n" "\t\tfeaturelist:path/to/file2\n" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:449 msgid "" "The format of `featurelist` is described in man:elfctl[1]. The file paths " "are relative to ${BUILD_WRKSRC}." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:451 #, no-wrap msgid "`erlang`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:454 msgid "Possible arguments: (none), `enc`, `rebar`, `rebar3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:459 msgid "" "Adds a build and run time dependency on package:lang/erlang[]. Depending on " "the argument, it adds additional build dependencies. `enc` adds a dependency " "on package:devel/erlang-native-compiler[], `rebar` adds a dependency on " "package:devel/rebar[] and `rebar3` adds a dependency on package:devel/" "rebar3[]." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:461 msgid "In addition, the following variables are available to the port:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:463 msgid "" "`ERL_APP_NAME`: Erlang app name as installed in Erlang's lib dir (minus " "version)" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:464 msgid "`ERL_APP_ROOT`: Root directory for this Erlang app" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:465 msgid "`REBAR_CMD`: Path to the \"rebar\" command" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:466 msgid "`REBAR3_CMD`: Path to the \"rebar3\" command" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:467 msgid "`REBAR_PROFILE`: Rebar profile" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:468 msgid "`REBAR_TARGETS`: Rebar target list (usually compile, maybe escriptize)" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:469 msgid "`ERL_BUILD_NAME`: Build name for rebar3" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:470 msgid "`ERL_BUILD_DEPS`: List of BUILD_DEPENDS in category/portname format" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:471 msgid "`ERL_RUN_DEPS`: List of RUN_DEPENDS in category/portname format" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:472 msgid "`ERL_DOCS`: List of documentation files and directories" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:474 #, no-wrap msgid "`fakeroot`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:480 msgid "" "Changes some default behavior of build systems to allow installing as a " "user. See https://wiki.debian.org/FakeRoot[] for more information on " "`fakeroot`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:482 #, no-wrap msgid "`fam`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:485 msgid "Possible arguments: (none), `fam`, `gamin`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:488 msgid "" "Uses a File Alteration Monitor as a library dependency, either package:devel/" "fam[] or package:devel/gamin[]. End users can set WITH_FAM_SYSTEM to " "specify their preference." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:490 #, no-wrap msgid "`firebird`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:493 msgid "Possible arguments: (none), `25`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:495 msgid "Add a dependency to the client library of the Firebird database." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:497 #, no-wrap msgid "`fonts`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:500 msgid "Possible arguments: (none), `fc`, `fontsdir` (default), `none`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:505 msgid "" "Adds a runtime dependency on tools needed to register fonts. Depending on " "the argument, add a `crossref:plist[plist-keywords-fc,@fc] ${FONTSDIR}` " "line, `crossref:plist[plist-keywords-fontsdir,@fontsdir] ${FONTSDIR}` line, " "or no line if the argument is `none`, to the plist. `FONTSDIR` defaults to " "[.filename]#${PREFIX}/share/fonts/${FONTNAME}# and `FONTNAME` to `${PORTNAME}" "`. Add `FONTSDIR` to `PLIST_SUB` and `SUB_LIST`" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:507 #, no-wrap msgid "`fortran`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:510 msgid "Possible arguments: `gcc` (default)" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:512 msgid "Uses the GNU Fortran compiler." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:514 #, no-wrap msgid "`fuse`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:517 msgid "Possible arguments: `2` (default), `3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:519 msgid "" "The port will depend on the FUSE library and handle the dependency on the " "kernel module depending on the version of FreeBSD." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:521 #, no-wrap msgid "`gem`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:524 msgid "Possible arguments: (none), `noautoplist`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:527 msgid "" "Handle building with RubyGems. If `noautoplist` is used, the packing list " "is not generated automatically." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:529 msgid "This implies `USES=ruby`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:531 #, no-wrap msgid "`gettext`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:537 msgid "" "Deprecated. Will include both <> " "and <>." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:539 #, no-wrap msgid "`gettext-runtime`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:542 msgid "Possible arguments: (none), `lib` (default), `build`, `run`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:546 msgid "" "Uses package:devel/gettext-runtime[]. By default, with no arguments or with " "the `lib` argument, implies a library dependency on [.filename]#libintl." "so#. `build` and `run` implies, respectively a build-time and a run-time " "dependency on [.filename]#gettext#." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:548 #, no-wrap msgid "`gettext-tools`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:551 msgid "Possible arguments: (none), `build` (default), `run`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:555 msgid "" "Uses package:devel/gettext-tools[]. By default, with no argument, or with " "the `build` argument, a build time dependency on [.filename]#msgfmt# is " "registered. With the `run` argument, a run-time dependency is registered." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:557 #, no-wrap msgid "`ghostscript`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:560 msgid "Possible arguments: _X_, `build`, `run`, `nox11`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:565 msgid "" "A specific version _X_ can be used. Possible versions are `7`, `8`, `9`, and " "`agpl` (default). `nox11` indicates that the `-nox11` version of the port " "is required. `build` and `run` add build- and run-time dependencies on " "Ghostscript. The default is both build- and run-time dependencies." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:567 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:581 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:866 #, no-wrap msgid "`gl`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:574 msgid "" "Provides an easy way to depend on GL components. The components should be " "listed in `USE_GL`. The available components are:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:575 #, no-wrap msgid "`egl`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:577 msgid "" "add a library dependency on [.filename]#libEGL.so# from package:graphics/" "libglvnd[]" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:578 #, no-wrap msgid "`gbm`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:580 msgid "" "Add a library dependency on [.filename]#libgbm.so# from package:graphics/" "mesa-libs[]" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:583 msgid "" "Add a library dependency on [.filename]#libGL.so# from package:graphics/" "libglvnd[]" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:584 #, no-wrap msgid "`glesv2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:586 msgid "" "Add a library dependency on [.filename]#libGLESv2.so# from package:graphics/" "libglvnd[]" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:587 #, no-wrap msgid "`glew`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:589 msgid "" "Add a library dependency on [.filename]#libGLEW.so# from package:graphics/" "glew[]" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:590 #, no-wrap msgid "`glu`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:592 msgid "" "Add a library dependency on [.filename]#libGLU.so# from package:graphics/" "libGLU[]" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:593 #, no-wrap msgid "`glut`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:595 msgid "" "Add a library dependency on [.filename]#libglut.so# from package:graphics/" "freeglut[]" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:596 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1612 #, no-wrap msgid "`opengl`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:598 msgid "" "Add a library dependency on [.filename]#libOpenGL.so# from package:graphics/" "libglvnd[]" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:600 #, no-wrap msgid "`gmake`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:605 msgid "" "Uses package:devel/gmake[] as a build-time dependency and sets up the " "environment to use `gmake` as the default `make` for the build." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:607 #, no-wrap msgid "`gnome`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:614 msgid "" "Provides an easy way to depend on GNOME components. The components should " "be listed in `USE_GNOME`. The available components are:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:616 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1073 msgid "`atk`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:617 msgid "`atkmm`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:618 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:849 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1076 msgid "`cairo`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:619 msgid "`cairomm`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:620 msgid "`dconf`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:621 msgid "`esound`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:622 msgid "`evolutiondataserver3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:623 msgid "`gconf2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:624 msgid "`gconfmm26`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:625 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:865 msgid "`gdkpixbuf`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:626 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1087 msgid "`gdkpixbuf2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:627 msgid "`glib12`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:628 msgid "`glib20`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:629 msgid "`glibmm`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:630 msgid "`gnomecontrolcenter3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:631 msgid "`gnomedesktop3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:632 msgid "`gnomedocutils`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:633 msgid "`gnomemenus3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:634 msgid "`gnomemimedata`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:635 msgid "`gnomeprefix`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:636 msgid "`gnomesharp20`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:637 msgid "`gnomevfs2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:638 msgid "`gsound`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:639 msgid "`gtk-update-icon-cache`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:640 msgid "`gtk12`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:641 msgid "`gtk20`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:642 msgid "`gtk30`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:643 msgid "`gtkhtml3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:644 msgid "`gtkhtml4`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:645 msgid "`gtkmm20`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:646 msgid "`gtkmm24`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:647 msgid "`gtkmm30`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:648 msgid "`gtksharp20`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:649 msgid "`gtksourceview`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:650 msgid "`gtksourceview2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:651 msgid "`gtksourceview3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:652 msgid "`gtksourceviewmm3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:653 msgid "`gvfs`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:654 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1261 msgid "`intlhack`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:655 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1262 msgid "`intltool`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:656 msgid "`introspection`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:657 msgid "`libartlgpl2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:658 msgid "`libbonobo`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:659 msgid "`libbonoboui`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:660 msgid "`libgda5`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:661 msgid "`libgda5-ui`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:662 msgid "`libgdamm5`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:663 msgid "`libglade2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:664 msgid "`libgnome`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:665 msgid "`libgnomecanvas`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:666 msgid "`libgnomekbd`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:667 msgid "`libgnomeprint`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:668 msgid "`libgnomeprintui`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:669 msgid "`libgnomeui`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:670 msgid "`libgsf`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:671 msgid "`libgtkhtml`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:672 msgid "`libgtksourceviewmm`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:673 msgid "`libidl`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:674 msgid "`librsvg2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:675 msgid "`libsigc++12`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:676 msgid "`libsigc++20`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:677 msgid "`libwnck`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:678 msgid "`libwnck3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:679 msgid "`libxml++26`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:680 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1112 msgid "`libxml2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:681 msgid "`libxslt`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:682 msgid "`metacity`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:683 msgid "`nautilus3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:684 msgid "`orbit2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:685 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:902 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1123 msgid "`pango`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:686 msgid "`pangomm`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:687 msgid "`pangox-compat`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:688 msgid "`py3gobject3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:689 msgid "`pygnome2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:690 msgid "`pygobject`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:691 msgid "`pygobject3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:692 msgid "`pygtk2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:693 msgid "`pygtksourceview`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:694 msgid "`referencehack`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:695 msgid "`vte`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:696 msgid "`vte3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:699 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1275 msgid "" "The default dependency is build- and run-time, it can be changed with `:" "build` or `:run`. For example:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:704 #, no-wrap msgid "" "USES=\t\tgnome\n" "USE_GNOME=\tgnomemenus3:build intlhack\n" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:707 msgid "See crossref:special[using-gnome,Using GNOME] for more information." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:709 #, no-wrap msgid "`go`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:714 msgid "" "Ports should not be created for Go libs, see crossref:special[go-libs,Go " "Libraries] for more information." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:717 msgid "" "Possible arguments: (none), `N.NN`, `N.NN-devel`, `modules`, `no_targets`, " "`run`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:724 msgid "" "Sets default values and targets used to build Go software. A build " "dependency on the Go compiler port is added, port maintainers can set " "version required. By default the build is performed in GOPATH mode. If Go " "software uses modules, the modules-aware mode can be switched on with " "`modules` argument. `no_targets` will setup build environment like " "`GO_ENV`, `GO_BUILDFLAGS` but skip creating extract and build targets. " "`run` will also add a run dependency on the Go compiler port." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:726 msgid "The build process is controlled by several variables:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:727 #, no-wrap msgid "`GO_MODULE`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:730 msgid "" "The name of the application module as specified by the `module` directive in " "`go.mod`. In most cases, this is the only required variable for ports that " "use Go modules." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:731 #, no-wrap msgid "`GO_PKGNAME`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:736 msgid "" "The name of the Go package when building in GOPATH mode. This is the " "directory that will be created in `${GOPATH}/src`. If not set explicitly " "and `GH_SUBDIR` or `GL_SUBDIR` is present, `GO_PKGNAME` will be inferred " "from it. It is not needed when building in modules-aware mode." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:737 #, no-wrap msgid "`GO_TARGET`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:741 msgid "" "The packages to build. The default value is `${GO_PKGNAME}`. `GO_TARGET` " "can also be a tuple in the form `package:path` where path can be either a " "simple filename or a full path starting with `${PREFIX}`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:742 #, no-wrap msgid "`GO_TESTTARGET`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:745 msgid "" "The packages to test. The default value is `./...` (the current package and " "all subpackages)." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:746 #, no-wrap msgid "`CGO_CFLAGS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:748 msgid "Additional `CFLAGS` values to be passed to the C compiler by `go`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:749 #, no-wrap msgid "`CGO_LDFLAGS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:751 msgid "Additional `LDFLAGS` values to be passed to the C compiler by `go`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:752 #, no-wrap msgid "`GO_BUILDFLAGS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:754 msgid "Additional build arguments to be passed to `go build`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:755 #, no-wrap msgid "`GO_TESTFLAGS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:757 msgid "Additional build arguments to be passed to `go test`." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:759 msgid "" "See crossref:special[using-go,Building Go Applications] for usage examples." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:761 #, no-wrap msgid "`gperf`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:766 msgid "" "Add a buildtime dependency on package:devel/gperf[] if `gperf` is not " "present in the base system." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:768 #, no-wrap msgid "`grantlee`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:771 msgid "Possible arguments: `5`, `selfbuild`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:775 msgid "" "Handle dependency on Grantlee. Specify `5` to depend on the Qt5 based " "version, package:devel/grantlee5[]. `selfbuild` is used internally by " "package:devel/grantlee5[] to get their versions numbers." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:777 #, no-wrap msgid "`groff`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:780 msgid "Possible arguments: `build`, `run`, `both`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:782 msgid "" "Registers a dependency on package:textproc/groff[] if not present in the " "base system." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:784 #, no-wrap msgid "`gssapi`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:787 msgid "" "Possible arguments: (none), `base` (default), `heimdal`, `mit`, `flags`, " "`bootstrap`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:792 msgid "" "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 package:security/heimdal[], or `mit` to use package:" "security/krb5[]." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:794 msgid "" "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." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:796 msgid "These variables are exported for the ports to use:" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:798 msgid "`GSSAPIBASEDIR`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:799 msgid "`GSSAPICPPFLAGS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:800 msgid "`GSSAPIINCDIR`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:801 msgid "`GSSAPILDFLAGS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:802 msgid "`GSSAPILIBDIR`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:803 msgid "`GSSAPILIBS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:804 msgid "`GSSAPI_CONFIGURE_ARGS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:807 msgid "" "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`." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:810 msgid "" "The `bootstrap` option is a special prefix only for use by package:security/" "krb5[] and package:security/heimdal[]. For example, use `bootstrap,mit`." msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:812 #, no-wrap msgid "Typical Use" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:819 #, no-wrap msgid "" "OPTIONS_SINGLE=\tGSSAPI\n" "OPTIONS_SINGLE_GSSAPI=\tGSSAPI_BASE GSSAPI_HEIMDAL GSSAPI_MIT GSSAPI_NONE\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:827 #, no-wrap msgid "" "GSSAPI_BASE_USES=\tgssapi\n" "GSSAPI_BASE_CONFIGURE_ON=\t--with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS}\n" "GSSAPI_HEIMDAL_USES=\tgssapi:heimdal\n" "GSSAPI_HEIMDAL_CONFIGURE_ON=\t--with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS}\n" "GSSAPI_MIT_USES=\tgssapi:mit\n" "GSSAPI_MIT_CONFIGURE_ON=\t--with-gssapi=${GSSAPIBASEDIR} ${GSSAPI_CONFIGURE_ARGS}\n" "GSSAPI_NONE_CONFIGURE_ON=\t--without-gssapi\n" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:832 #, no-wrap msgid "`gstreamer`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:839 msgid "" "Provides an easy way to depend on GStreamer components. The components " "should be listed in `USE_GSTREAMER`. The available components are:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:841 msgid "`a52dec`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:842 msgid "`aalib`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:843 msgid "`amrnb`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:844 msgid "`amrwbdec`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:845 msgid "`aom`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:846 msgid "`assrender`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:847 msgid "`bad`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:848 msgid "`bs2b`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:850 msgid "`cdio`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:851 msgid "`cdparanoia`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:852 msgid "`chromaprint`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:853 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1078 msgid "`curl`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:854 msgid "`dash`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:855 msgid "`dtls`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:856 msgid "`dts`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:857 msgid "`dv`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:858 msgid "`dvd`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:859 msgid "`dvdread`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:860 msgid "`editing-services`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:861 msgid "`faac`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:862 msgid "`faad`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:863 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1085 msgid "`flac`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:864 msgid "`flite`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:867 msgid "`gme`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:868 msgid "`gnonlin`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:869 msgid "`good`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:870 msgid "`gsm`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:871 msgid "`gtk4`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:872 msgid "`gtk`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:873 msgid "`hal`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:874 msgid "`hls`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:875 msgid "`jack`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:876 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1094 msgid "`jpeg`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:877 msgid "`kate`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:878 msgid "`kms`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:879 msgid "`ladspa`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:880 msgid "`lame`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:881 msgid "`libav`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:882 msgid "`libcaca`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:883 msgid "`libde265`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:884 msgid "`libmms`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:885 msgid "`libvisual`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:886 msgid "`lv2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:887 msgid "`mm`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:888 msgid "`modplug`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:889 msgid "`mpeg2dec`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:890 msgid "`mpeg2enc`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:891 msgid "`mpg123`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:892 msgid "`mplex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:893 msgid "`musepack`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:894 msgid "`neon`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:895 msgid "`ogg`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:896 msgid "`opencv`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:897 msgid "`openexr`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:898 msgid "`openh264`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:899 msgid "`openjpeg`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:900 msgid "`openmpt`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:901 msgid "`opus`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:903 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1125 msgid "`png`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:904 msgid "`pulse`" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:905 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1127 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1714 #, no-wrap msgid "`qt`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:906 msgid "`resindvd`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:907 msgid "`rsvg`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:908 msgid "`rtmp`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:909 msgid "`shout2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:910 msgid "`sidplay`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:911 msgid "`smoothstreaming`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:912 msgid "`sndfile`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:913 msgid "`sndio`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:914 msgid "`soundtouch`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:915 msgid "`soup`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:916 msgid "`spandsp`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:917 msgid "`speex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:918 msgid "`srtp`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:919 msgid "`taglib`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:920 msgid "`theora`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:921 msgid "`ttml`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:922 msgid "`twolame`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:923 msgid "`ugly`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:924 msgid "`v4l2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:925 msgid "`vorbis`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:926 msgid "`vpx`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:927 msgid "`vulkan`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:928 msgid "`wavpack`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:929 msgid "`webp`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:930 msgid "`webrtcdsp`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:931 msgid "`x264`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:932 msgid "`x265`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:933 msgid "`x`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:934 msgid "`ximagesrc`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:935 msgid "`zbar`" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:937 #, no-wrap msgid "`guile`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:940 msgid "" "Possible arguments: (none), `_X.Y_`, `flavors`, `build`, `run`, `alias`, " "`conflicts`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:944 msgid "" "Adds a dependency on Guile. By default this is a library dependency on the " "appropriate `libguile*.so`, unless overridden by the `build` and/or `run` " "option. The `alias` option configures `BINARY_ALIAS` appropriately (see " "crossref:makefiles[binary-alias,Use `BINARY_ALIAS`])." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:947 msgid "" "The default version is set by the usual `DEFAULT_VERSIONS` mechanism; if the " "default version is not one of the listed versions, then the latest available " "listed version is used." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:950 msgid "" "Applications using Guile are normally built for only a single Guile " "version. However, extension or library modules should use the `flavors` " "option to build with multiple flavors." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:952 msgid "For more information see crossref:special[using-guile,Using Guile]." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:954 #, no-wrap msgid "`horde`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:961 msgid "" "Add buildtime and runtime dependencies on package:devel/pear-channel-" "horde[]. Other Horde dependencies can be added with `USE_HORDE_BUILD` and " "`USE_HORDE_RUN`. See crossref:special[php-horde,Horde Modules] for more " "information." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:963 #, no-wrap msgid "`iconv`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:966 msgid "" "Possible arguments: (none), `lib`, `build`, `patch`, `translit`, `wchar_t`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:972 msgid "" "Uses `iconv` functions, either from the port package:converters/libiconv[] " "as a build-time and run-time dependency, or from the base system. 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. If the port uses " "the `WCHAR_T` or `//TRANSLIT` iconv extensions, add the relevant arguments " "so that the correct iconv is used. For more information see crossref:" "special[using-iconv,Using `iconv`]." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:974 #, no-wrap msgid "`imake`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:977 msgid "Possible arguments: (none), `env`, `notall`, `noman`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:982 msgid "" "Add package:devel/imake[] as a build-time dependency and run `xmkmf -a` " "during the `configure` stage. If the `env` argument is given, the " "`configure` target is not set. If the `-a` flag is a problem for the port, " "add the `notall` argument. If `xmkmf` does not generate a `install.man` " "target, add the `noman` argument." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:984 #, no-wrap msgid "`kde`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:987 msgid "Possible arguments: `5`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:990 msgid "" "Add dependency on KDE components. See crossref:special[using-kde,Using KDE] " "for more information." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:992 #, no-wrap msgid "`kmod`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:995 msgid "Possible arguments: (none), `debug`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:997 msgid "Fills in the boilerplate for kernel module ports, currently:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:999 msgid "Add `kld` to `CATEGORIES`." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1000 msgid "Set `SSP_UNSAFE`." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1001 msgid "Set `IGNORE` if the kernel sources are not found in `SRC_BASE`." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1002 msgid "" "Define `KMODDIR` to [.filename]#/boot/modules# by default, add it to " "`PLIST_SUB` and `MAKE_ENV`, and create it upon installation. If `KMODDIR` is " "set to [.filename]#/boot/kernel#, it will be rewritten to [.filename]#/boot/" "modules#. This prevents breaking packages when upgrading the kernel due to [." "filename]#/boot/kernel# being renamed to [.filename]#/boot/kernel.old# in " "the process." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1003 msgid "" "Handle cross-referencing kernel modules upon installation and " "deinstallation, using crossref:plist[plist-keywords-kld,`@kld`]." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1004 msgid "" "If the `debug` argument is given, the port can install a debug version of " "the module into [.filename]#KERN_DEBUGDIR#/[.filename]#KMODDIR#. By default, " "`KERN_DEBUGDIR` is copied from `DEBUGDIR` and set to [.filename]#/usr/lib/" "debug#. The framework will take care of creating and removing any required " "directories." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1006 #, no-wrap msgid "`ldap`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1009 msgid "Possible arguments: (none), , client, server" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1017 msgid "" "Registers a dependency on package:net/openldap[]. It uses the specific " "`` (without the dot notation) if set. Otherwise it tries to find " "the currently installed version. If necessary it falls back to the default " "version found in `bsd.default-versions.mk`. `client` specifies a runtime " "dependency on the client library. This is also the default. `server` " "specifies a runtime dependency on the server." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1019 msgid "The following variables can be accessed by the port:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1020 #, no-wrap msgid "`IGNORE_WITH_OPENLDAP`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1022 msgid "" "This variable can be defined if the ports does not support one or more " "versions of OpenLDAP." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1022 #, no-wrap msgid "`WITH_OPENLDAP_VER`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1024 msgid "User defined variable to set OpenLDAP version." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1024 #, no-wrap msgid "`OPENLDAP_VER`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1026 msgid "Detected OpenLDAP version." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1028 #, no-wrap msgid "`lha`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1033 msgid "Set `EXTRACT_SUFX` to `.lzh`" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1035 #, no-wrap msgid "`libarchive`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1041 msgid "" "Registers a dependency on package:archivers/libarchive[]. Any ports " "depending on libarchive must include `USES=libarchive`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1043 #, no-wrap msgid "`libedit`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1049 msgid "" "Registers a dependency on package:devel/libedit[]. Any ports depending on " "libedit must include `USES=libedit`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1051 #, no-wrap msgid "`libtool`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1054 msgid "Possible arguments: (none), `keepla`, `build`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1058 msgid "" "Patches `libtool` scripts. This must be added to all ports that use " "`libtool`. The `keepla` argument can be used to keep [.filename]#.la# " "files. Some ports do not ship with their own copy of libtool and need a " "build time dependency on package:devel/libtool[], use the `:build` argument " "to add such dependency." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1060 #, no-wrap msgid "`linux`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1063 msgid "Possible arguments: `c6`, `c7`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1067 msgid "" "Ports Linux compatibility framework. Specify `c6` to depend on CentOS 6 " "packages. Specify `c7` to depend on CentOS 7 packages. The available " "packages are:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1069 msgid "`allegro`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1070 msgid "`alsa-plugins-oss`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1071 msgid "`alsa-plugins-pulseaudio`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1072 msgid "`alsalib`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1074 msgid "`avahi-libs`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1075 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2125 msgid "`base`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1077 msgid "`cups-libs`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1079 msgid "`cyrus-sasl2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1080 msgid "`dbusglib`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1081 msgid "`dbuslibs`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1082 msgid "`devtools`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1083 msgid "`dri`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1084 msgid "`expat`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1086 msgid "`fontconfig`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1088 msgid "`gnutls`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1089 msgid "`graphite2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1090 msgid "`gtk2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1091 msgid "`harfbuzz`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1092 msgid "`jasper`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1093 msgid "`jbigkit`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1095 msgid "`libasyncns`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1096 msgid "`libaudiofile`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1097 msgid "`libelf`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1098 msgid "`libgcrypt`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1099 msgid "`libgfortran`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1100 msgid "`libgpg-error`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1101 msgid "`libmng`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1102 msgid "`libogg`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1103 msgid "`libpciaccess`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1104 msgid "`libsndfile`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1105 msgid "`libsoup`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1106 msgid "`libssh2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1107 msgid "`libtasn1`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1108 msgid "`libthai`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1109 msgid "`libtheora`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1110 msgid "`libv4l`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1111 msgid "`libvorbis`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1113 msgid "`mikmod`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1114 msgid "`naslibs`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1115 msgid "`ncurses-base`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1116 msgid "`nspr`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1117 msgid "`nss`" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1118 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1395 #, no-wrap msgid "`openal`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1119 msgid "`openal-soft`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1120 msgid "`openldap`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1121 msgid "`openmotif`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1122 msgid "`openssl`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1124 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2266 #, no-wrap msgid "`pixman`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1126 msgid "`pulseaudio-libs`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1128 msgid "`qt-x11`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1129 msgid "`qtwebkit`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1130 msgid "`scimlibs`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1131 msgid "`sdl12`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1132 msgid "`sdlimage`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1133 msgid "`sdlmixer`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1134 msgid "`sqlite3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1135 msgid "`tcl85`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1136 msgid "`tcp_wrappers-libs`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1137 msgid "`tiff`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1138 msgid "`tk85`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1139 msgid "`ucl`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1140 msgid "`xorglibs`" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1142 #, no-wrap msgid "`llvm`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1145 msgid "" "Possible arguments: (none), `_XY_`, min=`_XY_`, max=`_XY_`, build, run, lib" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1153 msgid "" "Adds a dependency on LLVM. By default this is a build dependency unless " "overridden by the `run` or `lib` options. The default version is the one " "set in `LLVM_DEFAULT`. A specific version can be specified as well. The " "minimum and maximum versions can be specified with the `min` and `max` " "parameters respectively. The ports framework export the following variables " "to the port:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1154 #, no-wrap msgid "`LLVM_VERSION`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1156 msgid "Version chosen from the arguments to llvm.mk" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1156 #, no-wrap msgid "`LLVM_PORT`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1158 msgid "Chosen llvm port" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1158 #, no-wrap msgid "`LLVM_CONFIG`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1160 msgid "llvm-config of the chosen port" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1160 #, no-wrap msgid "`LLVM_LIBLLVM`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1162 msgid "libLLVM.so of the chosen port" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1162 #, no-wrap msgid "`LLVM_PREFIX`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1164 msgid "Installation prefix of the chosen port" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1166 #, no-wrap msgid "`localbase`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1169 msgid "Possible arguments: (none), `ldflags`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1174 msgid "" "Ensures that libraries from dependencies in `LOCALBASE` are used instead of " "the ones from the base system. Specify `ldflags` to add `-L${LOCALBASE}/" "lib` to `LDFLAGS` instead of `LIBS`. Ports that depend on libraries that " "are also present in the base system should use this. It is also used " "internally by a few other `USES`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1176 #, no-wrap msgid "`lua`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1179 msgid "" "Possible arguments: (none), `_XY_`, `_XY_+`, `-_XY_`, `_XY_-_ZA_`, `module`, " "`flavors`, `build`, `run`, `env`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1183 msgid "" "Adds a dependency on Lua. By default this is a library dependency, unless " "overridden by the `build` and/or `run` option. The `env` option prevents " "the addition of any dependency, while still defining all the usual variables." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1185 msgid "" "The default version is set by the usual `DEFAULT_VERSIONS` mechanism, unless " "a version or range of versions is specified as an argument, for example, " "`51` or `51-54`." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1188 msgid "" "Applications using Lua are normally built for only a single Lua version. " "However, library modules intended to be loaded by Lua code should use the " "`module` option to build with multiple flavors." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1190 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1209 msgid "For more information see crossref:special[using-lua,Using Lua]." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1192 #, no-wrap msgid "`luajit`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1195 msgid "Possible arguments: (none), `_X_`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1198 msgid "" "Adds a dependency on luajit runtime. A specific version _X_ can be used. " "Possible versions are `luajit`, `luajit-devel`, `luajit-openresty`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1200 msgid "" "After including [.filename]#bsd.port.options.mk# or [.filename]#bsd.port.pre." "mk# the port can inspect these variables:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1201 #, no-wrap msgid "`LUAJIT_VER`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1203 msgid "The selected luajit version" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1203 #, no-wrap msgid "`LUAJIT_INCDIR`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1205 msgid "The path to luajit's header files" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1205 #, no-wrap msgid "`LUAJIT_LUAVER`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1207 msgid "Which luajit spec version is selected (2.0 for luajit, else 2.1)" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1211 #, no-wrap msgid "`lxqt`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1218 msgid "" "Handle dependencies for the LXQt Desktop Environment. Use `USE_LXQT` to " "select the components needed for the port. See crossref:special[using-lxqt," "Using LXQt] for more information." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1220 #, no-wrap msgid "`magick`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1223 msgid "Possible arguments: (none), `_X_`, `build`, `nox11`, `run`, `test`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1228 msgid "" "Add a library dependency on `ImageMagick`. A specific version _X_ can be " "used. Possible versions are `6` and `7` (default). `nox11` indicates that " "the `-nox11` version of the port is required. `build`, `run` and `test` add " "build-, run-time and test dependencies on ImageMagick." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1230 #, no-wrap msgid "`makeinfo`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1235 msgid "" "Add a build-time dependency on `makeinfo` if it is not present in the base " "system." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1237 #, no-wrap msgid "`makeself`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1242 msgid "" "Indicates that the distribution files are makeself archives and sets the " "appropriate dependencies." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1244 #, no-wrap msgid "`mate`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1251 msgid "" "Provides an easy way to depend on MATE components. The components should be " "listed in `USE_MATE`. The available components are:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1253 msgid "`autogen`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1254 msgid "`caja`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1255 msgid "`common`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1256 msgid "`controlcenter`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1257 msgid "`desktop`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1258 msgid "`dialogs`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1259 msgid "`docutils`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1260 msgid "`icontheme`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1263 msgid "`libmatekbd`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1264 msgid "`libmateweather`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1265 msgid "`marco`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1266 msgid "`menus`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1267 msgid "`notificationdaemon`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1268 msgid "`panel`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1269 msgid "`pluma`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1270 msgid "`polkit`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1271 msgid "`session`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1272 msgid "`settingsdaemon`" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1280 #, no-wrap msgid "" "USES=\t\tmate\n" "USE_MATE=\tmenus:build intlhack\n" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1283 #, no-wrap msgid "`meson`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1289 msgid "" "Provide support for Meson based projects. For more information see crossref:" "special[using-meson,Using `meson`]." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1291 #, no-wrap msgid "`metaport`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1296 msgid "" "Sets the following variables to make it easier to create a metaport: " "`MASTER_SITES`, `DISTFILES`, `EXTRACT_ONLY`, `NO_BUILD`, `NO_INSTALL`, " "`NO_MTREE`, `NO_ARCH`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1298 #, no-wrap msgid "`minizip`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1301 msgid "Possible arguments: (none), `ng`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1303 msgid "" "Adds a library dependency on package:archivers/minizip[] or package:" "archivers/minizip-ng[] respectively." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1305 #, no-wrap msgid "`mysql`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1308 msgid "" "Possible arguments: (none), `_version_`, `client` (default), `server`, " "`embedded`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1317 msgid "" "Provide support for MySQL If no version is given, try to find the current " "installed version. Fall back to the default version, MySQL-5.6. The " "possible versions are `55`, `55m`, `55p`, `56`, `56p`, `56w`, `57`, `57p`, " "`80`, `100m`, `101m`, and `102m`. The `m` and `p` suffixes are for the " "MariaDB and Percona variants of MySQL. `server` and `embedded` add a build- " "and run-time dependency on the MySQL server. When using `server` or " "`embedded`, add `client` to also add a dependency on [." "filename]#libmysqlclient.so#. A port can set `IGNORE_WITH_MYSQL` if some " "versions are not supported." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1319 msgid "The framework sets `MYSQL_VER` to the detected MySQL version." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1321 #, no-wrap msgid "`mono`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1324 msgid "Possible arguments: (none), `nuget`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1326 msgid "" "Adds a dependency on the Mono (currently only C#) framework by setting the " "appropriate dependencies." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1330 msgid "" "Specify `nuget` when the port uses nuget packages. `NUGET_DEPENDS` needs to " "be set with the names and versions of the nuget packages in the format " "`_name_=_version_`. An optional package origin can be added using " "`_name_=_version_:_origin_`." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1332 msgid "" "The helper target, `buildnuget`, will output the content of the " "`NUGET_DEPENDS` based on the provided [.filename]#packages.config#." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1334 #, no-wrap msgid "`motif`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1343 msgid "" "Uses package:x11-toolkits/open-motif[] as a library dependency. End users " "can set `WANT_LESSTIF` in [.filename]#make.conf# to use package:x11-toolkits/" "lesstif[] as dependency instead of package:x11-toolkits/open-motif[]. " "Similarly setting `WANT_OPEN_MOTIF_DEVEL` in [.filename]#make.conf# will add " "a dependency on package:x11-toolkits/open-motif-devel[]" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1345 #, no-wrap msgid "`ncurses`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1348 msgid "Possible arguments: (none), `base`, `port`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1350 msgid "Uses ncurses, and causes some useful variables to be set." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1352 #, no-wrap msgid "`nextcloud`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1357 msgid "" "Adds support for Nextcloud applications by adding a run time dependency on " "package:www/nextcloud[]." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1359 #, no-wrap msgid "`ninja`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1362 msgid "Possible arguments: (none), `build`, `make` (default), `run`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1369 msgid "" "If `build` or `run` arguments are specify, it respectively adds a build or " "run time dependency on package:devel/ninja[]. If `make` or no arguments are " "provided, use ninja to build the port instead of make. `make` implies " "`build`. If the variable `NINJA_DEFAULT` is set to `samurai`, then the " "dependencies are set on package:devel/samurai[] instead." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1371 #, no-wrap msgid "`nodejs`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1375 #, no-wrap msgid "" "Possible arguments: (none), `build`, `run`, `current`, `lts`, `10`, `14`, `16`,\n" " `17`.\n" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1378 msgid "" "Uses nodejs. Adds a dependency on package:www/node*[]. If a supported " "version is specified then `run` and/or `build` must be specified too." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1380 #, no-wrap msgid "`objc`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1385 msgid "" "Add objective C dependencies (compiler, runtime library) if the base system " "does not support it." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1387 #, no-wrap msgid "`octave`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1390 msgid "Possible arguments: (none), env" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1393 msgid "" "Uses package:math/octave[]. `env` loads only one `OCTAVE_VERSION` " "environmental variable." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1398 msgid "Possible arguments: `al`, `soft` (default), `si`, `alut`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1403 msgid "" "Uses OpenAL. The backend can be specified, with the software implementation " "as the default. The user can specify a preferred backend with " "`WANT_OPENAL`. Valid values for this knob are `soft` (default) and `si`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1405 #, no-wrap msgid "`pathfix`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1412 msgid "" "Look for [.filename]#Makefile.in# and [.filename]#configure# in " "`PATHFIX_WRKSRC` (defaults to `WRKSRC`) and fix common paths to make sure " "they respect the FreeBSD hierarchy. For example, it fixes the installation " "directory of `pkgconfig`'s [.filename]#.pc# files to [.filename]#${PREFIX}/" "libdata/pkgconfig#. If the port uses `USES=autoreconf`, [." "filename]#Makefile.am# will be added to `PATHFIX_MAKEFILEIN` automatically." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1415 msgid "" "If the port <> it will look for [." "filename]#CMakeLists.txt# in `PATHFIX_WRKSRC`. If needed, that default " "filename can be changed with `PATHFIX_CMAKELISTSTXT`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1417 #, no-wrap msgid "`pear`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1420 msgid "Possible arguments: `env`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1425 msgid "" "Adds a dependency on package:devel/pear[]. It will setup default behavior " "for software using the PHP Extension and Application Repository. Using the " "`env` arguments only sets up the PEAR environment variables. See crossref:" "special[php-pear,PEAR Modules] for more information." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1427 #, no-wrap msgid "`perl5`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1432 msgid "Depends on Perl. The configuration is done using `USE_PERL5`." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1434 msgid "" "`USE_PERL5` can contain the phases in which to use Perl, can be `extract`, " "`patch`, `build`, `run`, or `test`." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1437 msgid "" "`USE_PERL5` can also contain `configure`, `modbuild`, or `modbuildtiny` when " "[.filename]#Makefile.PL#, [.filename]#Build.PL#, or Module::Build::Tiny's " "flavor of [.filename]#Build.PL# is required." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1440 msgid "" "`USE_PERL5` defaults to `build run`. When using `configure`, `modbuild`, or " "`modbuildtiny`, `build` and `run` are implied." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1442 msgid "See crossref:special[using-perl,Using Perl] for more information." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1444 #, no-wrap msgid "`pgsql`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1447 msgid "Possible arguments: (none), `_X.Y_`, `_X.Y_+`, `_X.Y_-`, `_X.Y_-_Z.A_`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1451 msgid "" "Provide support for PostgreSQL. Port maintainer can set version required. " "Minimum and maximum versions or a range can be specified; for example, `9.0-" "`, `8.4+`, `8.4-9.2.`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1456 msgid "" "By default, the added dependency will be the client, but if the port " "requires additional components, this can be done using " "`WANT_PGSQL=_component[:target]_`; for example, `WANT_PGSQL=server:configure " "pltcl plperl`. The available components are:" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1458 msgid "`client`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1459 msgid "`contrib`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1460 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2128 msgid "`docs`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1461 msgid "`pgtcl`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1462 msgid "`plperl`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1463 msgid "`plpython`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1464 msgid "`pltcl`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1465 msgid "`server`" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1467 #, no-wrap msgid "`php`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1470 msgid "" "Possible arguments: (none), `phpize`, `ext`, `zend`, `build`, `cli`, `cgi`, " "`mod`, `web`, `embed`, `pecl`, `flavors`, `noflavors`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1473 msgid "" "Provide support for PHP. Add a runtime dependency on the default PHP " "version, package:lang/php81[]." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1474 #, no-wrap msgid "`phpize`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1477 msgid "Use to build a PHP extension. Enables flavors." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1478 #, no-wrap msgid "`ext`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1481 msgid "Use to build, install and register a PHP extension. Enables flavors." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1482 #, no-wrap msgid "`zend`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1485 msgid "Use to build, install and register a Zend extension. Enables flavors." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1486 #, no-wrap msgid "`build`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1488 msgid "Set PHP also as a build-time dependency." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1489 #, no-wrap msgid "`cli`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1491 msgid "Needs the CLI version of PHP." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1492 #, no-wrap msgid "`cgi`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1494 msgid "Needs the CGI version of PHP." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1495 #, no-wrap msgid "`mod`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1497 msgid "Needs the Apache module for PHP." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1498 #, no-wrap msgid "`web`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1500 msgid "Needs the Apache module or the CGI version of PHP." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1501 #, no-wrap msgid "`embed`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1503 msgid "Needs the embedded library version of PHP." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1504 #, no-wrap msgid "`pecl`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1507 msgid "" "Provide defaults for fetching PHP extensions from the PECL repository. " "Enables flavors." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1508 #, no-wrap msgid "`flavors`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1511 msgid "" "Enable automatic crossref:flavors[flavors-auto-php,PHP flavors] generation. " "Flavors will be generated for all PHP versions, except the ones present in " "<>." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1512 #, no-wrap msgid "`noflavors`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1515 msgid "" "Disable automatic PHP flavors generation. _Must only_ be used with " "extensions provided by PHP itself." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1517 msgid "" "Variables are used to specify which PHP modules are required, as well as " "which version of PHP are supported." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1518 #, no-wrap msgid "`USE_PHP`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1522 msgid "" "The list of required PHP extensions at run-time. Add `:build` to the " "extension name to add a build-time dependency. Example: `pcre xml:build " "gettext`" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1524 #, no-wrap msgid "`IGNORE_WITH_PHP`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1527 msgid "" "The port does not work with PHP of the given version. For possible values " "look at the content of `_ALL_PHP_VERSIONS` in [.filename]#Mk/Uses/php.mk#." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1529 msgid "" "When building a PHP or Zend extension with `:ext` or `:zend`, these " "variables can be set:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1530 #, no-wrap msgid "`PHP_MODNAME`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1533 msgid "The name of the PHP or Zend extension. Default value is `${PORTNAME}`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1534 #, no-wrap msgid "`PHP_HEADER_DIRS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1537 msgid "" "A list of subdirectories from which to install header files. The framework " "will always install the header files that are present in the same directory " "as the extension." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1538 #, no-wrap msgid "`PHP_MOD_PRIO`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1541 msgid "" "The priority at which to load the extension. It is a number between `00` " "and `99`." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1546 msgid "" "For extensions that do not depend on any extension, the priority is " "automatically set to `20`, for extensions that depend on another extension, " "the priority is automatically set to `30`. Some extensions may need to be " "loaded before every other extension, for example package:www/php56-" "opcache[]. Some may need to be loaded after an extension with a priority of " "`30`. In that case, add `PHP_MOD_PRIO=_XX_` in the port's Makefile. For " "example:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1552 #, no-wrap msgid "" "USES=\t\tphp:ext\n" "USE_PHP=\twddx\n" "PHP_MOD_PRIO=\t40\n" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1555 msgid "" "These variables are available to use in `PKGNAMEPREFIX` or `PKGNAMESUFFIX`:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1556 #, no-wrap msgid "`PHP_PKGNAMEPREFIX`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1559 msgid "" "Contains `php_XY_-` where _XY_ is the current flavor's PHP version. Use " "with PHP extensions and modules." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1560 #, no-wrap msgid "`PHP_PKGNAMESUFFIX`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1563 msgid "" "Contains `-php_XY_` where _XY_ is the current flavor's PHP version. Use " "with PHP applications." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1564 #, no-wrap msgid "`PECL_PKGNAMEPREFIX`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1567 msgid "" "Contains `php_XY_-pecl-` where _XY_ is the current flavor's PHP version. " "Use with PECL modules." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1572 msgid "" "With flavors, all PHP extensions, PECL extensions, PEAR modules _must have_ " "a different package name, so they must all use one of these three variables " "in their `PKGNAMEPREFIX` or `PKGNAMESUFFIX`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1575 #, no-wrap msgid "`pkgconfig`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1578 msgid "Possible arguments: (none), `build` (default), `run`, `both`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1582 msgid "" "Uses package: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." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1584 #, no-wrap msgid "`pure`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1587 msgid "Possible arguments: (none), `ffi`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1591 msgid "" "Uses package:lang/pure[]. Largely used for building related pure ports. " "With the `ffi` argument, it implies package:devel/pure-ffi[] as a run-time " "dependency." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1593 #, no-wrap msgid "`pyqt`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1596 msgid "Possible arguments: (none), `4`, `5`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1600 msgid "" "Uses PyQt. If the port is part of PyQT itself, set `PYQT_DIST`. Use " "`USE_PYQT` to select the components the port needs. The available " "components are:" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1602 msgid "`core`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1603 msgid "`dbus`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1604 msgid "`dbussupport`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1605 msgid "`demo`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1606 msgid "`designer`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1607 msgid "`designerplugin`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1608 msgid "`doc`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1609 msgid "`gui`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1610 msgid "`multimedia`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1611 msgid "`network`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1613 msgid "`qscintilla2`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1614 msgid "`sip`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1615 msgid "`sql`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1616 msgid "`svg`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1617 msgid "`test`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1618 msgid "`webkit`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1619 msgid "`xml`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1620 msgid "`xmlpatterns`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1622 msgid "These components are only available with PyQT4:" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1624 msgid "`assistant`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1625 msgid "`declarative`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1626 msgid "`help`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1627 msgid "`phonon`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1628 msgid "`script`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1629 msgid "`scripttools`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1631 msgid "These components are only available with PyQT5:" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1633 msgid "`multimediawidgets`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1634 msgid "`printsupport`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1635 msgid "`qml`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1636 msgid "`serialport`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1637 msgid "`webkitwidgets`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1638 msgid "`widgets`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1640 msgid "" "The default dependency for each component is build- and run-time, to select " "only build or run, add `_build` or `_run` to the component name. For example:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1645 #, no-wrap msgid "" "USES=\t\tpyqt\n" "USE_PYQT=\tcore doc_build designer_run\n" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1648 #, no-wrap msgid "`pytest`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1651 msgid "Possible arguments: (none), 4" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1658 msgid "" "Introduces a new dependency on package:devel/pytest[]. It defines a `do-" "test` target which will run the tests properly. Use the argument to depend " "on a specific package:devel/pytest[] version. For ports using package:devel/" "pytest[] consider using this instead of a specific `do-test` target. The " "framework exposes the following variables to the port:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1659 #, no-wrap msgid "`PYTEST_ARGS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1661 msgid "Additional arguments to pytest (defaults to empty)." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1662 #, no-wrap msgid "`PYTEST_IGNORED_TESTS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1665 msgid "" "lists of `pytest -k` patterns of tests to ignore (defaults to empty). For " "tests which are not expected to pass, such as ones requiring a database " "access." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1666 #, no-wrap msgid "`PYTEST_BROKEN_TESTS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1669 msgid "" "lists of `pytest -k` patterns of tests to ignore (defaults to empty). For " "broken tests which require fixing." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1671 msgid "In addition the following variables may be set by the user:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1672 #, no-wrap msgid "`PYTEST_ENABLE_IGNORED_TESTS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1674 msgid "Enable tests which are otherwise ignored by `PYTEST_IGNORED_TESTS`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1675 #, no-wrap msgid "`PYTEST_ENABLE_BROKEN_TESTS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1677 msgid "Enable tests which are otherwise ignored by `PYTEST_BROKEN_TESTS`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1678 #, no-wrap msgid "`PYTEST_ENABLE_ALL_TESTS`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1681 msgid "" "Enable tests which are otherwise ignored by `PYTEST_IGNORED_TESTS` and " "`PYTEST_BROKEN_TESTS`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1684 #, no-wrap msgid "`python`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1687 msgid "" "Possible arguments: (none), `_X.Y_`, `_X.Y+_`, `_-X.Y_`, `_X.Y-Z.A_`, " "`patch`, `build`, `run`, `test`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1692 msgid "" "Uses Python. A supported version or version range can be specified. If " "Python is only needed at build time, run time or for the tests, it can be " "set as a build, run or test dependency with `build`, `run`, or `test`. If " "Python is also needed during the patch phase, use `patch`. See crossref:" "special[using-python, Using Python] for more information." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1695 msgid "" -"`PYTHON_NO_DEPENDS=yes` can be used when the variables exported by the " +"`USES=python:env` can be used when the variables exported by the " "framework are needed but a dependency on Python is not. It can happen when " "using with <>, and the goal is only to " "fix the shebangs but not add a dependency on Python." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1697 #, no-wrap msgid "`qmail`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1700 msgid "Possible arguments: (none), `build`, `run`, `both`, `vars`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1705 msgid "" "Uses package: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` will only set QMAIL variables for the port to use." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1707 #, no-wrap msgid "`qmake`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1710 msgid "" "Possible arguments: (none), `norecursive`, `outsource`, `no_env`, " "`no_configure`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1712 msgid "" "Uses QMake for configuring. For more information see crossref:special[using-" "qmake,Using `qmake`]." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1717 msgid "Possible arguments: `5`, `6`, `no_env`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1721 msgid "" "Add dependency on Qt components. `no_env` is passed directly to `USES= " "qmake`. See crossref:special[using-qt,Using Qt] for more information." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1723 #, no-wrap msgid "`qt-dist`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1726 #, no-wrap msgid "Possible arguments: (none) or `5` and (none) or `6` and (none) or one of `3d`, `5compat`, `base`, `charts`, `connectivity`, `datavis3d`, `declarative`, `doc` `languageserver`, `gamepad`, `graphicaleffects`, `imageformats`, `locat ion`, `lottie`, `multimedia`, `networkauth`, `positioning`, `quick3d`, `quickcontrols2`, `quickcontrols`, `quicktimeline`, `remoteobjects`, `script`, `scxml `, `sensors`, `serialbus`, `serialport`, `shadertools`, `speech`, `svg`, `tools`, `translations`, `virtualkeyboard`, `wayland`, `webchannel`, `webengine`, `webglplugin`, `websockets`, `webview`, `x11extras`, `xmlpatterns`.\n" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1729 msgid "" "Provides support for building Qt 5 and Qt 6 components. It takes care of " "setting up the appropriate configuration environment for the port to build." msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1731 #, no-wrap msgid "Building Qt 5 Components" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1735 msgid "" "The port is Qt 5's `networkauth` component, which is part of the " "`networkauth` distribution file." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1740 #, no-wrap msgid "" "PORTNAME=\tnetworkauth\n" "DISTVERSION=\t${QT5_VERSION}\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1742 #, no-wrap msgid "USES=\t\tqt-dist:5\n" msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1748 #, no-wrap msgid "Building Qt 6 Components" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1752 msgid "" "The port is Qt 6's `websockets` component, which is part of the `websockets` " "distribution file." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1757 #, no-wrap msgid "" "PORTNAME= websockets\n" "PORTVERSION= ${QT6_VERSION}\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1759 #, no-wrap msgid "USES= qt-dist:6\n" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1764 msgid "" "If `PORTNAME` does not match the component name, it can be passed as an " "argument to `qt-dist`." msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1766 #, no-wrap msgid "Building Qt 5 Components with Different Names" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1770 msgid "" "The port is Qt 5's `gui` component, which is part of the `base` distribution " "file." msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1775 #, no-wrap msgid "" "PORTNAME=\tgui\n" "DISTVERSION=\t${QT5_VERSION}\n" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1777 #, no-wrap msgid "USES=\t\tqt-dist:5,base\n" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1782 #, no-wrap msgid "`readline`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1785 msgid "Possible arguments: (none), `port`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1788 msgid "" "Uses readline as a library dependency, and sets `CPPFLAGS` and `LDFLAGS` as " "necessary. If the `port` argument is used or if readline is not present in " "the base system, add a dependency on package:devel/readline[]" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1791 #, no-wrap msgid "`ruby`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1794 msgid "Possible arguments: (none), `build`, `extconf`, `run`, `setup`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1801 msgid "" "Provide support for Ruby related ports. `(none)` without arguments adds " "runtime dependency on package:lang/ruby[]. `build` adds a dependency on " "package:lang/ruby[] at build time. `extconf` states that the port uses " "extconf.rb to configure. `run` adds a dependency on package:lang/ruby[] at " "run time. This is also the default. `setup` states that the port uses setup." "rb to configure and build." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1803 msgid "The user may have the following variables defined:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1804 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1821 #, no-wrap msgid "`RUBY_VER`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1806 msgid "Alternative short version of ruby in the form of `x.y'." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1807 #, no-wrap msgid "`RUBY_DEFAULT_VER`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1809 msgid "Set to (e.g.) `2.7` to use `ruby27` as the default version." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1810 #, no-wrap msgid "`RUBY_ARCH`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1812 msgid "Set the architecture name (e.g. i386-freebsd7)." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1814 msgid "The following variables are exported to be used by the port:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1815 #, no-wrap msgid "`RUBY`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1820 msgid "" "Set to full path of ruby. If set, the values of the following variables are " "automatically obtained from the ruby executable: `RUBY_ARCH`, " "`RUBY_ARCHLIBDIR`, `RUBY_LIBDIR`, `RUBY_SITEARCHLIBDIR`, `RUBY_SITELIBDIR`, " "`RUBY_VER` and `RUBY_VERSION`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1823 msgid "Set to the alternative short version of ruby in the form of `x.y'." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1824 #, no-wrap msgid "`RUBY_EXTCONF`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1826 msgid "Set to the alternative name of extconf.rb (default: extconf.rb)." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1827 #, no-wrap msgid "`RUBY_EXTCONF_SUBDIRS`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1829 msgid "Set to list of subdirectories, if multiple modules are included." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1830 #, no-wrap msgid "`RUBY_SETUP`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1832 msgid "Set to the alternative name of setup.rb (default: setup.rb)." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1835 #, no-wrap msgid "`samba`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1838 msgid "Possible arguments: `build`, `env`, `lib`, `run`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1843 msgid "" "Handle dependency on Samba. `env` will not add any dependency and only set " "up the variables. `build` and `run` will add build-time and run-time " "dependency on [.filename]#smbd#. `lib` will add a dependency on [." "filename]#libsmbclient.so#. The variables that are exported are:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1844 #, no-wrap msgid "`SAMBAPORT`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1846 msgid "The origin of the default Samba port." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1847 #, no-wrap msgid "`SAMBAINCLUDES`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1849 msgid "The location of the Samba header files." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1850 #, no-wrap msgid "`SAMBALIBS`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1852 msgid "The directory where the Samba shared libraries are available." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1854 #, no-wrap msgid "`scons`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1860 msgid "" "Provide support for the use of package:devel/scons[]. See crossref:" "special[using-scons,Using `scons`] for more information." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1862 #, no-wrap msgid "`shared-mime-info`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1869 msgid "" "Uses update-mime-database from package: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 add " "an crossref:plist[plist-keywords-shared-mime-info,`@shared-mime-info`] entry " "to the plist." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1871 #, no-wrap msgid "`shebangfix`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1877 msgid "" "A lot of software uses incorrect locations for script interpreters, most " "notably [.filename]#/usr/bin/perl# and [.filename]#/bin/bash#. The " "shebangfix macro fixes shebang lines in scripts listed in `SHEBANG_REGEX`, " "`SHEBANG_GLOB`, or `SHEBANG_FILES`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1878 #, no-wrap msgid "`SHEBANG_REGEX`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1881 msgid "" "Contains _one_ extended regular expressions, and is used with the `-iregex` " "argument of man:find[1]. See <>." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1882 #, no-wrap msgid "`SHEBANG_GLOB`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1885 msgid "" "Contains a list of patterns used with the `-name` argument of man:find[1]. " "See <>." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1886 #, no-wrap msgid "`SHEBANG_FILES`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1891 msgid "" "Contains a list of files or man:sh[1] globs. The shebangfix macro is run " "from `${WRKSRC}`, so `SHEBANG_FILES` can contain paths that are relative to " "`${WRKSRC}`. It can also deal with absolute paths if files outside of " "`${WRKSRC}` require patching. See <>." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1893 msgid "" "Currently Bash, Java, Ksh, Lua, Perl, PHP, Python, Ruby, Tcl, and Tk are " "supported by default." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1895 msgid "There are three configuration variables:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1896 #, no-wrap msgid "`SHEBANG_LANG`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1898 msgid "The list of supported interpreters." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1899 #, no-wrap msgid "`_interp__CMD`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1902 msgid "" "The path to the command interpreter on FreeBSD. The default value is " "`${LOCALBASE}/bin/_interp_`." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1903 #, no-wrap msgid "`_interp__OLD_CMD`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1907 msgid "" "The list of wrong invocations of interpreters. These are typically obsolete " "paths, or paths used on other operating systems that are incorrect on " "FreeBSD. They will be replaced by the correct path in `_interp__CMD`." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1911 msgid "" "These will _always_ be part of `_interp__OLD_CMD`: `\"/usr/bin/env " "_interp_\" /bin/_interp_ /usr/bin/_interp_ /usr/local/bin/_interp_`." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1918 msgid "" "`_interp__OLD_CMD` contain multiple values. Any entry with spaces must be " "quoted. See <>." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1924 msgid "" "The fixing of shebangs is done during the `patch` phase. If scripts are " "created with incorrect shebangs during the `build` phase, the build process " "(for example, the [.filename]#configure# script, or the [." "filename]#Makefiles#) must be patched or given the right path (for example, " "with `CONFIGURE_ENV`, `CONFIGURE_ARGS`, `MAKE_ENV`, or `MAKE_ARGS`) to " "generate the right shebangs." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1926 msgid "" "Correct paths for supported interpreters are available in `_interp__CMD`." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1931 msgid "" "When used with <>, and the aim is only to fix the " "shebangs but a dependency on Python itself is not wanted, use " -"`PYTHON_NO_DEPENDS=yes`." +"`USES=python:env` instead." msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1934 #, no-wrap msgid "Adding Another Interpreter to `USES=shebangfix`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1939 msgid "To add another interpreter, set `SHEBANG_LANG`. For example:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1943 #, no-wrap msgid "SHEBANG_LANG=\tlua\n" msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1948 #, no-wrap msgid "Specifying all the Paths When Adding an Interpreter to `USES=shebangfix`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1952 msgid "" "If it was not already defined, and there were no default values for " "`_interp__OLD_CMD` and `_interp__CMD` the Ksh entry could be defined as:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1958 #, no-wrap msgid "" "SHEBANG_LANG=\tksh\n" "ksh_OLD_CMD=\t\"/usr/bin/env ksh\" /bin/ksh /usr/bin/ksh\n" "ksh_CMD=\t${LOCALBASE}/bin/ksh\n" msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1963 #, no-wrap msgid "Adding a Strange Location for an Interpreter" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1969 msgid "" "Some software uses strange locations for an interpreter. For example, an " "application might expect Python to be located in [.filename]#/opt/bin/" "python2.7#. The strange path to be replaced can be declared in the port [." "filename]#Makefile#:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1973 #, no-wrap msgid "python_OLD_CMD=\t/opt/bin/python2.7\n" msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1978 #, no-wrap msgid "`USES=shebangfix` with `SHEBANG_REGEX`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1982 msgid "" "To fix all the files in `${WRKSRC}/scripts` ending in [.filename]#.pl#, [." "filename]#.sh#, or [.filename]#.cgi# do:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1987 #, no-wrap msgid "" "USES=\tshebangfix\n" "SHEBANG_REGEX=\t./scripts/.*\\.(sh|pl|cgi)\n" msgstr "" #. type: delimited block = 6 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1993 msgid "" "`SHEBANG_REGEX` is used by running `find -E`, which uses modern regular " "expressions also known as extended regular expressions. See man:" "re_format[7] for more information." msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:1998 #, no-wrap msgid "`USES=shebangfix` with `SHEBANG_GLOB`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2002 msgid "" "To fix all the files in `${WRKSRC}` ending in [.filename]#.pl# or [." "filename]#.sh#, do:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2007 #, no-wrap msgid "" "USES=\tshebangfix\n" "SHEBANG_GLOB=\t*.sh *.pl\n" msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2012 #, no-wrap msgid "`USES=shebangfix` with `SHEBANG_FILES`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2016 msgid "" "To fix the files [.filename]#script/foobar.pl# and [.filename]#script/*.sh# " "in `${WRKSRC}`, do:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2021 #, no-wrap msgid "" "USES=\tshebangfix\n" "SHEBANG_FILES=\tscripts/foobar.pl scripts/*.sh\n" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2026 #, no-wrap msgid "`sqlite`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2029 msgid "Possible arguments: (none), `2`, `3`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2032 msgid "" "Add a dependency on SQLite. The default version used is 3, but version 2 is " "also possible using the `:2` modifier." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2034 #, no-wrap msgid "`ssl`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2037 msgid "Possible arguments: (none), `build`, `run`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2041 msgid "" "Provide support for OpenSSL. A build- or run-time only dependency can be " "specified using `build` or `run`. These variables are available for the " "port's use, they are also added to `MAKE_ENV`:" msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2042 #, no-wrap msgid "`OPENSSLBASE`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2044 msgid "Path to the OpenSSL installation base." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2045 #, no-wrap msgid "`OPENSSLDIR`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2047 msgid "Path to OpenSSL's configuration files." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2048 #, no-wrap msgid "`OPENSSLLIB`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2050 msgid "Path to the OpenSSL libraries." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2051 #, no-wrap msgid "`OPENSSLINC`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2053 msgid "Path to the OpenSSL includes." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2054 #, no-wrap msgid "`OPENSSLRPATH`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2056 msgid "" "If defined, the path the linker needs to use to find the OpenSSL libraries." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2060 msgid "" "If a port does not build with an OpenSSL flavor, set the `BROKEN_SSL` " "variable, and possibly the `BROKEN_SSL_REASON__flavor_`:" msgstr "" #. type: delimited block . 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2065 #, no-wrap msgid "" "BROKEN_SSL=\tlibressl\n" "BROKEN_SSL_REASON_libressl=\tneeds features only available in OpenSSL\n" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2070 #, no-wrap msgid "`tar`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2074 msgid "" "Possible arguments: (none), `Z`, `bz2`, `bzip2`, `lzma`, `tbz`, `tbz2`, " "`tgz`, `txz`, `xz`, `zst`, `zstd`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2077 msgid "" "Set `EXTRACT_SUFX` to `.tar`, `.tar.Z`, `.tar.bz2`, `.tar.bz2`, `.tar.lzma`, " "`.tbz`, `.tbz2`, `.tgz`, `.txz`, `.tar.xz`, `.tar.zst` or `.tar.zstd` " "respectively." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2079 #, no-wrap msgid "`tcl`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2082 msgid "Possible arguments: _version_, `wrapper`, `build`, `run`, `tea`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2089 msgid "" "Add a dependency on Tcl. A specific version can be requested using " "_version_. The version can be empty, one or more exact version numbers " "(currently `84`, `85`, or `86`), or a minimal version number (currently " "`84+`, `85+` or `86+`). To only request a non version specific wrapper, use " "`wrapper`. A build- or run-time only dependency can be specified using " "`build` or `run`. To build the port using the Tcl Extension Architecture, " "use `tea`. After including [.filename]#bsd.port.pre.mk# the port can " "inspect the results using these variables:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2091 msgid "`TCL_VER`: chosen major.minor version of Tcl" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2092 msgid "`TCLSH`: full path of the Tcl interpreter" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2093 msgid "`TCL_LIBDIR`: path of the Tcl libraries" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2094 msgid "`TCL_INCLUDEDIR`: path of the Tcl C header files" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2095 msgid "`TK_VER`: chosen major.minor version of Tk" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2096 msgid "`WISH`: full path of the Tk interpreter" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2097 msgid "`TK_LIBDIR`: path of the Tk libraries" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2098 msgid "`TK_INCLUDEDIR`: path of the Tk C header files" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2100 #, no-wrap msgid "`terminfo`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2106 msgid "" "Adds crossref:plist[plist-keywords-terminfo,`@terminfo`] to the [." "filename]#plist#. Use when the port installs [.filename]#*.terminfo# files " "in [.filename]#${PREFIX}/share/misc#." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2108 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2143 #, no-wrap msgid "`tex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2114 msgid "" "Provide support for tex. Loads all the default variables for TEX related " "ports and does not add any dependency on any ports." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2116 msgid "Variables are used to specify which TEX modules are required." msgstr "" #. type: Labeled list #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2117 #, no-wrap msgid "`USE_TEX`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2121 msgid "" "The list of required TEX extensions at run-time. Add `:build` to the " "extension name to add a build-time dependency, `:run` to add runtime " "dependency, `:test` for test time dependency, `:extract` for extract time " "dependency. Example: `base texmf:build source:run`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2123 msgid "Current possible arguments are as follows:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2126 msgid "`texmf`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2127 msgid "`source`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2129 msgid "`web2c`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2130 msgid "`kpathsea`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2131 msgid "`ptexenc`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2132 msgid "`basic`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2133 msgid "`tlmgr`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2134 msgid "`texlua`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2135 msgid "`texluajit`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2136 msgid "`synctex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2137 msgid "`xpdfopen`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2138 msgid "`dvipsk`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2139 msgid "`dvipdfmx`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2140 msgid "`xdvik`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2141 msgid "`gbklatex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2142 msgid "`formats`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2144 msgid "`latex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2145 msgid "`pdftex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2146 msgid "`jadetex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2147 msgid "`luatex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2148 msgid "`ptex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2149 msgid "`xetex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2150 msgid "`xmltex`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2151 msgid "`texhash`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2152 msgid "`updmap`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2153 msgid "`fmtutil`" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2155 #, no-wrap msgid "`tk`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2158 msgid "Same as arguments for `tcl`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2161 msgid "" "Small wrapper when using both Tcl and Tk. The same variables are returned " "as when using Tcl." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2163 #, no-wrap msgid "`uidfix`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2169 msgid "" "Changes some default behavior (mostly variables) of the build system to " "allow installing this port as a normal user. Try this in the port before " "using <> or patching." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2171 #, no-wrap msgid "`uniquefiles`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2174 msgid "Possible arguments: (none), `dirs`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2178 msgid "" "Make files or directories 'unique', by adding a prefix or suffix. If the " "`dirs` argument is used, the port needs a prefix (and only a prefix) based " "on `UNIQUE_PREFIX` for standard directories `DOCSDIR`, `EXAMPLESDIR`, " "`DATADIR`, `WWWDIR`, `ETCDIR`. These variables are available for ports:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2180 msgid "" "`UNIQUE_PREFIX`: The prefix to be used for directories and files. Default: " "`${PKGNAMEPREFIX}`." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2181 msgid "" "`UNIQUE_PREFIX_FILES`: A list of files that need to be prefixed. Default: " "empty." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2182 msgid "" "`UNIQUE_SUFFIX`: The suffix to be used for files. Default: `${PKGNAMESUFFIX}" "`." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2183 msgid "" "`UNIQUE_SUFFIX_FILES`: A list of files that need to be suffixed. Default: " "empty." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2185 #, no-wrap msgid "`vala`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2188 msgid "Possible arguments: `build`, `lib`, `no_depend`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2191 msgid "" "Adds build or library dependencies on package:lang/vala[]. The `no_depend` " "argument is reserved for package:lang/vala[] itself." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2193 #, no-wrap msgid "`varnish`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2196 msgid "Possible arguments: `4` (default), `6`, `7`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2199 msgid "" "Handle dependencies on Varnish Cache. Adds a dependency on package:www/" "varnish*[]." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2201 #, no-wrap msgid "`webplugin`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2204 msgid "Possible arguments: (none), `ARGS`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2207 msgid "" "Automatically create and remove symbolic links for each application that " "supports the webplugin framework. `ARGS` can be one of:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2209 msgid "`gecko`: support plug-ins based on Gecko" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2210 msgid "`native`: support plug-ins for Gecko, Opera, and WebKit-GTK" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2211 msgid "`linux`: support Linux plug-ins" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2212 msgid "`all` (default, implicit): support all plug-in types" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2213 msgid "(individual entries): support only the browsers listed" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2215 msgid "These variables can be adjusted:" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2217 msgid "" "`WEBPLUGIN_FILES`: No default, must be set manually. The plug-in files to " "install." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2218 msgid "" "`WEBPLUGIN_DIR`: The directory to install the plug-in files to, default [." "filename]#PREFIX/lib/browser_plugins/WEBPLUGIN_NAME#. Set this if the port " "installs plug-in files outside of the default directory to prevent broken " "symbolic links." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2219 msgid "" "`WEBPLUGIN_NAME`: The final directory to install the plug-in files into, " "default `PKGBASE`." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2221 #, no-wrap msgid "`xfce`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2224 msgid "Possible arguments: (none), `gtk2`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2227 msgid "" "Provide support for Xfce related ports. See crossref:special[using-xfce," "Using Xfce] for details." msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2230 msgid "" "The `gtk2` argument specifies that the port requires GTK2 support. It adds " "additional features provided by some core components, for example, package:" "x11/libxfce4menu[] and package:x11-wm/xfce4-panel[]." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2232 #, no-wrap msgid "`xorg`" msgstr "" #. type: delimited block = 4 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2239 msgid "" "Provides an easy way to depend on X.org components. The components should " "be listed in `USE_XORG`. The available components are:" msgstr "" #. type: Block title #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2241 #, no-wrap msgid "Available X.Org Components" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2245 #, no-wrap msgid "Name" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2247 #, no-wrap msgid "Description" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2248 #, no-wrap msgid "`dmx`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2250 #, no-wrap msgid "DMX extension library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2251 #, no-wrap msgid "`fontenc`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2253 #, no-wrap msgid "The fontenc Library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2254 #, no-wrap msgid "`fontutil`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2256 #, no-wrap msgid "Create an index of X font files in a directory" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2257 #, no-wrap msgid "`ice`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2259 #, no-wrap msgid "Inter Client Exchange library for X11" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2260 #, no-wrap msgid "`libfs`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2262 #, no-wrap msgid "The FS library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2263 #, no-wrap msgid "`pciaccess`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2265 #, no-wrap msgid "Generic PCI access library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2268 #, no-wrap msgid "Low-level pixel manipulation library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2269 #, no-wrap msgid "`sm`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2271 #, no-wrap msgid "Session Management library for X11" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2272 #, no-wrap msgid "`x11`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2274 #, no-wrap msgid "X11 library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2275 #, no-wrap msgid "`xau`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2277 #, no-wrap msgid "Authentication Protocol library for X11" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2278 #, no-wrap msgid "`xaw`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2280 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2283 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2286 #, no-wrap msgid "X Athena Widgets library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2281 #, no-wrap msgid "`xaw6`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2284 #, no-wrap msgid "`xaw7`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2287 #, no-wrap msgid "`xbitmaps`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2289 #, no-wrap msgid "X.Org bitmaps data" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2290 #, no-wrap msgid "`xcb`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2292 #, no-wrap msgid "The X protocol C-language Binding (XCB) library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2293 #, no-wrap msgid "`xcomposite`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2295 #, no-wrap msgid "X Composite extension library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2296 #, no-wrap msgid "`xcursor`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2298 #, no-wrap msgid "X client-side cursor loading library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2299 #, no-wrap msgid "`xdamage`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2301 #, no-wrap msgid "X Damage extension library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2302 #, no-wrap msgid "`xdmcp`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2304 #, no-wrap msgid "X Display Manager Control Protocol library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2305 #, no-wrap msgid "`xext`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2307 #, no-wrap msgid "X11 Extension library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2308 #, no-wrap msgid "`xfixes`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2310 #, no-wrap msgid "X Fixes extension library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2311 #, no-wrap msgid "`xfont`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2313 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2316 #, no-wrap msgid "X font library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2314 #, no-wrap msgid "`xfont2`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2317 #, no-wrap msgid "`xft`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2319 #, no-wrap msgid "Client-sided font API for X applications" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2320 #, no-wrap msgid "`xi`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2322 #, no-wrap msgid "X Input extension library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2323 #, no-wrap msgid "`xinerama`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2325 #, no-wrap msgid "X11 Xinerama library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2326 #, no-wrap msgid "`xkbfile`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2328 #, no-wrap msgid "XKB file library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2329 #, no-wrap msgid "`xmu`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2331 #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2334 #, no-wrap msgid "X Miscellaneous Utilities libraries" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2332 #, no-wrap msgid "`xmuu`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2335 #, no-wrap msgid "`xorg-macros`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2337 #, no-wrap msgid "X.Org development aclocal macros" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2338 #, no-wrap msgid "`xorg-server`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2340 #, no-wrap msgid "X.Org X server and related programs" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2341 #, no-wrap msgid "`xorgproto`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2343 #, no-wrap msgid "xorg protocol headers" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2344 #, no-wrap msgid "`xpm`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2346 #, no-wrap msgid "X Pixmap library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2347 #, no-wrap msgid "`xpresent`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2349 #, no-wrap msgid "X Present Extension library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2350 #, no-wrap msgid "`xrandr`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2352 #, no-wrap msgid "X Resize and Rotate extension library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2353 #, no-wrap msgid "`xrender`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2355 #, no-wrap msgid "X Render extension library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2356 #, no-wrap msgid "`xres`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2358 #, no-wrap msgid "X Resource usage library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2359 #, no-wrap msgid "`xscrnsaver`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2361 #, no-wrap msgid "The XScrnSaver library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2362 #, no-wrap msgid "`xshmfence`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2364 #, no-wrap msgid "Shared memory 'SyncFence' synchronization primitive" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2365 #, no-wrap msgid "`xt`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2367 #, no-wrap msgid "X Toolkit library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2368 #, no-wrap msgid "`xtrans`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2370 #, no-wrap msgid "Abstract network code for X" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2371 #, no-wrap msgid "`xtst`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2373 #, no-wrap msgid "X Test extension" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2374 #, no-wrap msgid "`xv`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2376 #, no-wrap msgid "X Video Extension library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2377 #, no-wrap msgid "`xvmc`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2379 #, no-wrap msgid "X Video Extension Motion Compensation library" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2380 #, no-wrap msgid "`xxf86dga`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2382 #, no-wrap msgid "X DGA Extension" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2383 #, no-wrap msgid "`xxf86vm`" msgstr "" #. type: Table #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2384 #, no-wrap msgid "X Vidmode Extension" msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2387 #, no-wrap msgid "`xorg-cat`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2390 msgid "" "Possible arguments: `app`, `data`, `doc`, `driver`, `font`, `lib`, `proto`, " "`util`, `xserver` and (none) or one off `autotools` (default), `meson`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2394 msgid "" "Provide support for building Xorg components. It takes care of setting up " "common dependencies and an appropriate configuration environment needed. " "This is intended only for Xorg components." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2396 msgid "The category has to match upstream categories." msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2399 msgid "" "The second argument is the build system to use. autotools is the default, " "but meson is also supported." msgstr "" #. type: Title == #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2401 #, no-wrap msgid "`zip`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2404 msgid "Possible arguments: (none), `infozip`" msgstr "" #. type: Plain text #: documentation/content/en/books/porters-handbook/uses/_index.adoc:2406 msgid "" "Indicates that the distribution files use the ZIP compression algorithm. " "For files using the InfoZip algorithm the `infozip` argument must be passed " "to set the appropriate dependencies." msgstr ""