biber setup in build tree

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

1 files changed, 32 insertions, 0 deletions

diff --git a/Build/source/utils/biber/README b/Build/source/utils/biber/README
new file mode 100644
index 00000000000..80145b266ca
--- /dev/null
+++ b/Build/source/utils/biber/README
@@ -0,0 +1,32 @@
+  Copyright 2011 Karl Berry <tex-live@tug.org>
+
+  This file is free software; the copyright holder
+  gives unlimited permission to copy and/or distribute it,
+  with or without modifications, as long as this notice is preserved.
+
+The biber executables we include in TeX Live are created by the biber
+maintainers and third-party builders.  They essentially bundle up the
+many modules which biber requires, using the Par::Packer mechanism.
+This process is described in the biber documentation.  It isn't feasible
+to incorporate it in the standard TL build.
+
+Nevertheless, we want the result of TL's "make install" to be the full
+bindir contents.  So, we commit here the pre-made binaries for the
+platforms for which they are available.  The ones made by the biber
+maintainers come through CTAN and our ctan2tl installs them; the ones
+made by other folks we manually here.  In any case, our make merely
+checks if an executable is present here in the source directory 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 config.guess output
+to TL platform name is not trivial.  Therefore, we copy the standard
+TeXLive/TLUtils.pm file here, along with a custom ./TeXLive/TLConfig.pm,
+to avoid duplicating the platform-detection logic.
+
+TLUtils.pm is kept in sync via the "srclist-update" mechanism; see
+Master/tlpkg/dev/srclist.txt.  The copy here in biber is a strictly a slave.
+
+For any real information about or discussion of biber, please see their
+web site at http://biblatex-biber.sourceforge.net.
+