summaryrefslogtreecommitdiff
path: root/Build/source/README.5configure
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/README.5configure')
-rw-r--r--Build/source/README.5configure421
1 files changed, 0 insertions, 421 deletions
diff --git a/Build/source/README.5configure b/Build/source/README.5configure
deleted file mode 100644
index b1e00daac07..00000000000
--- a/Build/source/README.5configure
+++ /dev/null
@@ -1,421 +0,0 @@
-(This file was generated by makeinfo and splitinfo.gawk.)
-(Released under the old-style GNU documentation license;
- see sources or other output files for full text.)
-
-7 Configure options
-*******************
-
-Corresponding to the large number of program and library modules there
-are a large number 'configure' options, most of which are described
-here. The command
- 'configure --help'
-at the top level gives an exhaustive list of all global options and a
-few important module-specific ones, whereas, e.g.,
- 'texk/lcdf-typetools/configure --help'
-also displays the 'lcdf-typetools' specific options, which are not shown
-at the top level.
-
- The help text also mentions several influential environment
-variables, but for TeX Live it is better to specify them as assignments
-on the command line.
-
- The './Build' script used to make the binaries shipped with TeX Live
-invokes the top-level 'configure' with a few additional options (*note
-Building::). The defaults discussed below are those for the actual
-'configure' script; invoking 'configure' via './Build' yields different
-results.
-
- Defaults for most options are set at the top level and propagated
-explicitly to all subdirectories. Options specified on the command line
-are checked for consistency but never modified.
-
-7.1 Global configure options
-============================
-
-Here are the global configure options.
-
-7.1.1 '--disable-native-texlive-build'
---------------------------------------
-
-If enabled (the default), build for a TL binary distribution as shipped
-by the TeX user groups. This requires GNU 'make' and implies
-'--enable-multiplatform' and '--enable-cxx-runtime-hack' (unless they
-are explicitly disabled), and enforces '--disable-shared'.
-
- If building TL for a GNU/Linux or other distribution, this should be
-disabled and system versions of most libraries should be used (*note
-Distro builds::).
-
- A related option, '--enable-texlive-build', is automatically passed
-to all subdirectories (and cannot be disabled). Subdirectories that can
-also be built independently from the TL tree (such as 'utils/xindy' and
-'texk/dvipng') but cooperate with TL can use this option to enable
-TL-specific adaptations, such as installation paths.
-
-7.1.2 '--prefix', '--bindir', ...
----------------------------------
-
-These standard Autoconf options specify various installation directories
-as usual. For the complete list, *note Installation directories::.
-
- Also as usual, all values are prefixed by the value of 'DESTDIR', if
-set, on the 'make' command line (*note Installation in a temporary
-location: (automake)Staged Installs.).
-
-7.1.3 '--disable-largefile'
----------------------------
-
-Omit large file support (LFS), which is needed on most 32-bit Unix
-systems for files with 2GB or more. Regardless of this option, the size
-of 'DVI' and 'GF' files must always be <2GB, due to the file format
-specifications.
-
- With LFS, there is no fixed limit on the size of PDF files created by
-'pdftex' or PostScript files created by 'dvips'. The size of PDF images
-included by 'pdftex' or 'luatex' must, however, be <2GB when using
-'poppler' version 0.22 or before (even on 64-bit systems with LFS).
-
-7.1.4 '--disable-missing'
--------------------------
-
-Immediately terminate the build process if a requested program or
-feature must be disabled, e.g., due to missing libraries. This can help
-when figuring out a specific (sub)set of modules to enable.
-
-7.1.5 '--enable-compiler-warnings='LEVEL
-----------------------------------------
-
-Enable various levels of compiler warnings for C, C++, and/or
-Objective C: the LEVEL value can be one of: 'no min yes max all'. The
-default is 'yes' in 'maintainer-mode' (see below) and 'min' otherwise.
-This option defines the variables 'WARNING_[OBJ]C[XX]FLAGS', but these
-variables are not consistently used in all library and program modules.
-At present, these warning flags assume options from the GNU compilers.
-
-7.1.6 '--enable-cxx-runtime-hack'
----------------------------------
-
-If enabled (as it is for the native TL build), when using 'g++', try to
-statically link with 'libstdc++', thus improving portability of the
-resulting binary. *Note Macros for compilers::.
-
-7.1.7 '--enable-maintainer-mode'
---------------------------------
-
-Enable 'make' rules and dependencies not useful (and sometimes
-confusing) to the casual user. This requires current versions of the
-GNU build tools (*note Build system tools::), as it automatically
-rebuilds infrastructure files as needed. *Note 'missing' and
-'AM_MAINTAINER_MODE': (automake)maintainer-mode.
-
-7.1.8 '--enable-multiplatform'
-------------------------------
-
-If enabled (as it is for the native TL build) and '--bindir=DIR' or
-'--libdir=DIR' are not specified, install executables and libraries in
-per-platform subdirectories of 'EPREFIX/bin' and 'EPREFIX/lib' where
-EPREFIX is the value given or implied for 'exec_prefix'. In any case,
-the values for 'bindir' and 'libdir' are automatically propagated to all
-subdirectories.
-
-7.1.9 '--enable-shared'
------------------------
-
-Build shared versions of the TeX-specific libraries such as
-'libkpathsea'. This is not allowed for a native TL build (i.e.,
-'--disable-native-texlive-build' must also be specified).
-
-7.1.10 '--enable-silent-rules'
-------------------------------
-
-Enable the use of less verbose build rules. When using GNU 'make' (or
-any 'make' implementation supporting nested variable expansions), you
-can specify 'V=1' on the 'make' command line to get more verbosity, or
-'V=0' to get less, regardless of this option.
-
-7.1.11 '--without-ln-s'
------------------------
-
-Required when using a system without a working 'ln -s' to build binaries
-for a Unix-like system. However, 'make install' will not create
-anything useful, and might fail.
-
-7.1.12 '--without-x'
---------------------
-
-Disable all programs using the X Window System.
-
-7.2 Program-specific configure options
-======================================
-
-Here are (some of) the program-specific 'configure' options.
-
-7.2.1 '--enable-PROG', '--disable-PROG'
----------------------------------------
-
-Do or do not build and install the program(s) of module 'PROG'.
-
-7.2.2 '--disable-all-pkgs'
---------------------------
-
-Do not build any program modules by default--only those explicitly
-enabled. This is useful when one wants to work on only a single
-program, which is specified with an additional '--enable' option, e.g.,
-'--enable-dvipdfm-x'. It's still simplest to check out and configure
-the whole source tree, but at least only the program you are interested
-in, and its dependencies, are built. *Note Build one package::.
-
- Without this option, all modules are built except those that are
-explicitly disabled or specify 'disable' in their 'ac/withenable.ac'
-fragment.
-
-7.2.3 Configure options for 'texk/web2c'
-----------------------------------------
-
-'--with-banner-add=STR'
-Add 'STR' to the default version string (which is ''TeX Live YEAR'' or
-''Web2C YEAR'') appended to banner lines. This is ignored for a native
-TL build, but distro builds should specify, e.g., '/SOMEDISTRO'.
-
-'--with-editor=CMD'
-Specify the command 'CMD' to invoke from the 'e' option of TeX and
-friends, replacing the default 'vi +%d '%s'' for Unix or 'texworks
---position=%d "%s"' for Windows.
-
-'--with-fontconfig-includes=DIR', '--with-fontconfig-libdir=DIR'
-Building XeTeX on non-Mac systems requires the 'fontconfig' library
-headers and code. If one or both of these options are given, the
-required flags are derived from them; otherwise, they are determined via
-'pkg-config' (if present).
-
-'--with-mf-x-toolkit'
-Use the X toolkit ('libXt') for Metafont (the default is to use the
-lowest-level 'Xlib' support; it seems this has the best chance of
-working across X installations nowadays).
-
-'--disable-dump-share'
-Make the 'fmt'/'base' dump files architecture dependent (somewhat faster
-on LittleEndian architectures).
-
-'--disable-ipc'
-Disable TeX's '--ipc' option.
-
-'--disable-mf-nowin'
-Do not build a separate non-graphically-capable Metafont ('mf-nowin').
-
-'--disable-tex', '--enable-etex', ...
-Do not or do build the various TeX, Metafont, and MetaPost engines
-(defaults are defined in the fragment 'texk/web2c/ac/web2c.ac').
-
-'--disable-web-progs'
-Do not build the original WEB programs 'bibtex', ..., 'weave'. Useful
-if, e.g., you only want to (re)build some engines.
-
-'--enable-auto-core'
-This option causes TeX and Metafont to produce a core dump when a
-particular hacky filename is encountered, for use in creating preloaded
-binaries. This is rarely done nowadays.
-
-'--enable-libtool-hack'
-If enabled (which is the default for all platforms), prevents 'libtool'
-from linking explicitly with dependencies of 'libfontconfig' such as
-'libexpat'.
-
-'--enable-*win'
-Include various types of non-X window support for Metafont (EPSF output,
-'mftalk', old graphics terminals, ...).
-
-'--enable-tex-synctex', '--disable-etex-synctex', ...
-Build the TeX engines with or without 'SyncTeX' support; ignored for a
-native TeX Live build. Defaults are defined in
-'texk/web2c/ac/web2c.ac'.
-
-'--disable-synctex'
-Do not build the 'SyncTeX' library and tool.
-
-7.2.4 Configure options for 'texk/bibtex-x'
--------------------------------------------
-
-The programs 'bibtex8' and 'bibtexu' have been merged into the module
-'bibtex-x' (extended BibTeX).
-
-'--disable-bibtex8'
-Do not build the 'bibtex8' program.
-
-'--disable-bibtexu'
-Do not build the 'bibtexu' program (building 'bibtexu' requires 'ICU'
-libraries).
-
-7.2.5 Configure options for 'texk/dvipdfm-x'
---------------------------------------------
-
-The former modules 'dvipdfmx' (extended DVI to PDF converter) and
-'xdvipdfmx' (the same, as used by XeTeX) have been merged into
-'dvipdfm-x' at the source level. Two separate binaries are still
-created by default. In addition, 'dvipdfm' is created as a symlink to
-'dvipdfmx', with backward-compatible (very slightly different) behavior.
-
-'--disable-dvipdfmx'
-Do not build the 'dvipdfmx' program or make the 'dvipdfm' symlink.
-
-'--disable-xdvipdfmx'
-Do not build the 'xdvipdfmx' program.
-
-7.2.6 Configure options for 'texk/dvisvgm'
-------------------------------------------
-
-'--with-system-libgs'
-Build 'dvisvgm' using installed Ghostscript ('gs') headers and library
-(not allowed for a native TL build). The default is to load the 'gs'
-library at runtime if possible, else to disable support for PostScript
-specials.
-
-'--without-libgs'
-Build 'dvisvgm' without PostScript support at all. Because the dynamic
-loading just mentioned defeats all attempts at static linking, the
-result can crash due to library incompatibilities, e.g., on CentOS 5.
-
-'--with-libgs-includes=DIR', '--with-libgs-libdir=DIR'
-Specify non-standard locations of the Ghostscript headers and library.
-
-7.2.7 Configure options for 'texk/texlive'
-------------------------------------------
-
-'--disable-linked-scripts'
-Do not install the "linked scripts" (*note Linked scripts::), except for
-the TL scripts required to run 'texlinks'.
-
-7.2.8 Configure options for 'texk/xdvik'
-----------------------------------------
-
-'--with-gs=FILENAME'
-Hardwire the location of Ghostscript ('gs') as called by Xdvik.
-
-'--with-xdvi-x-toolkit=KIT'
-Use toolkit 'KIT' for 'xdvik', one of: 'motif xaw xaw3d neXtaw'. The
-default is 'motif' if available, else 'xaw'.
-
-'--enable-xi2-scrolling'
-Use XInput 2.1 "smooth scrolling" if available (default: yes, except for
-a native TL build).
-
-7.2.9 Configure options for 'utils/xindy'
------------------------------------------
-
-'--enable-xindy-rules'
-Build and install 'xindy' rules (default: yes, except for a native TL
-build).
-
-'--enable-xindy-docs'
-Build and install 'xindy' documentation (default: yes, except for a
-native TL build).
-
-'--with-clisp-runtime=FILENAME'
-Specifies the full path for the Clisp runtime file ('lisp.run' or
-'lisp.exe') to be installed. When specified as 'default' (the default
-for a native TL build) the path is determined by the Clisp executable;
-the value 'system' (not allowed for a native TL build, but the default
-otherwise) indicates that 'xindy' will use the installed version of
-'clisp' (which must be identical to the one used to build 'xindy').
-
-7.3 Library-specific configure options
-======================================
-
-Here are (some of) the library-specific 'configure' options, starting
-with this generic one:
-
-'--with-system-LIB'
-
- Use an installed (system) version of the library 'LIB'; this option
-exists for most libraries, but is not allowed for a native TL build.
-Using a system version implies also using the system versions of all
-libraries that LIB depends on.
-
- For many libraries '--with-LIB-includes=DIR' and
-'--with-LIB-libdir=DIR' can specify non-standard search locations;
-others use 'pkg-config' or similar to determine the required flags.
-
- The top-level 'configure' script performs a consistency check for all
-required system libraries and bails out if tests fail.
-
-7.3.1 Configure options for 'kpathsea'
---------------------------------------
-
-'--enable-CMD-default', '--disable-CMD-default'
-Determine the compile time default for whether or not to run CMD, which
-is one of:
-'mkocp'
- (Omega compiled translation process file)
-'mkofm'
- (Omega font metrics file)
-'mktexfmt'
- (format/base dump file)
-'mktexmf'
- (Metafont source)
-'mktexpk'
- (PK bitmap font)
-'mktextex'
- (TeX source)
-'mktextfm'
- (TFM file)
-
-to generate the specified type of file dynamically. The default can be
-overridden by the user in any case (*note kpathsea library::).
-
-7.3.2 Configure options for system 'poppler'
---------------------------------------------
-
-Building XeTeX requires 'poppler', either from the TL tree or system
-headers and library. Building pdfTeX requires either 'xpdf' from the
-TeX Live tree or system 'poppler' headers and library.
-
-'--with-system-poppler'
-Use a system version (0.18 or newer) of 'poppler' for LuaTeX (or
-LuaJITTeX) and XeTeX, and use 'pkg-config' to obtain the required flags.
-
-'--with-system-xpdf'
-Use a system version (0.12 or newer) of 'poppler' (and 'pkg-config') for
-pdfTeX instead of 'xpdf' from the TL tree. *Note --disable-largefile::.
-
-7.4 Variables for configure
-===========================
-
-The values for these variables can be specified as 'configure' arguments
-of the form 'VAR=VALUE'. They can also be defined in the environment,
-but that might not work for cross compilations.
-
-'CC'
-'CXX'
-'CPPFLAGS'
- And plenty more. As usual with Autoconf, these variables specify
- the name (or full path) of compilers, preprocessor flags, and
- similar. *Note (autoconf)Preset Output Variables::.
-
-'CLISP'
- Name (or full path) of the 'clisp' executable, used to build
- 'xindy'.
-
-'FT2_CONFIG'
-'ICU_CONFIG'
-'PKG_CONFIG'
- These specify the name (or path) for the 'freetype-config',
- 'icu-config', and 'pkg-config' commands used to determine the flags
- required for system versions of 'libfreetype', the ICU libraries,
- and other libraries, respectively.
-
-'KPSEWHICH'
- Name (or path) of an installed 'kpsewhich' binary, used by 'make
- check' to determine the location of, e.g., 'cmbx10.tfm'.
-
-'MAKE'
-'SED'
- And more. Name (or path) of the 'make', 'sed', and similar
- programs; used at the top level and propagated to all
- subdirectories.
-
-'PERL'
-'LATEX'
-'PDFLATEX'
- Name (or full path) for the 'perl', 'latex', and 'pdflatex'
- commands used, e.g., to build the 'xindy' documentation.
-