configure-help.txt

   1 `configure' configures TiMidity++ 2.14.0 to adapt to many kinds of systems.
   2
   3 Usage: ./configure [OPTION]... [VAR=VALUE]...
   4
   5 To assign environment variables (e.g., CC, CFLAGS...), specify them as
   6 VAR=VALUE.  See below for descriptions of some of the useful variables.
   7
   8 Defaults for the options are specified in brackets.
   9
  10 Configuration:
  11   -h, --help              display this help and exit
  12       --help=short        display options specific to this package
  13       --help=recursive    display the short help of all the included packages
  14   -V, --version           display version information and exit
  15   -q, --quiet, --silent   do not print `checking ...' messages
  16       --cache-file=FILE   cache test results in FILE [disabled]
  17   -C, --config-cache      alias for `--cache-file=config.cache'
  18   -n, --no-create         do not create output files
  19       --srcdir=DIR        find the sources in DIR [configure dir or `..']
  20
  21 Installation directories:
  22   --prefix=PREFIX         install architecture-independent files in PREFIX
  23                           [/usr/local]
  24   --exec-prefix=EPREFIX   install architecture-dependent files in EPREFIX
  25                           [PREFIX]
  26
  27 By default, `make install' will install all the files in
  28 `/usr/local/bin', `/usr/local/lib' etc.  You can specify
  29 an installation prefix other than `/usr/local' using `--prefix',
  30 for instance `--prefix=$HOME'.
  31
  32 For better control, use the options below.
  33
  34 Fine tuning of the installation directories:
  35   --bindir=DIR            user executables [EPREFIX/bin]
  36   --sbindir=DIR           system admin executables [EPREFIX/sbin]
  37   --libexecdir=DIR        program executables [EPREFIX/libexec]
  38   --sysconfdir=DIR        read-only single-machine data [PREFIX/etc]
  39   --sharedstatedir=DIR    modifiable architecture-independent data [PREFIX/com]
  40   --localstatedir=DIR     modifiable single-machine data [PREFIX/var]
  41   --libdir=DIR            object code libraries [EPREFIX/lib]
  42   --includedir=DIR        C header files [PREFIX/include]
  43   --oldincludedir=DIR     C header files for non-gcc [/usr/include]
  44   --datarootdir=DIR       read-only arch.-independent data root [PREFIX/share]
  45   --datadir=DIR           read-only architecture-independent data [DATAROOTDIR]
  46   --infodir=DIR           info documentation [DATAROOTDIR/info]
  47   --localedir=DIR         locale-dependent data [DATAROOTDIR/locale]
  48   --mandir=DIR            man documentation [DATAROOTDIR/man]
  49   --docdir=DIR            documentation root [DATAROOTDIR/doc/TiMidity++]
  50   --htmldir=DIR           html documentation [DOCDIR]
  51   --dvidir=DIR            dvi documentation [DOCDIR]
  52   --pdfdir=DIR            pdf documentation [DOCDIR]
  53   --psdir=DIR             ps documentation [DOCDIR]
  54
  55 Program names:
  56   --program-prefix=PREFIX            prepend PREFIX to installed program names
  57   --program-suffix=SUFFIX            append SUFFIX to installed program names
  58   --program-transform-name=PROGRAM   run sed PROGRAM on installed program names
  59
  60 X features:
  61   --x-includes=DIR    X include files are in DIR
  62   --x-libraries=DIR   X library files are in DIR
  63
  64 System types:
  65   --build=BUILD     configure for building on BUILD [guessed]
  66   --host=HOST       cross-compile to build programs to run on HOST [BUILD]
  67   --target=TARGET   configure for building compilers for TARGET [HOST]
  68
  69 Optional Features:
  70   --disable-option-checking  ignore unrecognized --enable/--with options
  71   --disable-FEATURE       do not include FEATURE (same as --enable-FEATURE=no)
  72   --enable-FEATURE[=ARG]  include FEATURE [ARG=yes]
  73   --enable-maintainer-mode  enable make rules and dependencies not useful
  74                           (and sometimes confusing) to the casual installer
  75   --enable-debug          Build a debugging version.
  76   --disable-dependency-tracking  speeds up one-time build
  77   --enable-dependency-tracking   do not reject slow dependency extractors
  78   --enable-xft            Enable use of Xft in X trace mode
  79   --enable-audio=mode_list Enable audio (Specify comma separated mode list):
  80                               default:   Automatically select audio device.
  81                               oss:       OSS /dev/dsp
  82                               sun:       SunOS /dev/audio
  83                               hpux:      HPUX /dev/audio
  84                               irix:      IRIX audio library
  85                               mme:       OSF/1 MME
  86                               sb_dsp:    BSD/OS 2.0 /dev/sb_dsp
  87                               w32:       Windows MMS
  88                               darwin:    Darwin CoreAudio
  89                               alsa:      ALSA pcm device
  90                               alib:      HPUX network audio (Alib)
  91                               nas:       NAS - Network Audio System
  92                               arts:      aRts
  93                               esd:       EsounD - Enlightened Sound Daemon
  94                               portaudio: PortAudio
  95                               npipe:     Named Pipe(windows)
  96                               jack:      JACK
  97                               ao:        Libao
  98                               vorbis:    Ogg Vorbis
  99                               flac:      FLAC / OggFLAC
 100                               opus:      Ogg Opus
 101                               speex:     Ogg Speex
 102                               gogo:      MP3 GOGO (Only Windows is supported)
 103                               lame:      LAME (Only Windows is supported)
 104
 105   --disable-alsatest      Do not try to compile and run a test Alsa program
 106   --disable-esdtest       Do not try to compile and run a test ESD program
 107   --disable-aotest        Do not try to compile and run a test ao program
 108   --disable-oggtest       Do not try to compile and run a test Ogg program
 109   --disable-vorbistest    Do not try to compile and run a test Vorbis program
 110   --disable-libFLACtest   Do not try to compile and run a test libFLAC program
 111   --disable-libOggFLACtest
 112                           Do not try to compile and run a test libOggFLAC
 113                           program
 114   --disable-opustest      Do not try to compile and run a test Opus program
 115   --enable-interface=interface_list
 116                           Comma separated interface list
 117   --enable-dynamic        Enable dynamic link interface (default is no)
 118     --enable-dynamic=dynamic_list Comma separated dynamic interface list
 119
 120   --enable-xdnd           Enable xdnd support (default is no)
 121   --enable-ncurses        Enable ncurses interface (default is no)
 122   --enable-slang          Enable slang interface (default is no)
 123   --enable-motif          Enable motif interface (default is no)
 124   --enable-tcltk          Enable tcltk interface (default is no)
 125   --enable-emacs          Enable emacs interface (default is no)
 126   --enable-vt100          Enable VT100 interface (default is no)
 127   --enable-xaw            Enable athena interface (default is no)
 128   --enable-xskin          Enable X skin interface (default is no)
 129   --enable-gtk            Enable GTK+ interface (default is no)
 130   --disable-gtktest       do not try to compile and run a test GTK+ program
 131   --disable-gtktest       Do not try to compile and run a test GTK program
 132   --enable-server         Enable server interface (default is no)
 133   --enable-alsaseq        Enable ALSA sequencer server interface (default is
 134                           no)
 135   --enable-winsyn         Enable Windows Synthesizer interface (default is no)
 136   --enable-portmidisyn    Enable PortMIDI Synthesizer interface (default is
 137                           no)
 138   --enable-npsyn          Enable Windows Named Pipe Synthesizer interface
 139                           (default is no)
 140   --enable-winsyng        Enable Windows GUI Synthesizer interface (default is
 141                           no)
 142   --enable-w32gui         Enable Windows GUI interface (default is no)
 143   --enable-ump            UMP configuration (default is no)
 144   --enable-windrv         Windows Driver interface(requires winsyn)
 145   --enable-offix          Enable offix support (default is no)
 146   --enable-network        Enable network support (default is no)
 147   --enable-thread         Enable thread support (default is no)
 148   --enable-largefile      Enable LargeFile Source support (default is no)
 149   --enable-spectrogram    Enable Sound Spectrogram Viewer (default is no)
 150   --enable-spline=method  Specify spline method. one of
 151                           no,linear,cubic,lagrange,newton,gauss,sharp,linerper,sine,square
 152                           (default is gauss)
 153   --enable-filter=method  Specify filter method. one of
 154                           no,lpf12,lpf24,lpfbw,lpf12x2,lpf24x2,lpf6,lpf18,lpftfo,hpfbw,bpfbw
 155                           (default is no)
 156   --enable-wrd            Enable WRD interface for X (default is no)
 157   --enable-datatype=type  Specify audio data type. one of int32,float,double
 158                           (default is int32)
 159
 160 Optional Packages:
 161   --with-PACKAGE[=ARG]    use PACKAGE [ARG=yes]
 162   --without-PACKAGE       do not use PACKAGE (same as --with-PACKAGE=no)
 163   --with-includes=DIR     Specify include directories (colon separated)
 164   --with-libraries=DIR    Specify library directories (colon separated)
 165   --with-default-path=DIR Where timidity.cfg is (PREFIX/share/timidity)
 166   --with-module-dir=DIR   Where to install interfaces (PREFIX/lib/timidity)
 167   --with-xaw-resource-prefix=DIR
 168                           What prefix to install X resource files to
 169                           (optional, used by Xaw/Motif interfaces)
 170   --with-lispdir          override the default lisp directory
 171   --with-elf              create ELF shared object instead of AOUT
 172   --with-x                use the X Window System
 173   --with-xawlib=lib     Try to link to these xaw widget libraries by the
 174                            order specified by the comma separated value list:
 175                              xaw: libXaw
 176                              xaw3d: Xaw3d
 177                              neXtaw: neXtaw
 178                              XawPlus: XawPlus
 179                              default is --with-xawlib=xaw3d,xaw
 180   --with-tcl-includes=DIR Tcl include file path
 181   --with-tcl-libs=DIR     Tcl library file path
 182   --with-tk-includes=DIR  Tk include file path
 183   --with-tk-libs=DIR      Tk library file path
 184   --with-offix-includes=DIR
 185                           Offix include file path
 186   --with-offix-libs=DIR   Offix include file path
 187   --with-nas-library=library
 188                           NAS absolute library path(Don't use -laudio)
 189   --with-nas-includes=DIR NAS include files are in dir
 190   --with-default-output=<mode>
 191                           Specify default output mode (optional):
 192                           (default|alsa|alib|arts|nas|
 193                           esd|wav|au|aiff|list|vorbis|flac|opus|speex|
 194                           lame|gogo|portaudio|npipe|jack|ao)
 195   --with-alsa-prefix=PFX  Prefix where Alsa library is installed(optional)
 196   --with-alsa-inc-prefix=PFX
 197                           Prefix where include libraries are (optional)
 198   --with-esd-prefix=PFX   Prefix where ESD is installed (optional)
 199   --with-esd-exec-prefix=PFX
 200                           Exec prefix where ESD is installed (optional)
 201   --with-ao=PFX           Prefix where libao is installed (optional)
 202   --with-ao-libraries=DIR Directory where libao library is installed
 203                           (optional)
 204   --with-ao-includes=DIR  Directory where libao header files are installed
 205                           (optional)
 206   --with-ogg=PFX          Prefix where libogg is installed (optional)
 207   --with-ogg-libraries=DIR
 208                           Directory where libogg library is installed
 209                           (optional)
 210   --with-ogg-includes=DIR Directory where libogg header files are installed
 211                           (optional)
 212   --with-vorbis=PFX       Prefix where libvorbis is installed (optional)
 213   --with-vorbis-libraries=DIR
 214                           Directory where libvorbis library is installed
 215                           (optional)
 216   --with-vorbis-includes=DIR
 217                           Directory where libvorbis header files are installed
 218                           (optional)
 219   --with-libFLAC=PFX      Prefix where libFLAC is installed (optional)
 220   --with-libFLAC-libraries=DIR
 221                           Directory where libFLAC library is installed
 222                           (optional)
 223   --with-libFLAC-includes=DIR
 224                           Directory where libFLAC header files are installed
 225                           (optional)
 226   --with-libOggFLAC=PFX   Prefix where libOggFLAC is installed (optional)
 227   --with-libOggFLAC-libraries=DIR
 228                           Directory where libOggFLAC library is installed
 229                           (optional)
 230   --with-libOggFLAC-includes=DIR
 231                           Directory where libOggFLAC header files are
 232                           installed (optional)
 233   --with-opus=PFX         Prefix where libopus is installed (optional)
 234   --with-opus-libraries=DIR
 235                           Directory where libopus library is installed
 236                           (optional)
 237   --with-opus-includes=DIR
 238                           Directory where libopus header files are installed
 239                           (optional)
 240   --with-gtk-prefix=PFX   Prefix where GTK is installed (optional)
 241   --with-gtk-exec-prefix=PFX
 242                           Exec prefix where GTK is installed (optional)
 243
 244 Some influential environment variables:
 245   EMACS       the Emacs editor command
 246   EMACSLOADPATH
 247               the Emacs library search path
 248   CC          C compiler command
 249   CFLAGS      C compiler flags
 250   LDFLAGS     linker flags, e.g. -L<lib dir> if you have libraries in a
 251               nonstandard directory <lib dir>
 252   LIBS        libraries to pass to the linker, e.g. -l<library>
 253   CPPFLAGS    (Objective) C/C++ preprocessor flags, e.g. -I<include dir> if
 254               you have headers in a nonstandard directory <include dir>
 255   CPP         C preprocessor
 256   XMKMF       Path to xmkmf, Makefile generator for X Window System
 257
 258 Use these variables to override the choices made by `configure' or to help
 259 it to find libraries and programs with nonstandard names/locations.
 260
 261 Report bugs to <timidity-talk@lists.sourceforge.net>.