Math Processor Unit Library

868b2b66 (kx 2024-12-20 16:11:07 +0300   1) Installation Instructions
868b2b66 (kx 2024-12-20 16:11:07 +0300   2) *************************
868b2b66 (kx 2024-12-20 16:11:07 +0300   3) 
868b2b66 (kx 2024-12-20 16:11:07 +0300   4)    Copyright (C) 1994-1996, 1999-2002, 2004-2016 Free Software
868b2b66 (kx 2024-12-20 16:11:07 +0300   5) Foundation, Inc.
868b2b66 (kx 2024-12-20 16:11:07 +0300   6) 
868b2b66 (kx 2024-12-20 16:11:07 +0300   7)    Copying and distribution of this file, with or without modification,
868b2b66 (kx 2024-12-20 16:11:07 +0300   8) are permitted in any medium without royalty provided the copyright
868b2b66 (kx 2024-12-20 16:11:07 +0300   9) notice and this notice are preserved.  This file is offered as-is,
868b2b66 (kx 2024-12-20 16:11:07 +0300  10) without warranty of any kind.
868b2b66 (kx 2024-12-20 16:11:07 +0300  11) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  12) Basic Installation
868b2b66 (kx 2024-12-20 16:11:07 +0300  13) ==================
868b2b66 (kx 2024-12-20 16:11:07 +0300  14) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  15)    Briefly, the shell command './configure && make && make install'
868b2b66 (kx 2024-12-20 16:11:07 +0300  16) should configure, build, and install this package.  The following
868b2b66 (kx 2024-12-20 16:11:07 +0300  17) more-detailed instructions are generic; see the 'README' file for
868b2b66 (kx 2024-12-20 16:11:07 +0300  18) instructions specific to this package.  Some packages provide this
868b2b66 (kx 2024-12-20 16:11:07 +0300  19) 'INSTALL' file but do not implement all of the features documented
868b2b66 (kx 2024-12-20 16:11:07 +0300  20) below.  The lack of an optional feature in a given package is not
868b2b66 (kx 2024-12-20 16:11:07 +0300  21) necessarily a bug.  More recommendations for GNU packages can be found
868b2b66 (kx 2024-12-20 16:11:07 +0300  22) in *note Makefile Conventions: (standards)Makefile Conventions.
868b2b66 (kx 2024-12-20 16:11:07 +0300  23) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  24)    The 'configure' shell script attempts to guess correct values for
868b2b66 (kx 2024-12-20 16:11:07 +0300  25) various system-dependent variables used during compilation.  It uses
868b2b66 (kx 2024-12-20 16:11:07 +0300  26) those values to create a 'Makefile' in each directory of the package.
868b2b66 (kx 2024-12-20 16:11:07 +0300  27) It may also create one or more '.h' files containing system-dependent
868b2b66 (kx 2024-12-20 16:11:07 +0300  28) definitions.  Finally, it creates a shell script 'config.status' that
868b2b66 (kx 2024-12-20 16:11:07 +0300  29) you can run in the future to recreate the current configuration, and a
868b2b66 (kx 2024-12-20 16:11:07 +0300  30) file 'config.log' containing compiler output (useful mainly for
868b2b66 (kx 2024-12-20 16:11:07 +0300  31) debugging 'configure').
868b2b66 (kx 2024-12-20 16:11:07 +0300  32) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  33)    It can also use an optional file (typically called 'config.cache' and
868b2b66 (kx 2024-12-20 16:11:07 +0300  34) enabled with '--cache-file=config.cache' or simply '-C') that saves the
868b2b66 (kx 2024-12-20 16:11:07 +0300  35) results of its tests to speed up reconfiguring.  Caching is disabled by
868b2b66 (kx 2024-12-20 16:11:07 +0300  36) default to prevent problems with accidental use of stale cache files.
868b2b66 (kx 2024-12-20 16:11:07 +0300  37) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  38)    If you need to do unusual things to compile the package, please try
868b2b66 (kx 2024-12-20 16:11:07 +0300  39) to figure out how 'configure' could check whether to do them, and mail
868b2b66 (kx 2024-12-20 16:11:07 +0300  40) diffs or instructions to the address given in the 'README' so they can
868b2b66 (kx 2024-12-20 16:11:07 +0300  41) be considered for the next release.  If you are using the cache, and at
868b2b66 (kx 2024-12-20 16:11:07 +0300  42) some point 'config.cache' contains results you don't want to keep, you
868b2b66 (kx 2024-12-20 16:11:07 +0300  43) may remove or edit it.
868b2b66 (kx 2024-12-20 16:11:07 +0300  44) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  45)    The file 'configure.ac' (or 'configure.in') is used to create
868b2b66 (kx 2024-12-20 16:11:07 +0300  46) 'configure' by a program called 'autoconf'.  You need 'configure.ac' if
868b2b66 (kx 2024-12-20 16:11:07 +0300  47) you want to change it or regenerate 'configure' using a newer version of
868b2b66 (kx 2024-12-20 16:11:07 +0300  48) 'autoconf'.
868b2b66 (kx 2024-12-20 16:11:07 +0300  49) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  50)    The simplest way to compile this package is:
868b2b66 (kx 2024-12-20 16:11:07 +0300  51) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  52)   1. 'cd' to the directory containing the package's source code and type
868b2b66 (kx 2024-12-20 16:11:07 +0300  53)      './configure' to configure the package for your system.
868b2b66 (kx 2024-12-20 16:11:07 +0300  54) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  55)      Running 'configure' might take a while.  While running, it prints
868b2b66 (kx 2024-12-20 16:11:07 +0300  56)      some messages telling which features it is checking for.
868b2b66 (kx 2024-12-20 16:11:07 +0300  57) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  58)   2. Type 'make' to compile the package.
868b2b66 (kx 2024-12-20 16:11:07 +0300  59) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  60)   3. Optionally, type 'make check' to run any self-tests that come with
868b2b66 (kx 2024-12-20 16:11:07 +0300  61)      the package, generally using the just-built uninstalled binaries.
868b2b66 (kx 2024-12-20 16:11:07 +0300  62) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  63)   4. Type 'make install' to install the programs and any data files and
868b2b66 (kx 2024-12-20 16:11:07 +0300  64)      documentation.  When installing into a prefix owned by root, it is
868b2b66 (kx 2024-12-20 16:11:07 +0300  65)      recommended that the package be configured and built as a regular
868b2b66 (kx 2024-12-20 16:11:07 +0300  66)      user, and only the 'make install' phase executed with root
868b2b66 (kx 2024-12-20 16:11:07 +0300  67)      privileges.
868b2b66 (kx 2024-12-20 16:11:07 +0300  68) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  69)   5. Optionally, type 'make installcheck' to repeat any self-tests, but
868b2b66 (kx 2024-12-20 16:11:07 +0300  70)      this time using the binaries in their final installed location.
868b2b66 (kx 2024-12-20 16:11:07 +0300  71)      This target does not install anything.  Running this target as a
868b2b66 (kx 2024-12-20 16:11:07 +0300  72)      regular user, particularly if the prior 'make install' required
868b2b66 (kx 2024-12-20 16:11:07 +0300  73)      root privileges, verifies that the installation completed
868b2b66 (kx 2024-12-20 16:11:07 +0300  74)      correctly.
868b2b66 (kx 2024-12-20 16:11:07 +0300  75) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  76)   6. You can remove the program binaries and object files from the
868b2b66 (kx 2024-12-20 16:11:07 +0300  77)      source code directory by typing 'make clean'.  To also remove the
868b2b66 (kx 2024-12-20 16:11:07 +0300  78)      files that 'configure' created (so you can compile the package for
868b2b66 (kx 2024-12-20 16:11:07 +0300  79)      a different kind of computer), type 'make distclean'.  There is
868b2b66 (kx 2024-12-20 16:11:07 +0300  80)      also a 'make maintainer-clean' target, but that is intended mainly
868b2b66 (kx 2024-12-20 16:11:07 +0300  81)      for the package's developers.  If you use it, you may have to get
868b2b66 (kx 2024-12-20 16:11:07 +0300  82)      all sorts of other programs in order to regenerate files that came
868b2b66 (kx 2024-12-20 16:11:07 +0300  83)      with the distribution.
868b2b66 (kx 2024-12-20 16:11:07 +0300  84) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  85)   7. Often, you can also type 'make uninstall' to remove the installed
868b2b66 (kx 2024-12-20 16:11:07 +0300  86)      files again.  In practice, not all packages have tested that
868b2b66 (kx 2024-12-20 16:11:07 +0300  87)      uninstallation works correctly, even though it is required by the
868b2b66 (kx 2024-12-20 16:11:07 +0300  88)      GNU Coding Standards.
868b2b66 (kx 2024-12-20 16:11:07 +0300  89) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  90)   8. Some packages, particularly those that use Automake, provide 'make
868b2b66 (kx 2024-12-20 16:11:07 +0300  91)      distcheck', which can by used by developers to test that all other
868b2b66 (kx 2024-12-20 16:11:07 +0300  92)      targets like 'make install' and 'make uninstall' work correctly.
868b2b66 (kx 2024-12-20 16:11:07 +0300  93)      This target is generally not run by end users.
868b2b66 (kx 2024-12-20 16:11:07 +0300  94) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  95) Compilers and Options
868b2b66 (kx 2024-12-20 16:11:07 +0300  96) =====================
868b2b66 (kx 2024-12-20 16:11:07 +0300  97) 
868b2b66 (kx 2024-12-20 16:11:07 +0300  98)    Some systems require unusual options for compilation or linking that
868b2b66 (kx 2024-12-20 16:11:07 +0300  99) the 'configure' script does not know about.  Run './configure --help'
868b2b66 (kx 2024-12-20 16:11:07 +0300 100) for details on some of the pertinent environment variables.
868b2b66 (kx 2024-12-20 16:11:07 +0300 101) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 102)    You can give 'configure' initial values for configuration parameters
868b2b66 (kx 2024-12-20 16:11:07 +0300 103) by setting variables in the command line or in the environment.  Here is
868b2b66 (kx 2024-12-20 16:11:07 +0300 104) an example:
868b2b66 (kx 2024-12-20 16:11:07 +0300 105) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 106)      ./configure CC=c99 CFLAGS=-g LIBS=-lposix
868b2b66 (kx 2024-12-20 16:11:07 +0300 107) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 108)    *Note Defining Variables::, for more details.
868b2b66 (kx 2024-12-20 16:11:07 +0300 109) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 110) Compiling For Multiple Architectures
868b2b66 (kx 2024-12-20 16:11:07 +0300 111) ====================================
868b2b66 (kx 2024-12-20 16:11:07 +0300 112) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 113)    You can compile the package for more than one kind of computer at the
868b2b66 (kx 2024-12-20 16:11:07 +0300 114) same time, by placing the object files for each architecture in their
868b2b66 (kx 2024-12-20 16:11:07 +0300 115) own directory.  To do this, you can use GNU 'make'.  'cd' to the
868b2b66 (kx 2024-12-20 16:11:07 +0300 116) directory where you want the object files and executables to go and run
868b2b66 (kx 2024-12-20 16:11:07 +0300 117) the 'configure' script.  'configure' automatically checks for the source
868b2b66 (kx 2024-12-20 16:11:07 +0300 118) code in the directory that 'configure' is in and in '..'.  This is known
868b2b66 (kx 2024-12-20 16:11:07 +0300 119) as a "VPATH" build.
868b2b66 (kx 2024-12-20 16:11:07 +0300 120) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 121)    With a non-GNU 'make', it is safer to compile the package for one
868b2b66 (kx 2024-12-20 16:11:07 +0300 122) architecture at a time in the source code directory.  After you have
868b2b66 (kx 2024-12-20 16:11:07 +0300 123) installed the package for one architecture, use 'make distclean' before
868b2b66 (kx 2024-12-20 16:11:07 +0300 124) reconfiguring for another architecture.
868b2b66 (kx 2024-12-20 16:11:07 +0300 125) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 126)    On MacOS X 10.5 and later systems, you can create libraries and
868b2b66 (kx 2024-12-20 16:11:07 +0300 127) executables that work on multiple system types--known as "fat" or
868b2b66 (kx 2024-12-20 16:11:07 +0300 128) "universal" binaries--by specifying multiple '-arch' options to the
868b2b66 (kx 2024-12-20 16:11:07 +0300 129) compiler but only a single '-arch' option to the preprocessor.  Like
868b2b66 (kx 2024-12-20 16:11:07 +0300 130) this:
868b2b66 (kx 2024-12-20 16:11:07 +0300 131) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 132)      ./configure CC="gcc -arch i386 -arch x86_64 -arch ppc -arch ppc64" \
868b2b66 (kx 2024-12-20 16:11:07 +0300 133)                  CXX="g++ -arch i386 -arch x86_64 -arch ppc -arch ppc64" \
868b2b66 (kx 2024-12-20 16:11:07 +0300 134)                  CPP="gcc -E" CXXCPP="g++ -E"
868b2b66 (kx 2024-12-20 16:11:07 +0300 135) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 136)    This is not guaranteed to produce working output in all cases, you
868b2b66 (kx 2024-12-20 16:11:07 +0300 137) may have to build one architecture at a time and combine the results
868b2b66 (kx 2024-12-20 16:11:07 +0300 138) using the 'lipo' tool if you have problems.
868b2b66 (kx 2024-12-20 16:11:07 +0300 139) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 140) Installation Names
868b2b66 (kx 2024-12-20 16:11:07 +0300 141) ==================
868b2b66 (kx 2024-12-20 16:11:07 +0300 142) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 143)    By default, 'make install' installs the package's commands under
868b2b66 (kx 2024-12-20 16:11:07 +0300 144) '/usr/local/bin', include files under '/usr/local/include', etc.  You
868b2b66 (kx 2024-12-20 16:11:07 +0300 145) can specify an installation prefix other than '/usr/local' by giving
868b2b66 (kx 2024-12-20 16:11:07 +0300 146) 'configure' the option '--prefix=PREFIX', where PREFIX must be an
868b2b66 (kx 2024-12-20 16:11:07 +0300 147) absolute file name.
868b2b66 (kx 2024-12-20 16:11:07 +0300 148) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 149)    You can specify separate installation prefixes for
868b2b66 (kx 2024-12-20 16:11:07 +0300 150) architecture-specific files and architecture-independent files.  If you
868b2b66 (kx 2024-12-20 16:11:07 +0300 151) pass the option '--exec-prefix=PREFIX' to 'configure', the package uses
868b2b66 (kx 2024-12-20 16:11:07 +0300 152) PREFIX as the prefix for installing programs and libraries.
868b2b66 (kx 2024-12-20 16:11:07 +0300 153) Documentation and other data files still use the regular prefix.
868b2b66 (kx 2024-12-20 16:11:07 +0300 154) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 155)    In addition, if you use an unusual directory layout you can give
868b2b66 (kx 2024-12-20 16:11:07 +0300 156) options like '--bindir=DIR' to specify different values for particular
868b2b66 (kx 2024-12-20 16:11:07 +0300 157) kinds of files.  Run 'configure --help' for a list of the directories
868b2b66 (kx 2024-12-20 16:11:07 +0300 158) you can set and what kinds of files go in them.  In general, the default
868b2b66 (kx 2024-12-20 16:11:07 +0300 159) for these options is expressed in terms of '${prefix}', so that
868b2b66 (kx 2024-12-20 16:11:07 +0300 160) specifying just '--prefix' will affect all of the other directory
868b2b66 (kx 2024-12-20 16:11:07 +0300 161) specifications that were not explicitly provided.
868b2b66 (kx 2024-12-20 16:11:07 +0300 162) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 163)    The most portable way to affect installation locations is to pass the
868b2b66 (kx 2024-12-20 16:11:07 +0300 164) correct locations to 'configure'; however, many packages provide one or
868b2b66 (kx 2024-12-20 16:11:07 +0300 165) both of the following shortcuts of passing variable assignments to the
868b2b66 (kx 2024-12-20 16:11:07 +0300 166) 'make install' command line to change installation locations without
868b2b66 (kx 2024-12-20 16:11:07 +0300 167) having to reconfigure or recompile.
868b2b66 (kx 2024-12-20 16:11:07 +0300 168) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 169)    The first method involves providing an override variable for each
868b2b66 (kx 2024-12-20 16:11:07 +0300 170) affected directory.  For example, 'make install
868b2b66 (kx 2024-12-20 16:11:07 +0300 171) prefix=/alternate/directory' will choose an alternate location for all
868b2b66 (kx 2024-12-20 16:11:07 +0300 172) directory configuration variables that were expressed in terms of
868b2b66 (kx 2024-12-20 16:11:07 +0300 173) '${prefix}'.  Any directories that were specified during 'configure',
868b2b66 (kx 2024-12-20 16:11:07 +0300 174) but not in terms of '${prefix}', must each be overridden at install time
868b2b66 (kx 2024-12-20 16:11:07 +0300 175) for the entire installation to be relocated.  The approach of makefile
868b2b66 (kx 2024-12-20 16:11:07 +0300 176) variable overrides for each directory variable is required by the GNU
868b2b66 (kx 2024-12-20 16:11:07 +0300 177) Coding Standards, and ideally causes no recompilation.  However, some
868b2b66 (kx 2024-12-20 16:11:07 +0300 178) platforms have known limitations with the semantics of shared libraries
868b2b66 (kx 2024-12-20 16:11:07 +0300 179) that end up requiring recompilation when using this method, particularly
868b2b66 (kx 2024-12-20 16:11:07 +0300 180) noticeable in packages that use GNU Libtool.
868b2b66 (kx 2024-12-20 16:11:07 +0300 181) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 182)    The second method involves providing the 'DESTDIR' variable.  For
868b2b66 (kx 2024-12-20 16:11:07 +0300 183) example, 'make install DESTDIR=/alternate/directory' will prepend
868b2b66 (kx 2024-12-20 16:11:07 +0300 184) '/alternate/directory' before all installation names.  The approach of
868b2b66 (kx 2024-12-20 16:11:07 +0300 185) 'DESTDIR' overrides is not required by the GNU Coding Standards, and
868b2b66 (kx 2024-12-20 16:11:07 +0300 186) does not work on platforms that have drive letters.  On the other hand,
868b2b66 (kx 2024-12-20 16:11:07 +0300 187) it does better at avoiding recompilation issues, and works well even
868b2b66 (kx 2024-12-20 16:11:07 +0300 188) when some directory options were not specified in terms of '${prefix}'
868b2b66 (kx 2024-12-20 16:11:07 +0300 189) at 'configure' time.
868b2b66 (kx 2024-12-20 16:11:07 +0300 190) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 191) Optional Features
868b2b66 (kx 2024-12-20 16:11:07 +0300 192) =================
868b2b66 (kx 2024-12-20 16:11:07 +0300 193) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 194)    If the package supports it, you can cause programs to be installed
868b2b66 (kx 2024-12-20 16:11:07 +0300 195) with an extra prefix or suffix on their names by giving 'configure' the
868b2b66 (kx 2024-12-20 16:11:07 +0300 196) option '--program-prefix=PREFIX' or '--program-suffix=SUFFIX'.
868b2b66 (kx 2024-12-20 16:11:07 +0300 197) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 198)    Some packages pay attention to '--enable-FEATURE' options to
868b2b66 (kx 2024-12-20 16:11:07 +0300 199) 'configure', where FEATURE indicates an optional part of the package.
868b2b66 (kx 2024-12-20 16:11:07 +0300 200) They may also pay attention to '--with-PACKAGE' options, where PACKAGE
868b2b66 (kx 2024-12-20 16:11:07 +0300 201) is something like 'gnu-as' or 'x' (for the X Window System).  The
868b2b66 (kx 2024-12-20 16:11:07 +0300 202) 'README' should mention any '--enable-' and '--with-' options that the
868b2b66 (kx 2024-12-20 16:11:07 +0300 203) package recognizes.
868b2b66 (kx 2024-12-20 16:11:07 +0300 204) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 205)    For packages that use the X Window System, 'configure' can usually
868b2b66 (kx 2024-12-20 16:11:07 +0300 206) find the X include and library files automatically, but if it doesn't,
868b2b66 (kx 2024-12-20 16:11:07 +0300 207) you can use the 'configure' options '--x-includes=DIR' and
868b2b66 (kx 2024-12-20 16:11:07 +0300 208) '--x-libraries=DIR' to specify their locations.
868b2b66 (kx 2024-12-20 16:11:07 +0300 209) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 210)    Some packages offer the ability to configure how verbose the
868b2b66 (kx 2024-12-20 16:11:07 +0300 211) execution of 'make' will be.  For these packages, running './configure
868b2b66 (kx 2024-12-20 16:11:07 +0300 212) --enable-silent-rules' sets the default to minimal output, which can be
868b2b66 (kx 2024-12-20 16:11:07 +0300 213) overridden with 'make V=1'; while running './configure
868b2b66 (kx 2024-12-20 16:11:07 +0300 214) --disable-silent-rules' sets the default to verbose, which can be
868b2b66 (kx 2024-12-20 16:11:07 +0300 215) overridden with 'make V=0'.
868b2b66 (kx 2024-12-20 16:11:07 +0300 216) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 217) Particular systems
868b2b66 (kx 2024-12-20 16:11:07 +0300 218) ==================
868b2b66 (kx 2024-12-20 16:11:07 +0300 219) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 220)    On HP-UX, the default C compiler is not ANSI C compatible.  If GNU CC
868b2b66 (kx 2024-12-20 16:11:07 +0300 221) is not installed, it is recommended to use the following options in
868b2b66 (kx 2024-12-20 16:11:07 +0300 222) order to use an ANSI C compiler:
868b2b66 (kx 2024-12-20 16:11:07 +0300 223) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 224)      ./configure CC="cc -Ae -D_XOPEN_SOURCE=500"
868b2b66 (kx 2024-12-20 16:11:07 +0300 225) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 226) and if that doesn't work, install pre-built binaries of GCC for HP-UX.
868b2b66 (kx 2024-12-20 16:11:07 +0300 227) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 228)    HP-UX 'make' updates targets which have the same time stamps as their
868b2b66 (kx 2024-12-20 16:11:07 +0300 229) prerequisites, which makes it generally unusable when shipped generated
868b2b66 (kx 2024-12-20 16:11:07 +0300 230) files such as 'configure' are involved.  Use GNU 'make' instead.
868b2b66 (kx 2024-12-20 16:11:07 +0300 231) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 232)    On OSF/1 a.k.a. Tru64, some versions of the default C compiler cannot
868b2b66 (kx 2024-12-20 16:11:07 +0300 233) parse its '<wchar.h>' header file.  The option '-nodtk' can be used as a
868b2b66 (kx 2024-12-20 16:11:07 +0300 234) workaround.  If GNU CC is not installed, it is therefore recommended to
868b2b66 (kx 2024-12-20 16:11:07 +0300 235) try
868b2b66 (kx 2024-12-20 16:11:07 +0300 236) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 237)      ./configure CC="cc"
868b2b66 (kx 2024-12-20 16:11:07 +0300 238) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 239) and if that doesn't work, try
868b2b66 (kx 2024-12-20 16:11:07 +0300 240) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 241)      ./configure CC="cc -nodtk"
868b2b66 (kx 2024-12-20 16:11:07 +0300 242) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 243)    On Solaris, don't put '/usr/ucb' early in your 'PATH'.  This
868b2b66 (kx 2024-12-20 16:11:07 +0300 244) directory contains several dysfunctional programs; working variants of
868b2b66 (kx 2024-12-20 16:11:07 +0300 245) these programs are available in '/usr/bin'.  So, if you need '/usr/ucb'
868b2b66 (kx 2024-12-20 16:11:07 +0300 246) in your 'PATH', put it _after_ '/usr/bin'.
868b2b66 (kx 2024-12-20 16:11:07 +0300 247) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 248)    On Haiku, software installed for all users goes in '/boot/common',
868b2b66 (kx 2024-12-20 16:11:07 +0300 249) not '/usr/local'.  It is recommended to use the following options:
868b2b66 (kx 2024-12-20 16:11:07 +0300 250) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 251)      ./configure --prefix=/boot/common
868b2b66 (kx 2024-12-20 16:11:07 +0300 252) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 253) Specifying the System Type
868b2b66 (kx 2024-12-20 16:11:07 +0300 254) ==========================
868b2b66 (kx 2024-12-20 16:11:07 +0300 255) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 256)    There may be some features 'configure' cannot figure out
868b2b66 (kx 2024-12-20 16:11:07 +0300 257) automatically, but needs to determine by the type of machine the package
868b2b66 (kx 2024-12-20 16:11:07 +0300 258) will run on.  Usually, assuming the package is built to be run on the
868b2b66 (kx 2024-12-20 16:11:07 +0300 259) _same_ architectures, 'configure' can figure that out, but if it prints
868b2b66 (kx 2024-12-20 16:11:07 +0300 260) a message saying it cannot guess the machine type, give it the
868b2b66 (kx 2024-12-20 16:11:07 +0300 261) '--build=TYPE' option.  TYPE can either be a short name for the system
868b2b66 (kx 2024-12-20 16:11:07 +0300 262) type, such as 'sun4', or a canonical name which has the form:
868b2b66 (kx 2024-12-20 16:11:07 +0300 263) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 264)      CPU-COMPANY-SYSTEM
868b2b66 (kx 2024-12-20 16:11:07 +0300 265) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 266) where SYSTEM can have one of these forms:
868b2b66 (kx 2024-12-20 16:11:07 +0300 267) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 268)      OS
868b2b66 (kx 2024-12-20 16:11:07 +0300 269)      KERNEL-OS
868b2b66 (kx 2024-12-20 16:11:07 +0300 270) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 271)    See the file 'config.sub' for the possible values of each field.  If
868b2b66 (kx 2024-12-20 16:11:07 +0300 272) 'config.sub' isn't included in this package, then this package doesn't
868b2b66 (kx 2024-12-20 16:11:07 +0300 273) need to know the machine type.
868b2b66 (kx 2024-12-20 16:11:07 +0300 274) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 275)    If you are _building_ compiler tools for cross-compiling, you should
868b2b66 (kx 2024-12-20 16:11:07 +0300 276) use the option '--target=TYPE' to select the type of system they will
868b2b66 (kx 2024-12-20 16:11:07 +0300 277) produce code for.
868b2b66 (kx 2024-12-20 16:11:07 +0300 278) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 279)    If you want to _use_ a cross compiler, that generates code for a
868b2b66 (kx 2024-12-20 16:11:07 +0300 280) platform different from the build platform, you should specify the
868b2b66 (kx 2024-12-20 16:11:07 +0300 281) "host" platform (i.e., that on which the generated programs will
868b2b66 (kx 2024-12-20 16:11:07 +0300 282) eventually be run) with '--host=TYPE'.
868b2b66 (kx 2024-12-20 16:11:07 +0300 283) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 284) Sharing Defaults
868b2b66 (kx 2024-12-20 16:11:07 +0300 285) ================
868b2b66 (kx 2024-12-20 16:11:07 +0300 286) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 287)    If you want to set default values for 'configure' scripts to share,
868b2b66 (kx 2024-12-20 16:11:07 +0300 288) you can create a site shell script called 'config.site' that gives
868b2b66 (kx 2024-12-20 16:11:07 +0300 289) default values for variables like 'CC', 'cache_file', and 'prefix'.
868b2b66 (kx 2024-12-20 16:11:07 +0300 290) 'configure' looks for 'PREFIX/share/config.site' if it exists, then
868b2b66 (kx 2024-12-20 16:11:07 +0300 291) 'PREFIX/etc/config.site' if it exists.  Or, you can set the
868b2b66 (kx 2024-12-20 16:11:07 +0300 292) 'CONFIG_SITE' environment variable to the location of the site script.
868b2b66 (kx 2024-12-20 16:11:07 +0300 293) A warning: not all 'configure' scripts look for a site script.
868b2b66 (kx 2024-12-20 16:11:07 +0300 294) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 295) Defining Variables
868b2b66 (kx 2024-12-20 16:11:07 +0300 296) ==================
868b2b66 (kx 2024-12-20 16:11:07 +0300 297) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 298)    Variables not defined in a site shell script can be set in the
868b2b66 (kx 2024-12-20 16:11:07 +0300 299) environment passed to 'configure'.  However, some packages may run
868b2b66 (kx 2024-12-20 16:11:07 +0300 300) configure again during the build, and the customized values of these
868b2b66 (kx 2024-12-20 16:11:07 +0300 301) variables may be lost.  In order to avoid this problem, you should set
868b2b66 (kx 2024-12-20 16:11:07 +0300 302) them in the 'configure' command line, using 'VAR=value'.  For example:
868b2b66 (kx 2024-12-20 16:11:07 +0300 303) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 304)      ./configure CC=/usr/local2/bin/gcc
868b2b66 (kx 2024-12-20 16:11:07 +0300 305) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 306) causes the specified 'gcc' to be used as the C compiler (unless it is
868b2b66 (kx 2024-12-20 16:11:07 +0300 307) overridden in the site shell script).
868b2b66 (kx 2024-12-20 16:11:07 +0300 308) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 309) Unfortunately, this technique does not work for 'CONFIG_SHELL' due to an
868b2b66 (kx 2024-12-20 16:11:07 +0300 310) Autoconf limitation.  Until the limitation is lifted, you can use this
868b2b66 (kx 2024-12-20 16:11:07 +0300 311) workaround:
868b2b66 (kx 2024-12-20 16:11:07 +0300 312) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 313)      CONFIG_SHELL=/bin/bash ./configure CONFIG_SHELL=/bin/bash
868b2b66 (kx 2024-12-20 16:11:07 +0300 314) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 315) 'configure' Invocation
868b2b66 (kx 2024-12-20 16:11:07 +0300 316) ======================
868b2b66 (kx 2024-12-20 16:11:07 +0300 317) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 318)    'configure' recognizes the following options to control how it
868b2b66 (kx 2024-12-20 16:11:07 +0300 319) operates.
868b2b66 (kx 2024-12-20 16:11:07 +0300 320) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 321) '--help'
868b2b66 (kx 2024-12-20 16:11:07 +0300 322) '-h'
868b2b66 (kx 2024-12-20 16:11:07 +0300 323)      Print a summary of all of the options to 'configure', and exit.
868b2b66 (kx 2024-12-20 16:11:07 +0300 324) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 325) '--help=short'
868b2b66 (kx 2024-12-20 16:11:07 +0300 326) '--help=recursive'
868b2b66 (kx 2024-12-20 16:11:07 +0300 327)      Print a summary of the options unique to this package's
868b2b66 (kx 2024-12-20 16:11:07 +0300 328)      'configure', and exit.  The 'short' variant lists options used only
868b2b66 (kx 2024-12-20 16:11:07 +0300 329)      in the top level, while the 'recursive' variant lists options also
868b2b66 (kx 2024-12-20 16:11:07 +0300 330)      present in any nested packages.
868b2b66 (kx 2024-12-20 16:11:07 +0300 331) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 332) '--version'
868b2b66 (kx 2024-12-20 16:11:07 +0300 333) '-V'
868b2b66 (kx 2024-12-20 16:11:07 +0300 334)      Print the version of Autoconf used to generate the 'configure'
868b2b66 (kx 2024-12-20 16:11:07 +0300 335)      script, and exit.
868b2b66 (kx 2024-12-20 16:11:07 +0300 336) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 337) '--cache-file=FILE'
868b2b66 (kx 2024-12-20 16:11:07 +0300 338)      Enable the cache: use and save the results of the tests in FILE,
868b2b66 (kx 2024-12-20 16:11:07 +0300 339)      traditionally 'config.cache'.  FILE defaults to '/dev/null' to
868b2b66 (kx 2024-12-20 16:11:07 +0300 340)      disable caching.
868b2b66 (kx 2024-12-20 16:11:07 +0300 341) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 342) '--config-cache'
868b2b66 (kx 2024-12-20 16:11:07 +0300 343) '-C'
868b2b66 (kx 2024-12-20 16:11:07 +0300 344)      Alias for '--cache-file=config.cache'.
868b2b66 (kx 2024-12-20 16:11:07 +0300 345) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 346) '--quiet'
868b2b66 (kx 2024-12-20 16:11:07 +0300 347) '--silent'
868b2b66 (kx 2024-12-20 16:11:07 +0300 348) '-q'
868b2b66 (kx 2024-12-20 16:11:07 +0300 349)      Do not print messages saying which checks are being made.  To
868b2b66 (kx 2024-12-20 16:11:07 +0300 350)      suppress all normal output, redirect it to '/dev/null' (any error
868b2b66 (kx 2024-12-20 16:11:07 +0300 351)      messages will still be shown).
868b2b66 (kx 2024-12-20 16:11:07 +0300 352) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 353) '--srcdir=DIR'
868b2b66 (kx 2024-12-20 16:11:07 +0300 354)      Look for the package's source code in directory DIR.  Usually
868b2b66 (kx 2024-12-20 16:11:07 +0300 355)      'configure' can determine that directory automatically.
868b2b66 (kx 2024-12-20 16:11:07 +0300 356) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 357) '--prefix=DIR'
868b2b66 (kx 2024-12-20 16:11:07 +0300 358)      Use DIR as the installation prefix.  *note Installation Names:: for
868b2b66 (kx 2024-12-20 16:11:07 +0300 359)      more details, including other options available for fine-tuning the
868b2b66 (kx 2024-12-20 16:11:07 +0300 360)      installation locations.
868b2b66 (kx 2024-12-20 16:11:07 +0300 361) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 362) '--no-create'
868b2b66 (kx 2024-12-20 16:11:07 +0300 363) '-n'
868b2b66 (kx 2024-12-20 16:11:07 +0300 364)      Run the configure checks, but stop before creating any output
868b2b66 (kx 2024-12-20 16:11:07 +0300 365)      files.
868b2b66 (kx 2024-12-20 16:11:07 +0300 366) 
868b2b66 (kx 2024-12-20 16:11:07 +0300 367) 'configure' also accepts some other, not widely useful, options.  Run
868b2b66 (kx 2024-12-20 16:11:07 +0300 368) 'configure --help' for more details.