trunk/Master/texmf/doc/bibtex8/

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

4 files changed, 1295 insertions, 0 deletions

diff --git a/Master/texmf/doc/bibtex8/00readme.txt b/Master/texmf/doc/bibtex8/00readme.txt
new file mode 100644
index 00000000000..6322e51fcd3
--- /dev/null
+++ b/Master/texmf/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/doc/bibtex8/HISTORY b/Master/texmf/doc/bibtex8/HISTORY
new file mode 100644
index 00000000000..9a2d123c2c3
--- /dev/null
+++ b/Master/texmf/doc/bibtex8/HISTORY
@@ -0,0 +1,61 @@
+******************************************************************************
+FILE: $RCSfile: HISTORY,v $
+      $Revision: 3.71 $
+      $Date: 1996/08/18 20:42:32 $
+******************************************************************************
+
+
+8-Bit BibTeX CHANGE HISTORY
+---------------------------
+
+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/doc/bibtex8/csfile.txt b/Master/texmf/doc/bibtex8/csfile.txt
new file mode 100644
index 00000000000..9f112a466c3
--- /dev/null
+++ b/Master/texmf/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/doc/bibtex8/file_id.diz b/Master/texmf/doc/bibtex8/file_id.diz
new file mode 100644
index 00000000000..b2379e717fc
--- /dev/null
+++ b/Master/texmf/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>