From 6bb749147f71bd462194a3979f3f33dd3056d0cf Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 22 Mar 2017 22:18:48 +0000 Subject: doc tweaks (and timestamp tests) git-svn-id: svn://tug.org/texlive/trunk@43576 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/doc/ChangeLog | 4 ++++ Build/source/doc/tlbuild.texi | 40 ++++++++++++++++--------------------- Build/source/texk/README | 2 +- Build/source/texk/dvipsk/dvips.texi | 4 ++-- 4 files changed, 24 insertions(+), 26 deletions(-) (limited to 'Build/source') diff --git a/Build/source/doc/ChangeLog b/Build/source/doc/ChangeLog index d8c314e491b..a7f9c30d901 100644 --- a/Build/source/doc/ChangeLog +++ b/Build/source/doc/ChangeLog @@ -1,3 +1,7 @@ +2017-03-22 Karl Berry + + * tlbuild.texi: we now default to gcc for ICU too. + 2017-03-19 Karl Berry * tlbuild.texi: TLPATCHES -> TLpatches. diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi index 77864610046..bb4a9fc6bda 100644 --- a/Build/source/doc/tlbuild.texi +++ b/Build/source/doc/tlbuild.texi @@ -486,38 +486,32 @@ things are working. There are many @code{configure} options you can tweak as desired; check the output from @code{configure --help}. @cindex size of source tree -Finally, the above retrieves the entire TL source tree (some 300mb). -It is natural to ask if this is really necessary. Strictly speaking, -the answer is no, but it is vastly more convenient to do so. If you -cut down the source tree, you must also give additional -@code{configure} flags to individually disable using system versions -of libraries, or the intricacies of the dependencies (such as +Finally, the above retrieves the entire TL source tree (several +hundred megabytes). It is natural to ask if this is really necessary. +Strictly speaking, the answer is no, but it is vastly more convenient +to do so. If you cut down the source tree, you must also give +additional @code{configure} flags to individually disable using system +versions of libraries, or the intricacies of the dependencies (such as @code{teckit} requiring @code{zlib}) will have undesired side effects. For an example, see the @code{build-pdftex.sh} script in the -@code{pdftex} development sources (@url{http://pdftex.org}), which are +@code{pdftex} development source (@url{http://pdftex.org}), which is indeed a cut-down TL source tree. @vindex --enable-missing @r{to ignore dependencies} -Caveat 1: even with @code{--disable-all-pkgs}, dependencies will be -checked. For instance, if a non-MacOSX system does not have -@code{fontconfig}, Xe@TeX{} cannot be built (@pxref{Prerequisites}) -and @code{configure} will terminate. To proceed without such -dependencies, specify @code{--enable-missing} also. (Arguably this -should happen automatically.) +Even with @code{--disable-all-pkgs}, dependencies will be checked. +For instance, if a non-MacOSX system does not have @code{fontconfig}, +Xe@TeX{} cannot be built (@pxref{Prerequisites}) and @code{configure} +will terminate. To proceed without such dependencies, specify +@code{--enable-missing} also. (Arguably this should happen +automatically.) @vindex CC=@var{c-compiler} @vindex CXX=@var{c++-compiler} @vindex OBJCXX=@var{objc-compiler} -@cindex ICU, prefers @code{clang} compilers -@cindex @code{clang} compilers, preferred by ICU -Caveat 2: unless @code{CC} and @code{CXX} and @code{OBJCXX} are -explicitly specified, each package will configure its own compiler(s). -In practice, this results in a conflict in only one instance: the ICU -(@file{libs/icu}) library will prefer @code{clang} and @code{clang++} -over all others if they are installed, whereas everything else prefers -@code{gcc} and @code{g++}. Usually the results will be interoperable, -but it can cause extra confusion and problems when debugging a program -that uses ICU. +By default, the @code{gcc} compilers will be used if present; +otherwise, individual packages may use something different. You can +explicitly specify the compilers to be used with the environment +variables @code{CC}, @code{CXX}, and @code{OBJCXX}. @node Installing diff --git a/Build/source/texk/README b/Build/source/texk/README index 26f8ce6161a..f0d96e4a57f 100644 --- a/Build/source/texk/README +++ b/Build/source/texk/README @@ -117,7 +117,7 @@ web2c - maintained here, by us - core web2c, plain tex, etc. pdftex - http://pdftex.org pmpost - none ptex - nothing current, old info: http://ascii.asciimw.jp/pb/ptex/ - synctex - maintained here + synctex - maintained here, but also https://github.com/jlaurens/synctex upmpost - ? (Kitagawa-san) uptex - https://texwiki.texjp.org/?upTeX%2CupLaTeX xetex - http://tug.org/xetex/ diff --git a/Build/source/texk/dvipsk/dvips.texi b/Build/source/texk/dvipsk/dvips.texi index e5c46d3bb24..d5ca01c0ddb 100644 --- a/Build/source/texk/dvipsk/dvips.texi +++ b/Build/source/texk/dvipsk/dvips.texi @@ -965,8 +965,8 @@ exists, it is read. @cindex quiet operation @cindex silent operation @cindex warnings, suppressing -Run quietly. Don't chatter about pages converted, etc.@: to standard -output; report no warnings (only errors) to standard error. +Run quietly. Don't chatter about pages converted, etc.@:, +and report no warnings (only errors) to standard error. @item -r* @opindex -r -- cgit v1.2.3