manual/freetype/original/man1/freetype-config.1

   1 .TH FREETYPE-CONFIG 1 "March 2022" "FreeType 2.12.0"
   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 <nis.martensen@web.de>,
 143 with further refinements from the FreeType team.
 144 .
 145 .
 146 .\" eof