path: root/Build/source/texk/bibtexu/00readme.txt

******************************************************************************
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 *******************************