freetype-config.1 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146
  1. .TH FREETYPE-CONFIG 1 "August 2023" "FreeType 2.13.2"
  2. .
  3. .
  4. .SH NAME
  5. .
  6. freetype-config \- Get information about a libfreetype installation
  7. .
  8. .
  9. .SH SYNOPSIS
  10. .
  11. .B freetype-config
  12. .RI [ options ]
  13. .
  14. .
  15. .SH DESCRIPTION
  16. .
  17. .B freetype-config
  18. returns information needed for compiling and linking programs with the
  19. FreeType library, such as linker flags and compilation parameters.
  20. .
  21. Alternatively, it can be used to query information about the
  22. FreeType library version installed on the system, such as the
  23. installation (directory path) prefix or the FreeType version number.
  24. .
  25. .PP
  26. If
  27. .BR pkg-config (1)
  28. is found in the path,
  29. .B freetype-config
  30. acts as a wrapper for
  31. .BR pkg-config .
  32. .
  33. .PP
  34. This program is part of the FreeType package.
  35. .
  36. .
  37. .SH OPTIONS
  38. .
  39. There are two types of options: output/display selection options, and
  40. path override options.
  41. .
  42. .
  43. .SS Output selection options
  44. .
  45. Only one of the output selection options should be given at each program
  46. invocation.
  47. .
  48. .TP
  49. .B \-\-prefix
  50. Return the prefix value of the installed FreeType library (the default
  51. prefix will be `/usr' in most cases for distribution-installed
  52. packages).
  53. .
  54. .TP
  55. .B \-\-exec-prefix
  56. Return the executable prefix value of the installed FreeType library
  57. (will often be the same as the prefix value).
  58. .
  59. .TP
  60. .B \-\-ftversion
  61. Return the FreeType version number, directly derived from file
  62. `freetype.h'.
  63. .
  64. .TP
  65. .B \-\-version
  66. Return the `libtool version' of the FreeType library.
  67. .
  68. .TP
  69. .B \-\-libtool
  70. Return the library name for linking with libtool.
  71. .
  72. .TP
  73. .B \-\-libs
  74. Return compiler flags for linking with the installed FreeType library.
  75. .
  76. .TP
  77. .B \-\-cflags
  78. Return compiler flags for compiling against the installed FreeType library.
  79. .
  80. .TP
  81. .B \-\-static
  82. Make command line options display flags for static linking.
  83. .
  84. .TP
  85. .B \-\-help
  86. Show help and exit.
  87. .
  88. .
  89. .SS Path override options
  90. .
  91. These affect any selected output option, except the libtool version
  92. returned by
  93. .BR \-\-version .
  94. .
  95. .TP
  96. .BI \-\-prefix= PREFIX
  97. Override
  98. .B \-\-prefix
  99. value with
  100. .IR PREFIX .
  101. .
  102. This also sets
  103. .BI \-\-exec-prefix= PREFIX
  104. if option
  105. .B \-\-exec-prefix
  106. is not explicitly given.
  107. .
  108. .TP
  109. .BI \-\-exec-prefix= EPREFIX
  110. Override
  111. .B \-\-exec-prefix
  112. value with
  113. .IR EPREFIX .
  114. .
  115. .
  116. .SH BUGS
  117. In case the libraries FreeType links to are located in non-standard
  118. directories, and
  119. .BR pkg-config (1)
  120. is not available, the output from option
  121. .B \-\-libs
  122. might be incomplete.
  123. .
  124. It is thus recommended to use the
  125. .BR pkg-config (1)
  126. interface instead, which is able to correctly resolve all dependencies.
  127. .
  128. .PP
  129. Setting
  130. .B \-\-exec-prefix
  131. (either explicitly or implicitly) might return incorrect results if
  132. combined with option
  133. .BR \-\-static .
  134. .
  135. The same problem can occur if you set the
  136. .B SYSROOT
  137. environment variable.
  138. .
  139. .
  140. .SH AUTHOR
  141. .
  142. This manual page was contributed by Nis Martensen <[email protected]>,
  143. with further refinements from the FreeType team.
  144. .
  145. .
  146. .\" eof