restore Build,TODO from r57911

git-svn-id: svn://tug.org/texlive/trunk@57915 c570f23f-e606-0410-a88d-b1316a301751

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).