Chapter 16. Using USES Macros

Table of Contents
16.1. An Introduction to USES
16.2. 7z
16.3. ada
16.4. autoreconf
16.5. blaslapack
16.6. bdb
16.7. bison
16.8. charsetfix
16.9. cmake
16.10. compiler
16.11. cpe
16.12. cran
16.13. desktop-file-utils
16.14. desthack
16.15. display
16.16. dos2unix
16.17. drupal
16.18. fakeroot
16.19. fam
16.20. firebird
16.21. fonts
16.22. fortran
16.23. fuse
16.24. gecko
16.25. gem
16.26. gettext
16.27. gettext-runtime
16.28. gettext-tools
16.29. ghostscript
16.30. gmake
16.31. gnome
16.32. go
16.33. gperf
16.34. grantlee
16.35. groff
16.36. gssapi
16.37. horde
16.38. iconv
16.39. imake
16.40. kde
16.41. kmod
16.42. lha
16.43. libarchive
16.44. libedit
16.45. libtool
16.46. linux
16.47. localbase
16.48. lua
16.49. lxqt
16.50. makeinfo
16.51. makeself
16.52. mate
16.53. meson
16.54. metaport
16.55. mysql
16.56. mono
16.57. motif
16.58. ncurses
16.59. ninja
16.60. objc
16.61. openal
16.62. pathfix
16.63. pear
16.64. perl5
16.65. pgsql
16.66. php
16.67. pkgconfig
16.68. pure
16.69. pyqt
16.70. python
16.71. qmail
16.72. qmake
16.73. readline
16.74. samba
16.75. scons
16.76. shared-mime-info
16.77. shebangfix
16.78. sqlite
16.79. ssl
16.80. tar
16.81. tcl
16.82. terminfo
16.83. tk
16.84. uidfix
16.85. uniquefiles
16.86. varnish
16.87. webplugin
16.88. xfce
16.89. zip
16.90. zope

16.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 16.1. Using Multiple Values
USES=	bison perl

Example 16.2. Adding an Argument
USES=	gmake:lite

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

Example 16.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>.