From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- biblio/tib/INSTALL | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 biblio/tib/INSTALL (limited to 'biblio/tib/INSTALL') diff --git a/biblio/tib/INSTALL b/biblio/tib/INSTALL new file mode 100644 index 0000000000..f5b5625d5d --- /dev/null +++ b/biblio/tib/INSTALL @@ -0,0 +1,71 @@ +Tib installation +================ + +Source language: C + +For a list of files see MANIFEST. + +1. Unpack the tar file. This will create the directories tib, + tib/src, tib/index, tib/inputs, tib/doc, tib/elisp, tib/sk, + and tib/test. + +2. Review the Makefile. With a text editor, change the variables + TIBDIR (where the tib file-hierarchy will reside after installation), + DESTDIR (where the executables go), MANDIR (where the manpages go + (only prefix)), and TEXBIN (the absolute pathname of your TeX-binary). + +3. Make certain paths to temporary files in #define statements + are correct in tib.h (they are set to /tmp/) (there are + three of them). + +4. Make certain paths to system descriptions in #include statements + are correct in tibargs.c (#include , #include ). + +5. If you like, create tib.cat (`make manual') and/or tibdoc.dvi ('make dvi'). + If desired, copy tib.man and/or tib.cat to the doc directory. + +6. Compile and link the programs. + 'make ja' will produce James Alexander's original tib, + 'make sk' will produce Sebastian Kremer's (upward compatible) + extended tib. (cf. sk/README for information) + +7. 'make test' will run a check on the vital components of the system. + +8. Install the system. + 'make install' only installs the binaries, which is of not much + use the first time round. + 'make install.all' installs the full system, and + 'make install.man' installs the man pages. + +12. Change directory to the $TIBDIR/index directory. Install system + reference file. Apply tibdex to this reference file. + If no system reference file is to be used, create dummy + index by applying tibdex to empty file. + +13. Clean up as desired (delete object files: 'make clean', + remove executables and documentation, too, and reverse + changes introduced by SK's extensions: 'make veryclean'). + +14. Advertise /intro.tib to TeX users. + +15. Comments: + a. The siam format styles (siamd.tib, siamn.tib, siamdl.tib, + siamnl.tib) contain options on fonts (SIAM specifies smaller + type for bibliographies). Check if you want to modify. + b. On some machines, the stack can overflow in locate.c from `refs'. + I believe making `refs' a global variable should not cause problems. + Put the line `struct reftype refs[MAXREFS]...' after the + `static struct reftype' declaration. + c. In numo.tib and numos.tib, the font ammi10 is used. For some + sites, this should be cmmi10. + d. Files ieeabb.ttz and ieefll.ttz are included, but not documented. + They consist of journal names and abbreviations for ieee journals. + They can be installed in the macro subdirectory and made available + with either the -i flag on the call to tib or by modifying .tib + files. + e. A small unix utility named tibabb is included, but not documented. + It is called as `tibabb '. + It will exhibit all entries in the journal file(s) containing + that word, so that the appropriate definition code can be used. + It should be modified to local use. + f. For Sebastian Kremer's extensions see the file sk/README -- cgit v1.2.3