Chapter 17. Using USES Macros

Table of Contents
17.1. An Introduction to USES
17.2. 7z
17.3. ada
17.4. autoreconf
17.5. blaslapack
17.6. bdb
17.7. bison
17.8. cabal
17.9. cargo
17.10. charsetfix
17.11. cmake
17.12. compiler
17.13. cpe
17.14. cran
17.15. desktop-file-utils
17.16. desthack
17.17. display
17.18. dos2unix
17.19. drupal
17.20. eigen
17.21. fakeroot
17.22. fam
17.23. firebird
17.24. fonts
17.25. fortran
17.26. fuse
17.27. gem
17.28. gettext
17.29. gettext-runtime
17.30. gettext-tools
17.31. ghostscript
17.32. gl
17.33. gmake
17.34. gnome
17.35. go
17.36. gperf
17.37. grantlee
17.38. groff
17.39. gssapi
17.40. horde
17.41. iconv
17.42. imake
17.43. kde
17.44. kmod
17.45. lha
17.46. libarchive
17.47. libedit
17.48. libtool
17.49. linux
17.50. localbase
17.51. lua
17.52. lxqt
17.53. makeinfo
17.54. makeself
17.55. mate
17.56. meson
17.57. metaport
17.58. mysql
17.59. mono
17.60. motif
17.61. ncurses
17.62. ninja
17.63. objc
17.64. openal
17.65. pathfix
17.66. pear
17.67. perl5
17.68. pgsql
17.69. php
17.70. pkgconfig
17.71. pure
17.72. pyqt
17.73. python
17.74. qmail
17.75. qmake
17.76. qt
17.77. qt-dist
17.78. readline
17.79. samba
17.80. scons
17.81. shared-mime-info
17.82. shebangfix
17.83. sqlite
17.84. ssl
17.85. tar
17.86. tcl
17.87. terminfo
17.88. tk
17.89. uidfix
17.90. uniquefiles
17.91. varnish
17.92. webplugin
17.93. xfce
17.94. xorg
17.95. xorg-cat
17.96. zip

17.1. 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 appeneded to the value after a colon (:). Multiple arguments are separated by commas (,).

Example 17.1. Using Multiple Values
USES=	bison perl

Example 17.2. Adding an Argument
USES=	tar:xz

Example 17.3. Adding Multiple Arguments
USES=	drupal:7,theme

Example 17.4. Mixing it All Together
USES=	pgsql:9.3+ cpe python:2.7,build

All FreeBSD documents are available for download at https://download.freebsd.org/ftp/doc/

Questions that are not answered by the documentation may be sent to <freebsd-questions@FreeBSD.org>.
Send questions about this document to <freebsd-doc@FreeBSD.org>.