summaryrefslogtreecommitdiff
path: root/Build
diff options
context:
space:
mode:
authorHironobu Yamashita <h.y.acetaminophen@gmail.com>2023-02-25 00:44:29 +0000
committerHironobu Yamashita <h.y.acetaminophen@gmail.com>2023-02-25 00:44:29 +0000
commit5905c00d3fa53c7f5f9fa554bdf284736da69587 (patch)
tree76a69b5b6899abdf19df9cec2e91784f7bb3e690 /Build
parentc9f423919a496809e76c20054dc40a1c1c9229a8 (diff)
Build/source/README: restore
git-svn-id: svn://tug.org/texlive/trunk@66139 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build')
-rw-r--r--Build/source/README245
1 files changed, 92 insertions, 153 deletions
diff --git a/Build/source/README b/Build/source/README
index dc01bd69314..d2bfa2a74bb 100644
--- a/Build/source/README
+++ b/Build/source/README
@@ -1,153 +1,92 @@
-$Id$
-Copyright 2006-2023 TeX Users Group.
-You may freely use, modify and/or distribute this file.
-
-This TeX Live directory contains the programs that use the kpathsea
-library for configuration and path searching, and the library itself.
-
-Some programs can be built on their own, but others, including kpathsea
-itself, cannot. Instead, try using the script ../../Build or the
-equivalent configure && make. In general, for TeX Live we only test
-configuring the whole tree.
-
-Upstream sources and last-checked versions follow. If a url is given,
-that is the upstream, although this does not mean the program is
-actively maintained. Programs marked with a "?" are not (knowingly)
-maintained here, but the upstream is unknown. If a program is knowingly
-maintained here in the TL repo, that is explicitly stated.
-
-Anyone -- please research and update any of this information.
-
-
-afm2pl - maintained here
- old info: http://tex.aanhet.net/afm2pl/
-
-bibtex-x - maintained here, contains
- bibtex8, bibtexu
-
-chktex 1.7.8 - checked 15dec22
- http://mirror.ctan.org/support/chktex/
- http://download.savannah.gnu.org/releases/chktex/
-
-cjkutils 4.8.5 - checked 22jan22
- http://git.savannah.gnu.org/gitweb/?p=cjk.git;a=summary
- http://www.nongnu.org/cjk/
-
-detex 2.8.9 - maintained here
- maintained for a time (untouched since 2020, checked 14sep22):
- https://github.com/pkubowicz/opendetex/releases
- (would be useful to look at open issues there for bugs)
- original author: http://www.cs.purdue.edu/homes/trinkle/detex/
-
-dtl - maintained here, by Takuji
-
-dvi2tty 6.0.2 - checked 1may22
- https://github.com/t-tk/dvi2tty/releases
-
-dvidvi - maintained here
-
-dviljk - maintained here, by Joachim Schrod
-
-dviout-util - by Japanese TeX Development Community (Hironobu, Takuji et al.)
- https://github.com/texjporg/tex-jp-build
- but also: https://github.com/aminophen/dviout-util
-
-dvipdfm-x - maintained here, by us, contains
- dvipdfmx and xdvipdfmx.
- old info: http://project.ktug.org/dvipdfmx/
-
-dvipng 1.17 - checked 31may22
- https://mirror.ctan.org/dviware/dvipng/
-
-dvipos - maintained here, by us
-
-dvipsk - maintained here, by us
-
-dvisvgm 3.0.3 - checked 21feb23
- https://dvisvgm.de/Downloads/
- https://github.com/mgieseki/dvisvgm
- https://ctan.org/pkg/dvisvgm
-
-gregorio 6.0.0 - checked 14mar21
- https://mirror.ctan.org/support/gregoriotex/gregorio-6.0.0.zip
-
-gsftopk - from Paul Vojta's xdvi.
-
-kpathsea - maintained here, by us
-
-lcdf-typetools 2.108 - checked 31may22
- https://www.lcdf.org/type/
-
-makeindexk - maintained here, by us
-
-makejvf - by Japanese TeX Development Community (Takuji, Hironobu et al.)
- https://github.com/texjporg/tex-jp-build
-
-mendexk - by Japanese TeX Development Community (Takuji, Hironobu et al.)
- https://github.com/texjporg/tex-jp-build
-
-musixtnt 2016-01-30 - checked 15mar20
- http://mirror.ctan.org/macros/musixtnt/
-
-ps2pk - maintained here, by us
-
-psutils 1.23 - checked 16jan14
- https://github.com/rrthomas/psutils/releases/
-
-ptexenc - maintained here, by us (Akira et al.)
- but also: https://github.com/texjporg/tex-jp-build
-
-seetexk - maintained here, by us (Takuji, Hironobu et al.)
-
-tex4htk - part of tex4ht, needs full release
- https://tug.org/tex4ht/
-
-texlive - scripts and files maintained here, by us
-
-ttf2pk2 - maintained here, by us
-
-ttfdump - maintained here, by us, since Taiwan upstream apparently gone.
-
-upmendex 1.07 - by Takuji Tanaka
- https://ctan.org/pkg/upmendex
- https://github.com/t-tk/upmendex-package
-
-web2c - maintained here, by us - core web2c, plain tex, etc.
- The TeX variant dirs (pdftexdir, xetexdir, etc.)
- updated here by their respective maintainers. More info:
- aleph - maintained here
- ctie - CTAN
- cweb - https://github.com/ascherer/cwebbin
- (original Knuth, ftp://ftp.cs.stanford.edu/pub/cweb/
- and ftp://ftp.cs.stanford.edu/pub/ctwill/)
- eptex - https://github.com/texjporg/tex-jp-build
- also: https://osdn.jp/projects/eptex
- etex - maintained here
- euptex - http://www.t-lab.opal.ne.jp/tex/uptex_en.html
- hitex - https://hint.userweb.mwn.de/hint/hitex.html
- mflua[jit] - https://serveur-svn.lri.fr/svn/modhel/mflua
- also: http://www.luatex.org/download.html
- mplibdir - https://tug.org/metapost/
- luatex - http://luatex.org/
- pdftex - http://pdftex.org/
- [u]pmpost - nothing current, see README for old info
- ptex - https://github.com/texjporg/tex-jp-build
- old info: https://asciidwango.github.io/ptex/
- synctex - maintained here, but also https://github.com/jlaurens/synctex
- uptex - http://www.t-lab.opal.ne.jp/tex/uptex_en.html
- xetex - http://tug.org/xetex/
-
-xdvik 22.87.06 - checked 31may22
- https://sourceforge.net/projects/xdvi/files/xdvik/
- Procedure for updating xdvik from sourceforge release:
-tar xf ...
-diff -crN2 \
- -x .cvsignore -x configure -x autom4te.cache -x Makefile.in -x ChangeLog \
- xdvik xdvik-22.87.03/texk/xdvik >/tmp/c
-cd xdvik
-patch -p1 </tmp/c
-reautoconf
-add import entry to ChangeLog, update texk/README
-remove unpacked ../xdvik-*
-make sure it builds.
-commit.
+Id: README 62297 2022-02-28 22:13:17Z karl $
+Public domain. Originally written 2005 by Karl Berry.
+
+For a high-level overview of building TeX Live, see
+http://tug.org/texlive/build.html. In brief:
+
+- To configure and make the source tree, run ./Build.
+ This builds in subdirectory Work/, and installs into subdirectory inst/.
+
+- To build (mostly) without optimization, run ./Build --debug.
+
+- If the make fails and you want to rebuild without starting from scratch:
+ cd Work/whatever/subdir && make
+
+Email tlbuild@tug.org if problems.
+
+(Nearly everything the Build script does can be overridden via
+environment variables; just take a look to see the names.)
+
+Many more details about the TL build system, such as configuring to work
+on a single program, adding new programs or libraries, documentation
+about the many pieces of the system, etc., are in the doc/tlbuild*
+document and the sibling README* files here (which are generated from
+that document).
+
+
+Build information for some of the platforms.
+See also Master/tlpkg/bin/tl-update-bindir.
+
+aarch64-linux:
+ Built on contextgarden, see below, except for asy:
+ aarch64 Debian GNU/Linux 10 (buster)
+ gcc (Debian 8.3.0-6) 8.3.0
+ ./Build --enable-arm-neon=on
+
+armhf-linux:
+ Built on contextgarden, see below.
+ Raspbian/Raspberry Pi OS (Debian Buster)
+ Previously, built by Simon Dales:
+ gcc version 10.2.1 20210110 (Raspbian 10.2.1-6+rpi1)
+ ./Build --enable-xindy CLISP=${BUILD_ROOT_DIR}/clisp/clisp-build/clisp}
+ armhf-linux binaries are created and tested on RPi;
+ they run on RPi, as well as ARMv7 CPUs, but are untested on non-RPi
+ ARMv6 machines.
+
+x86_64-cygwin: gcc-10.2.0, cygwin-3.1.7
+ TL_CONFIGURE_ARGS="--enable-xindy --enable-shared CLISP=/path/to/clisp.exe
+ LDFLAGS='-Wl,--no-insert-timestamp -Wl,--stack,0x800000'" \
+ ./Build
+
+i386-freebsd, amd64-freebsd:
+ Built on contextgarden, see below.
+ FreeBSD 11.4
+
+i386-linux: see travis below.
+
+i386-netbsd, amd64-netbsd:
+ NetBSD/amd64 9.2
+ gcc version 7.5.0 (nb4 20200810)
+ TL_MAKE=gmake CC=gcc CXX=g++ \
+ CFLAGS=-D_NETBSD_SOURCE \
+ CXXFLAGS='-D_NETBSD_SOURCE -std=c++11' \
+ LDFLAGS='-L/usr/X11R7/lib -Wl,-rpath,/usr/X11R7/lib' \
+ ./Build --enable-xindy CLISP=/usr/local/bin/clisp
+
+i386-solaris, x86_64-solaris:
+ Built on contextgarden, see below.
+ Solaris 10, gcc 5.5. See doc/README.solaris.
+
+universal-darwin: See Master/source/mactexdoc.tar.xz.
+
+windows:
+ Makefiles written by hand, see Master/source/windows-src.tar.xz.
+ Visual Studio 2010 and Visual Studio 2015.
+
+x86_64-darwinlegacy:
+ Mac OS X 10.6, clang 5.0, libc++ required
+ auxiliary installer binaries: Mac OS X 10.6, gcc -std=c99.
+ https://github.com/TeXLive-M/texlive-buildbot
+ http://build.contextgarden.net/waterfall?tag=c/texlive
+ (These links have info on all platforms built by Mojca.)
+
+i386-linux,
+x86_64-linux,
+x86_64-linuxmusl:
+ CentOS 7 Docker image with musl libc 1.1.5, plus gcc10:
+ yum -y install centos-release-scl-rh
+ yum -y install devtoolset-9-gcc-c++
+ yum install -y fontconfig-devel libX11-devel libXmu-devel libXaw-devel
+ Binaries are taken from the CI testing via github;
+ see the source/.github/* files for details on how to build,
+ and tlpkg/bin/tl-update-bindir for updating binaries (in general).