diff options
Diffstat (limited to 'Build/source/doc')
-rw-r--r-- | Build/source/doc/Makefile.in | 1 | ||||
-rw-r--r-- | Build/source/doc/tlbuild.info | 191 | ||||
-rw-r--r-- | Build/source/doc/tlbuild.texi | 41 |
3 files changed, 93 insertions, 140 deletions
diff --git a/Build/source/doc/Makefile.in b/Build/source/doc/Makefile.in index 79948b3970b..bef78e8f5dd 100644 --- a/Build/source/doc/Makefile.in +++ b/Build/source/doc/Makefile.in @@ -111,7 +111,6 @@ am__aclocal_m4_deps = $(top_srcdir)/m4/kpse-cairo-flags.m4 \ $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/tardate.ac \ $(top_srcdir)/version.ac \ - $(top_srcdir)/utils/biber/ac/withenable.ac \ $(top_srcdir)/utils/m-tx/ac/withenable.ac \ $(top_srcdir)/utils/pmx/ac/withenable.ac \ $(top_srcdir)/utils/ps2eps/ac/withenable.ac \ diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info index 12c5277a9ba..a8d772a6c70 100644 --- a/Build/source/doc/tlbuild.info +++ b/Build/source/doc/tlbuild.info @@ -145,8 +145,8 @@ Automake/Autoconf output in general) should work with any reasonable However, a few programs in the tree have additional requirements: -'biber' - requires 'perl' for autodetection of the TL platform name. +'web2c' + requires 'perl' for some tests run by 'make check'. 'xdvik' 'xpdfopen' @@ -161,7 +161,7 @@ Automake/Autoconf output in general) should work with any reasonable 'latex', and 'pdflatex' to build the rules and/or documentation. Lacking the required tools, building these programs must avoided, e.g., -'configure --disable-biber --without-x --disable-xetex --disable-xindy' +'configure --without-x --disable-xetex --disable-xindy' Modifying source files induces more requirements, as one might expect: @@ -1542,6 +1542,10 @@ Hardwire the location of Ghostscript ('gs'). 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). + File: tlbuild.info, Node: Configure options for 'utils/xindy', Prev: Configure options for 'texk/xdvik', Up: Program-specific configure options @@ -1688,27 +1692,6 @@ but that might not work for cross compilations. Name (or full path) for the 'perl', 'latex', and 'pdflatex' commands used, e.g., to build the 'xindy' documentation. -'TL_PLATFORM' - The utility program 'biber' consists of many Perl modules bundled - into an executable by the 'Par::Packer' mechanism. Therefore it is - not feasible to build 'biber' as part of TL. - - However, in order for 'make install' to create all executables in - 'bindir', the 'biber' module in TL contains pre-made binaries (by - 'biber' contributors, released on the original 'biber' site) for - the platforms for which they are available. TL merely checks if an - executable is present for the current platform, and if so, installs - it. - - The complication is hidden in the phrase "current platform". TL - has its own ideas about platform names, and the mapping from the - canonical system name determined by 'config.guess' or 'config.sub' - to the TL platform name is not trivial. So, a value given for - 'TL_PLATFORM' is used as the TL platform name. Otherwise, the - build uses copies of the Perl modules 'TeXLive/TLUtils.pm' and - 'TeXLive/TLConfig.pm', to avoid duplicating the platform-detection - logic. - File: tlbuild.info, Node: Cross compilation, Next: Coding conventions, Prev: Configure options, Up: Top @@ -2021,6 +2004,8 @@ Index (line 64) * --enable-texlive-build: '--disable-native-texlive-build'. (line 16) +* --enable-xi2-scrolling: Configure options for 'texk/xdvik'. + (line 13) * --enable-xindy-docs: Configure options for 'utils/xindy'. (line 10) * --enable-xindy-rules: Configure options for 'utils/xindy'. @@ -2087,8 +2072,6 @@ Index * autoconf macros: Autoconf macros. (line 6) * Automake: Overview of build system. (line 6) -* biber: Variables for configure. - (line 46) * bibtex-x: Configure options for 'texk/bibtex-x'. (line 6) * bibtex8: Configure options for 'texk/bibtex-x'. @@ -2131,8 +2114,6 @@ Index * compilers, C and C++: Prerequisites. (line 6) * config.guess, config.sub: Top-level directories. (line 30) -* config.guess, config.sub <1>: Variables for configure. - (line 57) * 'configure' options: Configure options. (line 6) * 'configure' options, for 'bibtex-x': Configure options for 'texk/bibtex-x'. (line 6) @@ -2368,8 +2349,6 @@ Index (line 37) * otangle: Cross problems. (line 31) * overall build process: Building. (line 6) -* Par::Packer: Variables for configure. - (line 46) * parallel build: Build in parallel. (line 6) * paths, for installation: Installation directories. (line 6) @@ -2379,12 +2358,10 @@ Index (line 41) * PERL: Variables for configure. (line 39) -* 'perl', required by 'biber', etc.: Prerequisites. (line 19) +* 'perl', required by 'web2c', etc.: Prerequisites. (line 19) * PKG_CONFIG: Variables for configure. (line 23) * plain.tex, not in source tree: Installing. (line 8) -* platform, current: Variables for configure. - (line 57) * png library: 'png' library. (line 6) * poppler: Configure options for system 'poppler'. (line 6) @@ -2406,6 +2383,8 @@ Index * requirements for building: Prerequisites. (line 6) * runscript.exe: Macros for Windows. (line 25) * scripts, linked and not maintained: Linked scripts. (line 6) +* scrolling: Configure options for 'texk/xdvik'. + (line 13) * SED: Variables for configure. (line 34) * setup macros, general: General setup macros. (line 6) @@ -2440,12 +2419,6 @@ Index * texlive.tlpdb, TeX Live database: Installing. (line 8) * tie: Cross problems. (line 31) * timestamps, in repository: Build system tools. (line 34) -* TLConfig.pm: Variables for configure. - (line 57) -* TLUtils.pm: Variables for configure. - (line 57) -* TL_PLATFORM: Variables for configure. - (line 45) * tools, for building: Build system tools. (line 6) * top-level directories: Top-level directories. (line 6) @@ -2485,6 +2458,8 @@ Index * xindy <1>: Configure options for 'utils/xindy'. (line 6) * 'xindy' cross compiling impossible: Cross problems. (line 38) +* XInput: Configure options for 'texk/xdvik'. + (line 13) * Xlib: Configure options for 'texk/web2c'. (line 22) * xpdf as library: Configure options for system 'poppler'. @@ -2498,74 +2473,74 @@ Node: Top993 Node: Introduction1786 Node: Overview of build system2965 Node: Prerequisites5029 -Node: Building7131 -Node: Build iteration8350 -Node: Build problems9422 -Node: Build in parallel9815 -Node: Build distribution10407 -Node: Build one package10978 -Node: Installing13751 -Node: Installation directories14779 -Node: Linked scripts16599 -Node: Distro builds17747 -Node: Layout and infrastructure20127 -Node: Build system tools20916 -Node: Top-level directories22928 -Node: Autoconf macros24995 -Node: General setup macros25696 -Node: Macros for programs26563 -Node: Macros for compilers27375 -Node: Macros for libraries28809 -Node: Macros for library and header flags29235 -Node: Macros for Windows31104 -Node: Library modules32681 -Node: 'png' library33178 -Node: 'zlib' library35471 -Node: 'freetype' library35992 -Node: 'kpathsea' library36526 -Node: Program modules37950 -Node: 't1utils' package38386 -Node: 'xindy' package38953 -Node: 'xdvik' package40132 -Node: 'asymptote'41211 -Node: Extending TeX Live41666 -Node: Adding a new program module42034 -Node: Adding a new generic library module43553 -Node: Adding a new TeX-specific library module45766 -Node: Configure options46453 -Node: Global configure options47844 -Node: '--disable-native-texlive-build'48412 -Node: '--prefix' '--bindir' ...49408 -Node: '--disable-largefile'49956 -Node: '--disable-missing'50723 -Node: '--enable-compiler-warnings='LEVEL51130 -Node: '--enable-cxx-runtime-hack'51875 -Node: '--enable-maintainer-mode'52308 -Node: '--enable-multiplatform'52843 -Node: '--enable-shared'53404 -Node: '--enable-silent-rules'53781 -Node: '--without-ln-s'54243 -Node: '--without-x'54600 -Node: Program-specific configure options54792 -Node: '--enable-PROG' '--disable-PROG'55455 -Node: '--disable-all-pkgs'55738 -Node: Configure options for 'texk/web2c'56732 -Node: Configure options for 'texk/bibtex-x'59399 -Node: Configure options for 'texk/dvipdfm-x'59975 -Node: Configure options for 'texk/dvisvgm'60814 -Node: Configure options for 'texk/texlive'61704 -Node: Configure options for 'texk/xdvik'62131 -Node: Configure options for 'utils/xindy'62620 -Node: Library-specific configure options63682 -Node: Configure options for 'kpathsea'64696 -Node: Configure options for system 'poppler'65409 -Node: Variables for configure66176 -Node: Cross compilation68682 -Node: Cross configuring69947 -Node: Cross problems71620 -Node: Coding conventions73481 -Node: Declarations and definitions74145 -Node: Const76328 -Node: Index78191 +Node: Building7108 +Node: Build iteration8327 +Node: Build problems9399 +Node: Build in parallel9792 +Node: Build distribution10384 +Node: Build one package10955 +Node: Installing13728 +Node: Installation directories14756 +Node: Linked scripts16576 +Node: Distro builds17724 +Node: Layout and infrastructure20104 +Node: Build system tools20893 +Node: Top-level directories22905 +Node: Autoconf macros24972 +Node: General setup macros25673 +Node: Macros for programs26540 +Node: Macros for compilers27352 +Node: Macros for libraries28786 +Node: Macros for library and header flags29212 +Node: Macros for Windows31081 +Node: Library modules32658 +Node: 'png' library33155 +Node: 'zlib' library35448 +Node: 'freetype' library35969 +Node: 'kpathsea' library36503 +Node: Program modules37927 +Node: 't1utils' package38363 +Node: 'xindy' package38930 +Node: 'xdvik' package40109 +Node: 'asymptote'41188 +Node: Extending TeX Live41643 +Node: Adding a new program module42011 +Node: Adding a new generic library module43530 +Node: Adding a new TeX-specific library module45743 +Node: Configure options46430 +Node: Global configure options47821 +Node: '--disable-native-texlive-build'48389 +Node: '--prefix' '--bindir' ...49385 +Node: '--disable-largefile'49933 +Node: '--disable-missing'50700 +Node: '--enable-compiler-warnings='LEVEL51107 +Node: '--enable-cxx-runtime-hack'51852 +Node: '--enable-maintainer-mode'52285 +Node: '--enable-multiplatform'52820 +Node: '--enable-shared'53381 +Node: '--enable-silent-rules'53758 +Node: '--without-ln-s'54220 +Node: '--without-x'54577 +Node: Program-specific configure options54769 +Node: '--enable-PROG' '--disable-PROG'55432 +Node: '--disable-all-pkgs'55715 +Node: Configure options for 'texk/web2c'56709 +Node: Configure options for 'texk/bibtex-x'59376 +Node: Configure options for 'texk/dvipdfm-x'59952 +Node: Configure options for 'texk/dvisvgm'60791 +Node: Configure options for 'texk/texlive'61681 +Node: Configure options for 'texk/xdvik'62108 +Node: Configure options for 'utils/xindy'62718 +Node: Library-specific configure options63780 +Node: Configure options for 'kpathsea'64794 +Node: Configure options for system 'poppler'65507 +Node: Variables for configure66274 +Node: Cross compilation67702 +Node: Cross configuring68967 +Node: Cross problems70640 +Node: Coding conventions72501 +Node: Declarations and definitions73165 +Node: Const75348 +Node: Index77211 End Tag Table diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi index 9fd0f5d915a..5fd16c30784 100644 --- a/Build/source/doc/tlbuild.texi +++ b/Build/source/doc/tlbuild.texi @@ -217,9 +217,9 @@ any reasonable @code{make}. However, a few programs in the tree have additional requirements: @table @file -@item biber -@cindex @code{perl}, required by @code{biber}, etc. -requires @code{perl} for autodetection of the TL platform name. +@item web2c +@cindex @code{perl}, required by @code{web2c}, etc. +requires @code{perl} for some tests run by @code{make check}. @item xdvik @itemx xpdfopen @@ -243,7 +243,7 @@ and/or documentation. @noindent Lacking the required tools, building these programs must avoided, e.g.,@* -@code{configure --disable-biber --without-x --disable-xetex --disable-xindy} +@code{configure --without-x --disable-xetex --disable-xindy} Modifying source files induces more requirements, as one might expect: @@ -1899,6 +1899,12 @@ to run @code{texlinks}. @code{@var{kit}} for @file{xdvik}, one of: @code{motif xaw xaw3d neXtaw}. The default is @code{motif} if available, else @code{xaw}. +@vindex --enable-xi2-scrolling +@pindex XInput +@pindex scrolling +@noindent @code{--enable-xi2-scrolling}@*Use XInput 2.1 ``smooth scrolling'' +if available. (default: yes, except for a native TL build). + @node Configure options for @file{utils/xindy} @subsection Configure options for @file{utils/xindy} @@ -2069,33 +2075,6 @@ programs; used at the top level and propagated to all subdirectories. Name (or full path) for the @file{perl}, @file{latex}, and @file{pdflatex} commands used, e.g., to build the @code{xindy} documentation. -@item TL_PLATFORM -@pindex biber -@pindex Par::Packer -The utility program @code{biber} consists of many Perl modules bundled -into an executable by the @code{Par::Packer} mechanism. Therefore -it is not feasible to build @code{biber} as part of TL. - -However, in order for @code{make install} to create all executables in -@file{bindir}, the @code{biber} module in TL contains pre-made -binaries (by @code{biber} contributors, released on the original -@code{biber} site) for the platforms for which they are available. TL -merely checks if an executable is present for the current platform, -and if so, installs it. - -@cindex platform, current -@pindex config.guess@r{,} config.sub -@pindex TLUtils.pm -@pindex TLConfig.pm -The complication is hidden in the phrase ``current platform''. TL has -its own ideas about platform names, and the mapping from the canonical -system name determined by @file{config.guess} or @file{config.sub} to -the TL platform name is not trivial. So, a value given for -@code{TL_PLATFORM} is used as the TL platform name. Otherwise, the -build uses copies of the Perl modules @code{TeXLive/TLUtils.pm} and -@code{TeXLive/TLConfig.pm}, to avoid duplicating the -platform-detection logic. - @end vtable |