summaryrefslogtreecommitdiff
path: root/Build/source/README
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-02-25 19:22:25 +0000
committerKarl Berry <karl@freefriends.org>2021-02-25 19:22:25 +0000
commitad547a6b5986815fda458221149728d9d9ab1d87 (patch)
tree16296910eb3eca724371474ea9aea3994dc69614 /Build/source/README
parent947b43de3dd21d58ccc2ffadefc4441ea1c2a813 (diff)
restore Build,TODO from r57911
git-svn-id: svn://tug.org/texlive/trunk@57915 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README')
-rw-r--r--Build/source/README77
1 files changed, 77 insertions, 0 deletions
diff --git a/Build/source/README b/Build/source/README
new file mode 100644
index 00000000000..bf40d8d1541
--- /dev/null
+++ b/Build/source/README
@@ -0,0 +1,77 @@
+$Id$
+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:
+ aarch64 Debian GNU/Linux 10 (buster)
+ gcc (Debian 8.3.0-6) 8.3.0
+ ./Build --enable-arm-neon=check
+
+i386-netbsd, amd64-netbsd:
+ NetBSD/amd64 9.0
+ gcc version 7.4.0 (nb3 20190319)
+ 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
+ Except that we take Nelson's asy build.
+
+i386-freebsd, amd64-freebsd:
+ Built on contextgarden, see below.
+ FreeBSD 11.4
+ Except that we take Nelson's asy build.
+
+i386-linux: see travis below.
+
+i386-openbsd, amd64-openbsd:
+ e.g., see CONFIGURE_ARGS in the Makefile in
+ http://cvsweb.openbsd.org/cgi-bin/cvsweb/ports/print/texlive/base/
+
+i386-solaris, x86_64-solaris:
+ Built on contextgarden, see below.
+ Solaris 10, gcc 5.5. See doc/README.solaris.
+
+i386-cygwin, x86_64-cygwin: gcc-4.8.2, cygwin-1.7.29.
+ ./Build (with --enable-xindy for i386).
+
+universal-darwin: See Master/source/mactexdoc.tar.xz.
+
+x86_64-darwinlegacy:
+ Mac OS X 10.6, clang 5.0, libc++ required
+ 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:
+ Alpine 3.1 Docker image with musl libc 1.1.5
+ Binaries are taken from the CI testing on travis-ci
+ see the source/.travis.yaml file for details on how to build,
+ and tlpkg/bin/tl-update-bindir for updating binaries (in general).