summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex8
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-04-07 18:26:53 +0000
committerKarl Berry <karl@freefriends.org>2013-04-07 18:26:53 +0000
commitb04c2e1a42573e9735547702356c7b9a769a6855 (patch)
treec0753443f39500a062d7698fe6b94359c813f871 /Master/texmf-dist/doc/bibtex8
parentfb0bf13304a356f197bfc1add17f98c07e96f17b (diff)
texmf -> texmf-dist: doc
git-svn-id: svn://tug.org/texlive/trunk@29714 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/bibtex8')
-rw-r--r--Master/texmf-dist/doc/bibtex8/00readme.txt903
-rw-r--r--Master/texmf-dist/doc/bibtex8/HISTORY65
-rw-r--r--Master/texmf-dist/doc/bibtex8/csfile.txt318
-rw-r--r--Master/texmf-dist/doc/bibtex8/file_id.diz13
4 files changed, 1299 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/bibtex8/00readme.txt b/Master/texmf-dist/doc/bibtex8/00readme.txt
new file mode 100644
index 00000000000..6322e51fcd3
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex8/00readme.txt
@@ -0,0 +1,903 @@
+******************************************************************************
+FILE: $RCSfile: 00readme.txt,v $
+ $Revision: 3.71 $
+ $Date: 1996/08/18 20:38:55 $
+******************************************************************************
+
+
+An 8-bit Implementation of BibTeX 0.99 with a Very Large Capacity
+=================================================================
+
+
+Contents
+--------
+
+ 0. Abstract
+
+ 1. Introduction
+ 1.1 8-bit Character Set Support
+ 1.2 Big and Customisable Capacity
+
+ 2. Distribution Kits and Where to Find Them
+ 2.1 bt371dos.zip
+ 2.2 bt371os2.zip
+ 2.3 bt371src.zip
+ 2.4 bt371csf.zip
+
+ 3. Running 8-bit BibTeX
+ 3.1 Command line options
+ 3.2 Finding Files
+ 3.3 Environment variables
+
+ 4. The Codepage and Sort Order (CS) File
+ 4.1 CS file syntax
+ 4.2 Testing a CS file
+ 4.3 Sharing your CS file
+
+ 5. Building 8-bit BibTeX from Source Code
+ 5.1 DOS
+ 5.2 OS/2
+ 5.3 Unix
+ 5.4 VMS
+
+ 6. Reporting Bugs and Requesting Improvements
+ 6.1 Contacting the authors
+ 6.2 Further enhancements
+
+ 7. Frequently Asked Questions
+
+ 8. Acknowledgements
+
+ 9. BibTeX Use and Copying Conditions
+
+ 10. Change Log
+
+
+
+0. Abstract
+-----------
+
+This abstract is in a format suitable for inclusion in BBS description files
+(file_id.diz):
+
+ (v3.71) "big" BibTeX with full 8-bit support
+
+ An enhanced, portable C version of BibTeX.
+ Enhanced by conversion to "big" (32-bit)
+ capacity, addition of run-time selectable
+ capacity and 8-bit support extensions.
+ National character set and sorting order
+ are controlled by an external configuration
+ file. Various examples are included.
+ Freeware / GNU Public Licence.
+
+ Niel Kempson <kempson@snowyowl.co.uk>
+ Alejandro Aguilar-Sierra <asierra@servidor.unam.mx>
+
+
+
+1. Introduction
+----------------
+
+8-bit BibTeX is an enhanced, portable C version of BibTeX 0.99. It has been
+enhanced in these areas:
+
+ - conversion to "big" (32-bit) capacity
+ - capacity selectable at run time
+ - flexible support for non-English languages using 8-bit character sets
+ - well matched to LateX2e and its "inputenc" package
+
+Oren Patashnik, the creator of BibTeX, is working on a new BibTeX 1.0 that
+will be a modern implementation supporting large capacities and non-English
+languages (see TUGboat, pages 269--274, volume 15, number 3, September 1994).
+He is content for this version to be released, but hopes that people will
+eventually migrate to BibTeX 1.0 when it is released. Its release date is
+uncertain at the moment.
+
+
+ 1.1 Big and Customisable Capacity
+ ---------------------------------
+
+ The original 16-bit code has been rewritten to use 32-bit data types
+ wherever possible. The result is a very large potential capacity. To
+ increase flexibility and to avoid BibTeX allocating all available memory,
+ the capacity of some key arrays can be set on the command line.
+
+ For convenience, several standard capacities have been predefined:
+ default, big and huge. The key capacities are set as follows:
+
+ Parameter Standard --big --huge --wolfgang
+ ------------------------------------------------------------
+ Hash_Prime 4,253 8,501 16,319 30,011
+ Hash_Size 5,000 10,000 19,000 35,000
+ Max_Cites 750 2,000 5,000 7,500
+ Max_Ent_Ints 3,000 4,000 5,000 7,500
+ Max_Ent_Strs 3,000 6,000 10,000 10,000
+ Max_Fields 17,250 30,000 85,000 125,000
+ Max_Strings 4,000 10,000 19,000 30,000
+ Pool_Size 65,530 130,000 500,000 750,000
+ Wiz_Fn_Space 3,000 6,000 10,000 10,000
+
+ If these parameter names mean nothing to you, don't worry, you've
+ probably never exceeded BibTeX's capacity.
+
+
+ 1.2 8-bit Character Set Support
+ -------------------------------
+
+ BibTeX now accepts 8-bit characters in its input files and writes 8-bit
+ characters to its output files. The character set is defined by an
+ external configuration text file - the codepage and sort order ("CS")
+ file.
+
+ The sort order can be defined for the language and character set. For
+ example, in German, the control sequence \"o (o umlaut) should be sorted
+ as if it were the letter "o", but after ordinary "o", leading to this
+ order:
+
+ Trofer, Tr\"ofer, Trufer
+
+ However, in Swedish, \"o (o umlaut) is treated as the 29th letter of the
+ alphabet and these entries would be sorted as:
+
+ Trofer, Trufer, Tr\"ofer
+
+ The sorting order is defined by an external configuration text file -
+ the codepage and sort order ("CS") file.
+
+ This version of BibTeX, coupled with LaTeX2e and its "inputenc" package
+ provide a robust means of handling 8-bit character sets.
+
+
+
+2. Distribution Kits and Where to Find Them
+--------------------------------------------
+
+8-bit BibTeX is distributed as a set of ZIP files created by the freely
+available implementation of ZIP by the Info-ZIP project. The files have all
+been compressed using the new "deflation" algorithm and can only be
+compressed using the Info-ZIP implementation of UNZIP, or PKUNZIP v2.04 or
+later. Ancient versions of PKUNZIP (e.g. v1.10) will not be able to unZIP
+the files and will complain with a message like: "PKUNZIP: Warning! I don't
+know how to handle: xxxxxxxx.xxx".
+
+The "official" version of 8-bit BibTeX will be available by anonymous FTP
+from the Comprehensive TeX Archive Network (CTAN) sites:
+
+ ftp.tex.ac.uk:/tex-archive/biblio/bibtex/8-bit
+ ftp.uni-stuttgart.de:/tex-archive/biblio/bibtex/8-bit
+
+There are four main ZIP files in the complete 8-bit BibTeX distribution:
+
+ bt###dos.zip bt###os2.zip bt###src.zip bt###csf.zip
+
+where ### is the latest version, currently 371 (for v3.71). Their contents
+and purpose are summarised below.
+
+
+ 2.1 bt371dos.zip
+ ----------------
+
+ The binary + documentation kit for MS-DOS users. It contains all you
+ need to run 8-bit BibTeX under MS-DOS, but no source code. The
+ executable program uses a 32-bit virtual memory extender called EMX to
+ run in 32-bit mode. emTeX is probably the most comprehensive and capable
+ implementation of TeX for DOS & OS/2 and it too uses EMX.
+
+ The kit contains these files:
+
+ 00readme.txt this file
+ COPYING GNU copyright notice
+ HISTORY summary of changes made so far
+ csfile.txt documentation for codepage and sort order
+ ("CS") files
+ msdos/bibtex.exe the 8-bit BibTeX program
+
+ EMX uses the VCPI mechanism to run in 32-bit mode and will therefore not
+ run in a DOS session under MS Windows. It will run under native DOS and
+ in a DOS session under OS/2. The EMX extender (v0.9b) is bound into
+ bibtex.exe, but you can always obtain the latest version of EMX by
+ anaonymous FTP from:
+
+ ftp.uni-stuttgart.de:/pub/systems/os2/emx-0.9b
+ ftp.leo.org:/pub/comp/os/os2/gnu/emx+gcc
+
+ If you want to run this version of BibTeX in a DOS session under MS
+ Windows, you have two choices:
+
+ - get and install the RSX extender. RSX is a DPMI-compliant DOS
+ extender which is more or less compatible with emx. It is compatible
+ with EMX, DPMI servers and DOS sessions under MS Windows. The
+ official site for the latest version of RSX is
+
+ ftp.uni-bielefeld.de:/pub/systems/msdos/misc
+
+ but you can also get it by anonymous FTP from the same CTAN sites as
+ BibTeX:
+
+ ftp.tex.ac.uk:/tex-archive/systems/msdos/dpmigcc
+ ftp.uni-stuttgart.de:/tex-archive/systems/msdos
+
+ The files to look for are dpmigcc5.zip and rsxwin3a.zip
+
+ If you use the emTeX implementation of TeX and friends, it may be
+ more convenient to get the "emxrsx" package - it's a minimal version
+ of RSX to allow emTeX to run in DOS sessions under MS Windows. It is
+ available by anonymous FTP from CTAN sites in the emTeX directory:
+
+ ftp.tex.ac.uk:/tex-archive/systems/msdos/emtex
+ ftp.uni-stuttgart.de:/tex-archive/systems/msdos/emtex
+
+ On the other hand, if you're using emTeX under MS Windows, you've
+ probably solved the problem already :-)
+
+ - get the djgpp GNU C compiler and DOS extender package and build
+ BibTeX from the source code. The master site for djgpp is
+ ftp.delorie.com.
+
+
+ 2.2 bt371os2.zip
+ ----------------
+
+ The binary + documentation kit for OS/2 2.x and 3.x users. It contains
+ all you need to run 8-bit BibTeX under OS/2, but no source code. The
+ executable program was developed using the EMX development system and has
+ its run-time library linked in - there is no need to install EMX just to
+ run BibTeX. If you already have EMX installed want a smaller executable,
+ you'll need to rebuild from sources.
+
+ The kit contains these files:
+
+ 00readme.txt this file
+ COPYING GNU copyright notice
+ HISTORY summary of changes made so far
+ csfile.txt documentation for codepage and sort order
+ ("CS") files
+ os2/bibtex.exe the 8-bit BibTeX program
+
+
+ 2.3 bt371src.zip
+ ----------------
+
+ The complete source code kit to build 8-bit BibTeX on all supported
+ systems. The source code is known to build easily under MS-DOS and OS/2
+ if you have the GNU C Compiler installed. The source code is quite
+ portable and contains almost no system-specific items - it should very
+ easily port to Unix or VMS. If you decide to port 8-bit BibTeX to
+ another platform, please let me know so that I can include your efforts
+ in the master distribution.
+
+ The source kit contains these files:
+
+ 00readme.txt this file
+ COPYING GNU copyright notice
+ HISTORY summary of changes made so far
+ csfile.txt documentation for codepage and sort order
+ ("CS") files
+
+ bibtex.h definition of global parameters and limits
+ datatype.h definition of custom data types
+ gblprocs.h forward declaration of all global functions
+ gblvars.h declaration of global variables
+ sysdep.h determine the compiler and environment
+
+ bibtex.c main source including system dependent code
+ bibtex-1.c part 1 of the system independent functions
+ bibtex-2.c part 2 of the system independent functions
+ bibtex-3.c part 3 of the system independent functions
+ bibtex-4.c part 4 of the system independent functions
+
+ utils.c nearly all of the enhancement code
+ utils.h
+
+ getopt.c the GNU getopt package for command line parsing
+ getopt1.c
+ getopt.h
+
+ dos-emx.mak makefile for EMX GNU C under MS-DOS
+ dos-dj.mak makefile for DJGPP GNU C under MS-DOS
+ os2.mak makefile for EMX GNU C under OS/2
+ unix.mak makefile for Unix variants
+
+
+ 2.4 bt371csf.zip
+ ----------------
+
+ The character set and sorting order is now defined by an external
+ configuration text file - the codepage and sort order ("CS") file. A
+ number of example files have been included with the master distribution,
+ but I hope that others will be written by 8-bit BibTeX users in due
+ course. To avoid the need to reissue to the master ZIP files every time
+ a new CS file is created, CS files will also be available as a separate
+ kit.
+
+ At the time of writing, the kit contains these CS files:
+
+ File Name Character Set Sorting Order
+ -------------------------------------------------------------
+ 88591lat.csf ISO 8859-1 Latin
+ 88591sca.csf ISO 8859-1 Scandinavean
+ ascii.csf US ASCII English
+ cp437lat.csf IBM codepage 437 Latin
+ cp850lat.csf IBM codepage 850 Latin
+ cp850sca.csf IBM codepage 850 Scandinavean
+ cp866rus.csf IBM codepage 866 Russian
+
+
+
+3. Running 8-bit BibTeX
+------------------------
+
+Running 8-bit BibTeX is superficially the same as running the original
+BibTeX, but there are quite a number of command line options that may be
+specified.
+
+
+ 3.1 Command line options
+ ------------------------
+
+ The command line syntax is:
+
+ bibtex [options] aux-file
+
+ where "aux-file" is the name of the TeX auxilliary output file to be
+ processed by BibTeX. The trailing ".aux" may be omitted.
+
+ Valid options are:
+
+ -? --help
+
+ Display some brief help text and then exit.
+
+ -7 --traditional
+
+ Operate in the original 7-bit mode. A CS file is not read:
+ only 7-bit ASCII characters are supported and sorting is
+ strictly by ASCII code value.
+
+ BibTeX will not allow you to specify --traditional with
+ either the --8bit or --csfile option.
+
+ -8 --8bit
+
+ Force 8-bit mode. A CS file is not read. All 8-bit
+ characters (code > 127) are treated as letters and sorting is
+ strictly by code page value.
+
+ BibTeX will not allow you to specify --8bit with either the
+ --csfile or --traditional option.
+
+ -c --csfile FILE
+
+ Read FILE as the BibTeX codepage and sort definition (CS)
+ file. The CS file is used to define the 8-bit character set
+ used by BibTeX and the order in which those characters should
+ be sorted.
+
+ BibTeX will not allow you to specify --csfile with either
+ the --8bit or --traditional option.
+
+ -d --debug TYPE
+
+ Report debugging information to the BibTeX log file and the
+ standard error device. The value TYPE controls the type of
+ debugging information reported. TYPE can be one or more of:
+
+ all - all debugging categories
+ csf - CS file processing
+ io - file I/O
+ mem - memory allocation and capacity
+ misc - other debugging information
+ search - path searching and file location
+
+ It is possible that your version of BibTeX has been compiled
+ with debugging support disabled. If this is the case, BibTeX
+ will issue a warning message when --debug is specified.
+
+ -s --statistics
+
+ Report internal statistics to the BibTeX log file.
+
+ It is possible that your version of BibTeX has been compiled
+ with statistics support disabled. If this is the case,
+ BibTeX will issue a warning message when --statistics is
+ specified.
+
+ -t --trace
+
+ Report execution tracing to the BibTeX log file.
+
+ It is possible that your version of BibTeX has been compiled
+ with tracing support disabled. If this is the case, BibTeX
+ will issue a warning message when --trace is specified.
+
+ -v --version
+
+ Report BibTeX's version and then exit.
+
+ -B --big
+
+ Set BibTeX's capacity to "big". The size of particular
+ parameters will be set as follows (the default sizes are
+ shown in brackets):
+
+ Hash_Prime 8,501 (4,253)
+ Hash_Size 10,000 (5,000)
+ Max_Cites 2,000 (750)
+ Max_Ent_Ints 4,000 (3,000)
+ Max_Ent_Strs 6,000 (3,000)
+ Max_Fields 30,000 (17,250)
+ Max_Strings 10,000 (4,000)
+ Pool_Size 130,000 (65,530)
+ Wiz_Fn_Space 6,000 (3,000)
+
+ -H --huge
+
+ Set BibTeX's capacity to "huge". The size of particular
+ parameters will be set as follows (the default sizes are
+ shown in brackets):
+
+ Hash_Prime 16,319 (4,253)
+ Hash_Size 19,000 (5,000)
+ Max_Cites 5,000 (750)
+ Max_Ent_Ints 5,000 (3,000)
+ Max_Ent_Strs 10,000 (3,000)
+ Max_Fields 85,000 (17,250)
+ Max_Strings 19,000 (4,000)
+ Pool_Size 500,000 (65,530)
+ Wiz_Fn_Space 10,000 (3,000)
+
+ -W --wolfgang
+
+ Set BibTeX's capacity to "really huge" - required for
+ Wolfgang's PhD thesis. The size of particular parameters
+ will be set as follows (the default sizes are shown in
+ brackets):
+
+ Hash_Prime 30,011 (4,253)
+ Hash_Size 35,000 (5,000)
+ Max_Cites 7,500 (750)
+ Max_Ent_Ints 7,500 (3,000)
+ Max_Ent_Strs 10,000 (3,000)
+ Max_Fields 125,000 (17,250)
+ Max_Strings 30,000 (4,000)
+ Pool_Size 750,000 (65,530)
+ Wiz_Fn_Space 10,000 (3,000)
+
+ -M --min_crossrefs ##
+
+ Set min_crossrefs to ##. If an item is cross-referenced at
+ least ## times, it will be placed in the list of citations,
+ even if it is not explicitly \cited as a reference. The
+ default value is 2.
+
+ --mcites ##
+
+ Allow a maximum of ## distinct \cites in the .aux files.
+ This number must be less than the maximum number of strings
+ (settable with --mstrings).
+
+ --mentints ##
+
+ Allow a maximum of ## integer entries in the .bib databases.
+
+ --mentstrs ##
+
+ Allow a maximum of ## string entries in the .bib databases.
+
+ --mfields ##
+
+ Allow a maximum of ## fields in the .bib databases.
+
+ --mpool ##
+
+ Set the string pool to ## bytes.
+
+ --mstrings ##
+
+ Allow a maximum of ## unique strings. This number must be
+ less than the hash size and greater than the maximum number
+ of \cites (settable with --mcites).
+
+ --mwizfuns ##
+
+ Allow a maximum of ## wizard functions.
+
+
+ 3.2 Finding Files
+ -----------------
+
+ 8-bit BibTeX looks for input files in three different steps as summarised
+ below. As soon as 8-bit BibTeX finds a matching file, it stops looking
+ (i.e. only the first matching file is used). In order, the three steps
+ are:
+
+ - look for the file in the current working directory.
+
+ - if the appropriate environment variable has been set (e.g. BSTINPUT),
+ treat its value as a list of directories to be searched. Look for the
+ file in each of the directories in the list.
+
+ - if the appropriate environment variable (e.g. BSTINPUT) has not been
+ set, use a predefined "fallback" path as a list of directories to be
+ searched.
+
+ A search list consists of a number of directories separated by a delimiter
+ (semicolons for MS-DOS & OS/2, colons for Unix and commas for VMS).
+
+ As distributed, the strategy adopted by 8-bit BibTeX for opening specific
+ file types is
+
+ .aux files
+
+ - look in current working directory only
+
+ .bib (BibTeX database) files
+
+ - look in current working directory
+ - search along path defined by environment variable BIBINPUT
+ - search along fallback path (empty by default)
+
+ .bst (BibTeX style) files
+
+ - look in current working directory
+ - search along path defined by environment variable BSTINPUT
+ - search along fallback path (empty by default)
+
+ .csf (CS) files
+
+ - look in current working directory
+ - search along path defined by environment variable CSFINPUT
+ - search along fallback path (empty by default)
+
+ The name of the CS file is determined using a number of steps
+
+ - use value of --csfile command line option,
+ - use value of the BIBTEX_CSFILE environment variable
+ - use fallback CS file name (empty by default)
+
+ Output files
+
+ All of BibTeX's output (.bbl, .blg) files are created in the
+ current working directory.
+
+
+ The environment variables and fallback paths used by 8-bit BibTeX are
+ defined in the Makefile and set at compile time, but you can determine
+ what your version of 8-bit BibTeX is using by starting it with the command
+ line
+
+ bibtex --debug=search non-existent-file-name
+
+ The debugging output (written to the standard error device) should look
+ something like:
+
+ D-SCH: Search strategy for .aux files:
+ D-SCH: search path environment variable: <undefined>
+ D-SCH: fallback search path: <undefined>
+ D-SCH: Search strategy for .bib files:
+ D-SCH: search path environment variable: BIBINPUT
+ D-SCH: BIBINPUT value: e:\usr\c\bibtex
+ D-SCH: fallback search path: e:/usr/latex/bibtex;e:/emtex/bibtex/bib
+ D-SCH: Search strategy for .bst files:
+ D-SCH: search path environment variable: BSTINPUT
+ D-SCH: BSTINPUT value: <undefined>
+ D-SCH: fallback search path: e:/usr/latex/bibtex;e:/emtex/bibtex/bst
+ D-SCH: Search strategy for .csf files:
+ D-SCH: search path environment variable: CSFINPUT
+ D-SCH: CSFINPUT value: e:\usr\c\bibtex
+ D-SCH: fallback search path: e:/usr/latex/bibtex;e:/emtex/bibtex/csf
+ D-SCH: Default .csf file:
+ D-SCH: file name environment variable: BIBTEX_CSFILE
+ D-SCH: BIBTEX_CSFILE value: e:/emtex/texinput/cp437lat.csf
+ D-SCH: fallback file name: cp850lat.csf
+
+ The current working directory will always be searched, even if the
+ environment variable and fallback paths have not been specified (e.g. as
+ for .aux files in the above example).
+
+ If the default behaviour is not to your liking, you will need to rebuild
+ 8-bit BibTeX from its source code (see section 5).
+
+
+ 3.3 Environment variables
+ -------------------------
+
+ As supplied, 8-bit BibTeX uses a number of environment variables:
+
+ BIBINPUT search path for database (.bib) files
+ BSTINPUT search path for style (.bst) files
+ CSFINPUT search path for CS (.csf) files
+ BIBTEX_CSFILE the default CS file
+ TMP directory for virtual memory files (DOS only)
+
+ The name of the environment variables used may be changed (in the
+ Makefile) when BibTeX is built. See the appropriate Makefile for your
+ environment and remember that you can use the "--debug=search" command
+ line option to reveal the environment variables used by your version of
+ 8-bit BibTeX (see previous section).
+
+ All environment variables used as a search list (BIBINPUT, BSTINPUT &
+ CSFINPUT) can be set to a number of separate directories, separated
+ by a delimiter (semicolons for MS-DOS & OS/2, colons for Unix and
+ commas for VMS).
+
+ Examples for MS-DOS and OS/2 are:
+
+ SET BIBINPUT=e:\data\tex\bibtex;c:\emtex\bibtex\bib
+ SET BSTINPUT=e:\data\tex\bibtex;c:\emtex\bibtex\bst
+ SET CSFINPUT=e:\data\tex\bibtex
+ SET BIBTEX_CSFILE=c:\data\tex\bibtex\cp850lat.csf
+
+ Examples for Unix:
+
+ setenv BIBINPUT /u/kempson/bibtex:/usr/local/lib/tex/bib-files
+ setenv BSTINPUT /u/kempson/bibtex:/usr/local/lib/tex/bst-files
+ setenv CSFINPUT /u/kempson/bibtex:/usr/local/lib/tex/csf-files
+ setenv BIBTEX_CSFILE /usr/local/lib/tex/csf-files/88591lat.csf
+
+ Examples for VMS:
+
+ define BIBINPUT "sys$login:,disk$tex:[bibtex.bib-files]"
+ define BSTINPUT "sys$login:,disk$tex:[bibtex.bst-files]"
+ define CSFINPUT "sys$login:,disk$tex:[bibtex.csf-files]"
+ define BIBTEX_CSFILE disk$tex:[bibtex.csf-files]88951lat.csf
+
+
+
+4. The Codepage and Sort Order (CS) File
+-----------------------------------------
+
+The Codepage and Sort definition (CS) file is used to define the 8-bit
+character set used by BibTeX and the order in which those characters should
+be sorted.
+
+Please see the associated csfile.txt for details of CS file syntax and
+guidelines for testing new CS files. NOTE: it contains many 8-bit characters
+and may cause problems if you try to display or print it on 7-bit systems
+(e.g. older versions of Unix).
+
+
+
+5. Building 8-bit BibTeX from Source Code
+------------------------------------------
+
+The 8-bit BibTeX source is fairly standard ANSI C with almost no system
+specific code. It should therefore be relatively straightforward to build it
+in a different environment if you have GNU C or an ANSI C compiler.
+
+A number of Makefiles have been provided to build 8-bit BibTeX from source
+code:
+
+ dos-emx.mak makefile for EMX GNU C under MS-DOS
+ dos-dj.mak makefile for DJGPP GNU C under MS-DOS
+ os2.mak makefile for EMX GNU C under OS/2
+ unix.mak makefile for Unix variants
+
+Whichever Makefile you use, you need to check that the "local definitions"
+are appropriate for your system. There are three small sections to
+customise:
+
+ BibTeX File Searching
+
+ - specifies the names of environment variables and paths to be used when
+ searching for input files
+
+ Utility Programs
+
+ - specifies the names of programs to be used for simple functions
+
+ Compiler/Linker
+
+ - specifies compiler/linker command lines
+
+If your system is already supported it should not be necessary to modify any
+part of the Makefile except these three sections.
+
+Brief notes for specific environments follow.
+
+
+ 5.1 DOS
+ -------
+
+ 8-bit BibTeX has been built and tested using the EMX and DJGPP
+ development environments. Both are based on GNU C with their own
+ custom 32-bit extenders.
+
+
+ 5.2 OS/2
+ --------
+
+ The EMX development environment is supported.
+
+
+ 5.3 Unix
+ --------
+
+ Most variants of Unix supporting GNU C should be capable of building
+ and running 8-bit BibTeX.
+
+
+ 5.4 VMS
+ -------
+
+ The authors have not built or tested this version of 8-bit BibTeX on
+ VMS, but see no reason why it shouldn't compile and run successfully
+ if GNU C is installed on the system. (The only system-dependent code
+ in 8-bit BibTeX concerns file opening and provision has been made for
+ VMS file modes.)
+
+ If you have GNU C installed, we recommend starting with a copy of the
+ unix.mak Makefile and customising it for VMS. If you successfully
+ get 8-bit BibTeX running under VMS, *please* let the authors know how
+ you did it.
+
+
+
+6. Reporting Bugs and Requesting Improvements
+----------------------------------------------
+
+Where possible, we will try to fix bugs and will consider requests for
+improvements. If you are reporting a bug, please provide as much information
+as possible (e.g. operating environment, 8-bit BibTeX version and source,
+exact error message and the offending files if possible).
+
+The most common message is of the form "BibTeX doesn't work on XXXX". This
+is generally of no help in debugging a problem so please provide as much
+information as possible.
+
+
+ 6.1 Contacting the authors
+ --------------------------
+
+ The authors are
+
+ Niel Kempson
+ Snowy Owl Systems Limited, Cheltenham, England
+ E-mail: kempson@snowyowl.co.uk
+
+ and
+
+ Alejandro Aguilar-Sierra
+ Centro de Ciencias de la Atm\'osfera,
+ Universidad Nacional Aut\'onoma de M\'exico, M\'exico
+ E-mail: asierra@servidor.unam.mx
+
+ Niel Kempson did the original manual translation from WEB to C,
+ conversion to "big" (32-bit) capacity, addition of run-time selectable
+ capacity and part of the 8-bit support extensions. He intermittently
+ maintains the master version of the source code.
+
+ Alejandro Aguilar-Sierra should take the credit for most of the 8-bit
+ function provided by this version of BibTeX.
+
+
+ 6.2 Further Enhancements
+ ------------------------
+
+ No program is perfect and this version of BibTeX is no exception to that
+ rule. Some known weaknesses are:
+
+ - the 8-bit support is currently limited to single 8-bit characters.
+ TeX control sequences (e.g. \'{A}) are not interpreted and treated in
+ the same way as the equivalent 8-bit character.
+
+ - it is not possible to redefine the lower 128 character codes. This
+ excludes support for character codes not built on ASCII (e.g. EBCDIC).
+
+ Future enhancements will be considered, but it may be time to build a
+ "proper" system built from the ground up to handle 8-bit character
+ sets. BibTeX 1.0 promises to be this system.
+
+ Other items that ought to be on the "to do" list:
+
+ - path searching using Karl Berry's kpathsea package
+ - TeX format documentation
+ - Unix man pages
+ - OS/2 .inf format documentation
+ - native 32-bit support for MS Windows 95/NT
+
+
+
+7. Frequently Asked Questions
+------------------------------
+
+When I run the DOS version 8-bit BibTeX in a DOS window under MS Windows 3.x,
+95 or NT, I get the message "DPMI not supported".
+
+ 8-bit BibTeX has been built using the EMX development environment. It
+ uses the VCPI mechanism to run in 32-bit mode and will therefore not run
+ in a DOS session under MS Windows.
+
+ If you want to run this version of 8-bit BibTeX in a DOS session under
+ MS Windows, you have two choices:
+
+ - get and install the RSX extender
+ - rebuild from sources using a suitable compiler
+
+ See section 2.1 for more information.
+
+
+8-bit BibTeX doesn't find my .bib/.bst files. How can I find out where it
+looks for them?
+
+ See section 3.2
+
+
+There isn't a CS file for my character set / language sorting order
+
+ Creating a new CS file should be relatively straightforward. If you'd
+ like to try, please contact the authors for assistance. If you don't
+ need assistance, *please* let us have a copy of your finished CS file so
+ we can include it in the distribution.
+
+
+
+8. Acknowledgement
+-------------------
+
+The original BibTeX was written by Oren Patashnik using Donald Knuth's WEB
+system. This format produces a PASCAL program for execution and a TeX
+documented version of the source code. This program started as a (manual)
+translation of the WEB source into C.
+
+
+
+9. BibTeX Use and Copying Conditions
+-------------------------------------
+
+The programs currently being distributed that relate to 8-bit BibTeX are
+*free*; this means that everyone may use them and redistribute them freely.
+The 8-bit BibTeX-related programs are not in the public domain; they are
+copyrighted and there are restrictions on their distribution, but these
+restrictions are designed to permit everything that a good cooperating
+citizen would want to do. What is not allowed is to try to prevent others
+from further sharing any version of these programs that they might get from
+you.
+
+Specifically, we want to make sure that you have the right to give away
+copies of the programs that relate to 8-bit BibTeX, that you receive source
+code or else can get it if you want it, that you can change these programs or
+use pieces of them in new free programs, and that you know you can do these
+things.
+
+To make sure that everyone has such rights, we have to forbid you to deprive
+anyone else of these rights. For example, if you distribute copies of the
+8-bit BibTeX related programs, you must give the recipients all the rights
+that you have. You must make sure that they, too, receive or can get the
+source code. And you must tell them their rights.
+
+Also, for our own protection, we must make certain that everyone finds out
+that there is no warranty for the programs that relate to 8-bit BibTeX. If
+these programs are modified by someone else and passed on, we want their
+recipients to know that what they have is not what we distributed, so that
+any problems introduced by others will not reflect on our reputation.
+
+The precise conditions of the licences for the programs currently being
+distributed that relate to 8-bit BibTeX are found in the General Public
+Licences that accompany them.
+
+
+
+10. Change Log
+---------------
+
+$Log: 00readme.txt,v $
+Revision 3.71 1996/08/18 20:38:55 kempson
+Official release 3.71 (see HISTORY for details).
+
+Revision 3.70 1996/04/29 20:17:53 kempson
+Final documentation & cosmetic changes for official release 3.70.
+
+Revision 1.2 1995/10/21 22:23:01 kempson
+Updated for v3.60 beta. Added description of --wolfgang option.
+Added some more information on running BibTeX in a Windows DOS session.
+Changed the example of CSF debugging output to something that is correct.
+
+Revision 1.1 1995/09/24 20:50:00 kempson
+Updated for the final beta test release.
+
+Revision 1.0 1995/09/24 20:42:30 kempson
+Placed under RCS control
+
+******************************** END OF FILE *******************************
diff --git a/Master/texmf-dist/doc/bibtex8/HISTORY b/Master/texmf-dist/doc/bibtex8/HISTORY
new file mode 100644
index 00000000000..f9c8619dcea
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex8/HISTORY
@@ -0,0 +1,65 @@
+******************************************************************************
+FILE: $RCSfile: HISTORY,v $
+ $Revision: 3.71 $
+ $Date: 1996/08/18 20:42:32 $
+******************************************************************************
+
+
+8-Bit BibTeX CHANGE HISTORY
+---------------------------
+
+31-May-2005 Karl Berry
+ - Applied utils.c patch from Arne J\"orgensen for space character
+ sorting weight, sent to tex-live@tug.org 31 May 2005 15:52:07 +0200.
+
+v3.71 18-August-1996 Niel Kempson <snowyowl.co.uk>
+
+ - Changed default environment variables used for consistency across OS
+ implementations and better compatibility with emTeX. Now uses
+ BIBINPUT, BSTINPUT & CSFINPUT as the default environment variables
+ for .bib, .bst and .csf files respectively.
+
+ "Hard-coded" fallback search paths can now be specified for use if
+ the chosen environment variables are not defined. The environment
+ variables and the fallback paths are now defined in the Makefile
+ rather than in sysdep.h.
+
+ Thanks to Lars Frellesen <frelle@math-tech.dk> for spotting the
+ inconsistency and his Makefile suggestions.
+
+ - Fixed bug in handling of CSF \order section. Any alpha or numeric
+ character may now be specified in the sort order - previously only
+ alphas were allowed and BibTeX didn't correctly sort citations like
+ Knuth89, Knuth92 because the digits were ignored during sort
+ comparisons. Corrected example CS files to include digits in the
+ sort orders. Thanks to Andrei Grinkevitch <grin@bals.usr.pu.ru> for
+ spotting this one.
+
+ - Included the first contributed CS file: for codepage 866 with a Russian
+ sorting order. Thanks again to Andrei Grinkevitch <grin@bals.usr.pu.ru>.
+
+ - Added the missing 'd' to the sort section of 88591lat.csf. Thanks to
+ Tim Geisler <geisler@pms.informatik.uni-muenchen.de>.
+
+ - Removed CS files from all but the bt371csf.zip distribution file.
+
+ - Clarified 00readme.txt, specifically sections dealing with environment
+ variables and CS files. Moved 8-bit section describing CS files into
+ a separate csfile.txt because some people were having problems when
+ they tried to view the 8-bit 00readme.txt file on a 7-bit Unix
+ system. Thanks to Ken Smith <kgs@maths.uq.oz.au> for highlighting
+ this issue.
+
+ - Reinstated the -W option (--wolfgang did work). Thanks to Thomas
+ Plagwitz <tplagiwt@ix.urz.uni-heidelberg.de> for spotting this.
+
+ - Fixed str_lookup() to work with a hash size > 32767.
+
+ - Created new HISTORY file.
+
+
+v3.70 29-Apr-1996 Niel Kempson <snowyowl.co.uk>
+
+ Final documentation & cosmetic changes for official release 3.70.
+
+******************************** END OF FILE *******************************
diff --git a/Master/texmf-dist/doc/bibtex8/csfile.txt b/Master/texmf-dist/doc/bibtex8/csfile.txt
new file mode 100644
index 00000000000..9f112a466c3
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex8/csfile.txt
@@ -0,0 +1,318 @@
+******************************************************************************
+FILE: $RCSfile: csfile.txt,v $
+ $Revision: 3.71 $
+ $Date: 1996/08/18 20:41:31 $
+******************************************************************************
+
+
+An 8-bit Implementation of BibTeX 0.99 with a Very Large Capacity
+=================================================================
+
+
+Contents
+--------
+
+ 1. The Codepage and Sort Order (CS) File
+ 1.1 CS file syntax
+ 1.2 Testing a CS file
+ 1.3 Sharing your CS file
+
+ 2. Change Log
+
+
+
+1. The Codepage and Sort Order (CS) File
+-----------------------------------------
+
+The Codepage and Sort definition (CS) file is used to define the 8-bit
+character set used by BibTeX and the order in which those characters should
+be sorted.
+
+NOTE: this file contains many 8-bit characters and may cause problems
+ if you try to display or print it on 7-bit systems (e.g. older
+ versions of Unix).
+
+
+ 1.1 CS file syntax
+ ------------------
+
+ The codepage and sorting order (CS) file defines how BibTeX will treat an
+ 8-bit character set, specifically which characters are to be treated as
+ letters, the upper/lower case relationships between characters, and the
+ sorting order of characters.
+
+ The CS file may contain a number of sections, each presented in the form
+ of a TeX macro:
+
+ \section-name{
+ <section definitions>
+ }
+
+ Four sections are currently supported: \lowupcase, \lowercase, \uppercase
+ and \order. The syntax of the four supported sections is summarised
+ below.
+
+ 8-bit characters may be entered naturally, but to avoid problems with
+ character set translation or corruption, they can also be entered using
+ the TeX-style portable notation for character codes, i.e. ^^XX, where XX
+ is the hexadecimal value ofthe character code.
+
+ Reading of the sections ends when the first '}' character is reached, so
+ '}' can't be included in a section. You can, however, use ^^7d instead.
+
+ The percent sign ('%') is used to introduce a trailing comment - it and
+ all remaining characters on a line are ignored. If you need to insert a
+ percent character, you can use ^^25 instead.
+
+
+ \lowupcase section
+
+ The \lowupcase section of the CS file is used to define the lower
+ /upper and upper/lower case relationship of pairs of specified
+ characters. It is only used if the relationship is symmetrical - use
+ \lowercase or \upcase if it isn't.
+
+ The syntax of the \lowupcase section is:
+
+ \lowupcase{
+ <LC-1> <UC-1> % Comment begins with a percent sign
+ <LC-2> <UC-2>
+ ...
+ <LC-N> <UC-N>
+ }
+
+ Each <LC-n> <UC-n> pair of characters defines that the upper case
+ equivalent of <LC-n> is <UC-n> *and* the lower case equivalent of
+ <UC-n> is <LC-n>.
+
+ You cannot redefine the lower or upper case equivalent of an ASCII
+ character (code < 128), so all instances of <LC-n> and <UC-n> (i.e.
+ both sides of the relationship) must have codes > 127.
+
+
+ \lowercase section
+
+ The \lowercase section of the CS file is used to define the lower
+ case equivalent of specified characters. It should normally only be
+ used if the relationship isn't symmetrical - use \lowupcase if it is.
+
+ The syntax of the \lowercase section is:
+
+ \lowercase{
+ <UC-1> <LC-1> % Comment begins with a percent sign
+ <UC-2> <LC-2>
+ ...
+ <UC-N> <LC-N>
+ }
+
+ Each <LC-n> <UC-n> pair of characters defines that the lower case
+ equivalent of <UC-n> is <LC-n>.
+
+ You cannot redefine the lower case equivalent of an ASCII character
+ (code < 128), so all instances of <UC-n> (i.e. the left hand side of
+ the relationship) must have codes > 127.
+
+
+ \uppercase section
+
+ The \uppercase section of the CS file is used to define the upper
+ case equivalent of specified characters. It should normally only be
+ used if the relationship isn't symmetrical - use \lowupcase if it is.
+
+ The syntax of the \uppercase section is:
+
+ \uppercase{
+ <LC-1> <UC-1> % Comment begins with a percent sign
+ <LC-2> <UC-2>
+ ...
+ <LC-N> <UC-N>
+ }
+
+ Each <LC-n> <UC-n> pair of characters defines that the upper case
+ case equivalent of <LC-n> is <UC-n>.
+
+ You cannot redefine the upper case equivalent of an ASCII character
+ (code < 128), so all instances of <LC-n> (i.e. the left hand side of
+ the relationship) must have codes > 127.
+
+
+ \order section
+
+ The \order section of the CS file is used to define the order in
+ which characters are sorted.
+
+ The syntax of the \order section is:
+
+ \order{
+ <char-1> % Comment begins with a percent sign
+ <char-2> <char-3> % whitespace between the chars
+ <char-4> - <char-5> % a hyphen between the chars
+ <char-4> _ <char-5> % an underscore between the chars
+ ...
+ <char-n>
+ }
+
+ All characters on the same line are given the same sorting weight.
+
+ The construct <char-1> <underscore> <char-2> is used to denote that
+ all characters in the range <char-1> to <char-2> should be given the
+ same sorting weight. For example, "A _ Z" would cause all ASCII
+ upper case alphabetical characters to have the same sorting weight
+ and would be equivalent to placing all 26 characters on the same
+ line.
+
+ The construct <char-1> <hyphen> <char-2> is used to denote that all
+ characters in the range <char-1> to <char-2> should be given an
+ ascending set of sorting weights, starting with <char-1> and ending
+ with <char-2>. For example, "A - Z" would cause all upper case ASCII
+ alphabetical characters to be sorted in ascending order and would be
+ equivalent to placing 'A' on the first line, 'B' on the second,
+ through to 'Z' on the 26th line.
+
+ The characters at the beginning of the order section are given a
+ lower sorting weight than characters occuring later. When sorting
+ alphabetically, characters with the lowest weight come first.
+
+ All characters not in the \order section (including ASCII characters)
+ are given the same very high sorting weight to ensure that they come
+ last when sorting alphabetically.
+
+
+ 1.2 Testing a CS file
+ ---------------------
+
+ If you create a CS, you'll want a straightforward way of testing that
+ BibTeX is interpreting it as you expect it to. The --debug=csf option
+ will report the results of parsing the CS file. Specifically, BibTeX
+ will report:
+
+ o characters with codes > 127 that it has defined as type ALPHA
+ o characters with upper case equivalents
+ o characters with lower case equivalents
+ o characters in ascending sorting order
+
+ An example of the output when processing the cp437lat.csf CS file is
+ shown below. This output will only make sense if you are using a
+ computer that supports the IBM codepage 437.
+
+ D-CSF: c8read_csf: trying to open CS file `cp437lat.csf' ...
+ D-CSF: reading the \lowupcase section ...
+ D-CSF: finished reading the \lowupcase section.
+ D-CSF: reading the \uppercase section ...
+ D-CSF: finished reading the \uppercase section.
+ D-CSF: reading the \order section ...
+ D-CSF: finished reading the \order section.
+
+ D-CSF: 8-bit ALPHA characters
+ D-CSF: ----------------------
+ D-CSF: 80:
+ D-CSF: 90: . . . . . .
+ D-CSF: a0: . . . . . . . . . .
+ D-CSF: b0: . . . . . . . . . . . . . . . .
+ D-CSF: c0: . . . . . . . . . . . . . . . .
+ D-CSF: d0: . . . . . . . . . . . . . . . .
+ D-CSF: e0: . . . . . . . . . . . . . . .
+ D-CSF: f0: . . . . . . . . . . . . . . . .
+
+ D-CSF: Characters with upper case equivalents
+ D-CSF: --------------------------------------
+ D-CSF: a [61] <<< A [41] b [62] <<< B [42] c [63] <<< C [43]
+ D-CSF: d [64] <<< D [44] e [65] <<< E [45] f [66] <<< F [46]
+ D-CSF: g [67] <<< G [47] h [68] <<< H [48] i [69] <<< I [49]
+ D-CSF: j [6a] <<< J [4a] k [6b] <<< K [4b] l [6c] <<< L [4c]
+ D-CSF: m [6d] <<< M [4d] n [6e] <<< N [4e] o [6f] <<< O [4f]
+ D-CSF: p [70] <<< P [50] q [71] <<< Q [51] r [72] <<< R [52]
+ D-CSF: s [73] <<< S [53] t [74] <<< T [54] u [75] <<< U [55]
+ D-CSF: v [76] <<< V [56] w [77] <<< W [57] x [78] <<< X [58]
+ D-CSF: y [79] <<< Y [59] z [7a] <<< Z [5a] [81] <<< [9a]
+ D-CSF: [82] <<< [90] [83] <<< A [41] [84] <<< [8e]
+ D-CSF: [85] <<< A [41] [86] <<< [8f] [87] <<< [80]
+ D-CSF: [88] <<< E [45] [89] <<< E [45] [8a] <<< E [45]
+ D-CSF: [8b] <<< I [49] [8c] <<< I [49] [8d] <<< I [49]
+ D-CSF: [91] <<< [92] [93] <<< O [4f] [94] <<< [99]
+ D-CSF: [95] <<< O [4f] [96] <<< U [55] [97] <<< U [55]
+ D-CSF: [a0] <<< A [41] [a1] <<< I [49] [a2] <<< O [4f]
+ D-CSF: [a3] <<< U [55] [a4] <<< [a5]
+
+ D-CSF: Characters with lower case equivalents
+ D-CSF: --------------------------------------
+ D-CSF: A [41] >>> a [61] B [42] >>> b [62] C [43] >>> c [63]
+ D-CSF: D [44] >>> d [64] E [45] >>> e [65] F [46] >>> f [66]
+ D-CSF: G [47] >>> g [67] H [48] >>> h [68] I [49] >>> i [69]
+ D-CSF: J [4a] >>> j [6a] K [4b] >>> k [6b] L [4c] >>> l [6c]
+ D-CSF: M [4d] >>> m [6d] N [4e] >>> n [6e] O [4f] >>> o [6f]
+ D-CSF: P [50] >>> p [70] Q [51] >>> q [71] R [52] >>> r [72]
+ D-CSF: S [53] >>> s [73] T [54] >>> t [74] U [55] >>> u [75]
+ D-CSF: V [56] >>> v [76] W [57] >>> w [77] X [58] >>> x [78]
+ D-CSF: Y [59] >>> y [79] Z [5a] >>> z [7a] [80] >>> [87]
+ D-CSF: [8e] >>> [84] [8f] >>> [86] [90] >>> [82]
+ D-CSF: [92] >>> [91] [99] >>> [94] [9a] >>> [81]
+ D-CSF: [a5] >>> [a4]
+
+ D-CSF: Characters in sorting order
+ D-CSF: ---------------------------
+ D-CSF: 00: 0 [30]
+ D-CSF: 01: 1 [31]
+ D-CSF: 02: 2 [32]
+ D-CSF: 03: 3 [33]
+ D-CSF: 04: 4 [34]
+ D-CSF: 05: 5 [35]
+ D-CSF: 06: 6 [36]
+ D-CSF: 07: 7 [37]
+ D-CSF: 08: 8 [38]
+ D-CSF: 09: 9 [39]
+ D-CSF: 0a: A [41] a [61] [83] [84] [85] [86] [8e] [8f] [a0]
+ D-CSF: 0b: [91] [92]
+ D-CSF: 0c: B [42] b [62]
+ D-CSF: 0d: C [43] c [63] [80] [87]
+ D-CSF: 0e: D [44] d [64]
+ D-CSF: 0f: E [45] e [65] [82] [88] [89] [8a] [90]
+ D-CSF: 10: F [46] f [66]
+ D-CSF: 11: G [47] g [67]
+ D-CSF: 12: H [48] h [68]
+ D-CSF: 13: I [49] i [69] [8b] [8c] [8d] [a1]
+ D-CSF: 14: J [4a] j [6a]
+ D-CSF: 15: K [4b] k [6b]
+ D-CSF: 16: L [4c] l [6c]
+ D-CSF: 17: M [4d] m [6d]
+ D-CSF: 18: N [4e] n [6e]
+ D-CSF: 19: [a4] [a5]
+ D-CSF: 1a: O [4f] o [6f] [93] [94] [95] [99] [a2]
+ D-CSF: 1b: P [50] p [70]
+ D-CSF: 1c: Q [51] q [71]
+ D-CSF: 1d: R [52] r [72]
+ D-CSF: 1e: S [53] s [73]
+ D-CSF: 1f: [e1]
+ D-CSF: 20: T [54] t [74]
+ D-CSF: 21: U [55] u [75] [81] [96] [97] [9a] [a3]
+ D-CSF: 22: V [56] v [76]
+ D-CSF: 23: W [57] w [77]
+ D-CSF: 24: X [58] x [78]
+ D-CSF: 25: Y [59] y [79]
+ D-CSF: 26: Z [5a] z [7a]
+ D-CSF: (All other characters are sorted equally after any of the above.)
+
+
+ 1.3 Sharing your CS file
+ ------------------------
+
+ Although we have provided a limited number of CS files, we hope that
+ other will soon produce different examples for other character sets and
+ national sorting orders. We will also be happy to accept corrections to
+ the example files supplied.
+
+ If you'd like to contribute a CS file, please send it to one of the
+ authors or upload it to one of the CTAN FTP archives. If you e-mail a
+ copy please ZIP and encode (UU/MIME) it so that we can be confident that
+ the file has not become corrupted in transit.
+
+
+
+2. Change Log
+--------------
+
+$Log: csfile.txt,v $
+# Revision 3.71 1996/08/18 20:41:31 kempson
+# Placed under RCS control.
+#
+******************************** END OF FILE *******************************
diff --git a/Master/texmf-dist/doc/bibtex8/file_id.diz b/Master/texmf-dist/doc/bibtex8/file_id.diz
new file mode 100644
index 00000000000..b2379e717fc
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex8/file_id.diz
@@ -0,0 +1,13 @@
+(v3.71) "big" BibTeX with full 8-bit support
+
+An enhanced, portable C version of BibTeX.
+Enhanced by conversion to "big" (32-bit)
+capacity, addition of run-time selectable
+capacity and 8-bit support extensions.
+National character set and sorting order
+are controlled by an external configuration
+file. Various examples are included.
+Freeware / GNU Public Licence.
+
+Niel Kempson <kempson@snowyowl.co.uk>
+Alejandro Aguilar-Sierra <asierra@servidor.unam.mx>