From 42a7b05aa7fc09d856fb502d5ba5b6afdb718f11 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 25 Mar 2017 21:11:20 +0000 Subject: xindy build doc and test file git-svn-id: svn://tug.org/texlive/trunk@43602 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/utils/README | 44 ++++++++++--------- Build/source/utils/xindy/README-clisp | 65 ++--------------------------- Build/source/utils/xindy/tests/idxhello.idx | 2 + Build/source/utils/xindy/tests/idxhello.tex | 13 ++++++ 4 files changed, 44 insertions(+), 80 deletions(-) create mode 100644 Build/source/utils/xindy/tests/idxhello.idx create mode 100644 Build/source/utils/xindy/tests/idxhello.tex (limited to 'Build/source/utils') diff --git a/Build/source/utils/README b/Build/source/utils/README index deb6225aad1..7f11dd91150 100644 --- a/Build/source/utils/README +++ b/Build/source/utils/README @@ -65,32 +65,37 @@ mkdir $clisp_toolsdir wget=wget # or "curl -O" or whatever -libsigsegv_ver=libsigsegv-2.10 +libsigsegv_ver=libsigsegv-2.11 cd $clisp_basedir $wget http://ftp.gnu.org/gnu/libsigsegv/$libsigsegv_ver.tar.gz gzip -dc $libsigsegv_ver.tar.gz | tar xf - cd $libsigsegv_ver -./configure --prefix=$clisp_toolsdir --disable-shared --enable-static \ +./configure -C --prefix=$clisp_toolsdir --disable-shared --enable-static \ && make && make check && make install # # you may need this hack on 64-bit systems -# if clisp's configure does not find libsigsegv. Harmless anyway. +# if clisp's configure does not find libsigsegv. Harmless to do in any case. ln -s lib $clisp_toolsdir/lib64 +# +# if you can't build libsigsegv, pass --ignore-absence-of-libsigsegv +# when running configure for clisp. -libiconv_ver=libiconv-1.14 -cd $clisp_basedir -$wget http://ftp.gnu.org/gnu/libiconv/$libiconv_ver.tar.gz -gzip -dc $libiconv_ver.tar.gz | tar xf - -cd $libiconv_ver -./configure --prefix=$clisp_toolsdir --disable-shared --enable-static \ -&& make && make check && make install - -ffcall_ver=ffcall-1.10 +ffcall_ver=libffcall-1.13-20170225 cd $clisp_basedir $wget http://www.haible.de/bruno/gnu/$ffcall_ver.tar.gz gzip -dc $ffcall_ver.tar.gz | tar xf - cd $ffcall_ver -./configure --prefix=$clisp_toolsdir --disable-shared --enable-static \ +./configure -C --prefix=$clisp_toolsdir --disable-shared --enable-static \ +&& make && make check && make install + +# may be able to omit iconv if have new enough in libc or elsewhere. +libiconv_ver=libiconv-1.15 +cd $clisp_basedir +$wget http://ftp.gnu.org/gnu/libiconv/$libiconv_ver.tar.gz +gzip -dc $libiconv_ver.tar.gz | tar xf - +cd $libiconv_ver +./configure -C --prefix=$clisp_toolsdir \ + --disable-shared --enable-static --disable-nls \ && make && make check && make install # would probably be ideal to also do a local libtermcap or ncurses, @@ -101,8 +106,8 @@ cd $ffcall_ver clisp_ver=clisp-2.49 cd $clisp_basedir -$wget http://ftp.gnu.org/gnu/clisp/release/2.49/$clisp_ver.tar.gz -gzip -dc $clisp_ver.tar.gz | tar xf - +$wget https://haible.de/bruno/gnu/clisp-2.49.50.tar.bz2 +bunzip2 -dc $clisp_ver.tar.bz2 | tar xf - cd $clisp_ver # On Cygwin: @@ -111,10 +116,11 @@ cd $clisp_ver # modules/syscalls/configure.orig > modules/syscalls/configure # On FreeBSD/amd64: add --disable-mmap. # -./configure --without-readline --disable-nls \ +./configure CPPFLAGS=-DUNIX_BINARY_DISTRIB --prefix=$clisp_toolsdir \ + --without-readline --without-dynamic-modules \ + --disable-nls --enable-portability \ --with-libsigsegv-prefix=$clisp_toolsdir \ - --with-libiconv-prefix=$clisp_toolsdir \ --with-libffcall-prefix=$clisp_toolsdir \ + --with-libiconv-prefix=$clisp_toolsdir \ $clisp_builddir \ -&& cd $clisp_builddir \ -&& make +&& (cd $clisp_builddir && make) diff --git a/Build/source/utils/xindy/README-clisp b/Build/source/utils/xindy/README-clisp index 10f75b08845..5d9beb44c29 100644 --- a/Build/source/utils/xindy/README-clisp +++ b/Build/source/utils/xindy/README-clisp @@ -1,62 +1,5 @@ -Prerequisite for building xindy is the clisp package supporting -foreign function calls functionality. +(This file public domain.) -If your OS distribution already has CLISP installed, xindy will try to -use it (the configure script searches in PATH to find the `clisp' -executable, or you can pass the configure option --with-clisp=PATH -where PATH is an absolute path to the `clisp' executable). - -Otherwise, you need to build CLISP from source before building xindy. -Sources and selected binaries are available by anonymous ftp from - -and its mirrors. - -Sample steps to build clisp: - -======================================================= -# define this to any directory where clisp should be built, e.g.: -clisp_builddir=`pwd`/clisp-build-dir - -wget http://ftp.gnu.org/pub/gnu/clisp/release/2.43/clisp-2.43.tar.gz -gzip -dc clisp-2.43.tar.gz | tar xf - - -cd clisp-2.43 -./configure $clisp_builddir --ignore-absence-of-libsigsegv -cd $clisp_builddir -make -======================================================= - -NOTE: clisp package is only a build-dependency: it is not used by -xindy at runtime. So clisp could be uninstalled after xindy was built. -Therefore, running "make install" is not necessary, and you can -specify --with-clisp=$clisp_builddir/clisp when configuring xindy. - -When running `configure' for clisp, the following options should be noted: - -======================================================= - --ignore-absence-of-libsigsegv - - You may optionally install libsigsegv to improve clisp's runtime - behavior. You may get libsigsegv sources from - http://ftp.gnu.org/pub/gnu/libsigsegv/ - - If you don't have the libsigsegv library, use the above option to - let it build without libsigsegv. - - --with-libsigsegv-prefix=DIR - --with-libffcall-prefix=DIR - - In case you have installed libffcall or libsigsegv in some - non-standard locations, use the above options to specify their - prefix directories (such as /usr/local, /opt or /sw). - - --without-readline - - It was reported that CLISP fails to build on the MacOS X platform, - because of the faulty 'readline' package. Use the above option if - you'll experience problems. -======================================================= - -As noted above, running "make install" for clisp is not necessary, and -you can specify --with-clisp=$clisp_builddir/clisp when configuring -xindy. +GNU clisp (gnu.org/software/clisp) is required by xindy. +See the end of ../README (that is, Buid/source/utils/README) for +information on building it. diff --git a/Build/source/utils/xindy/tests/idxhello.idx b/Build/source/utils/xindy/tests/idxhello.idx new file mode 100644 index 00000000000..5f3b98d84d0 --- /dev/null +++ b/Build/source/utils/xindy/tests/idxhello.idx @@ -0,0 +1,2 @@ +\indexentry{there}{1} +\indexentry{hello}{1} diff --git a/Build/source/utils/xindy/tests/idxhello.tex b/Build/source/utils/xindy/tests/idxhello.tex new file mode 100644 index 00000000000..6c709ae075e --- /dev/null +++ b/Build/source/utils/xindy/tests/idxhello.tex @@ -0,0 +1,13 @@ +% $Id$ +% public domain. minimal index test: +% latex idxhello && texindy idxhello.idx && cat idxhello.ind # inspect output +% (or makeindex for that matter.) +% +% xindy must be able to find its modules, which in TL means being run +% out of Master/bin/*. +% +\documentclass{article} +\begin{document} +\index{xyz}xyz +\index{abc}abc +\end{document} -- cgit v1.2.3