******************************************************************************

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
4.1
4.2
4.3

Codepage and Sort Order (CS) File

CS file syntax
Testing a CS file
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
COPYING
HISTORY
csfile.txt
msdos/bibtex.exe

this file
GNU copyright notice
summary of changes made so far
documentation for codepage and sort order
("CS") files
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
COPYING
HISTORY
csfile.txt
os2/bibtex.exe

this file
GNU copyright notice
summary of changes made so far
documentation for codepage and sort order
("CS") files
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
COPYING
HISTORY
csfile.txt

this file
GNU copyright notice
summary of changes made so far
documentation for codepage and sort order
("CS") files

bibtex.h
datatype.h
gblprocs.h
gblvars.h
sysdep.h

definition of global parameters and limits

definition of custom data types
forward declaration of all global functions
declaration of global variables
determine the compiler and environment

bibtex.c
bibtex-1.c
bibtex-2.c
bibtex-3.c
bibtex-4.c

main
part
part
part
part

utils.c
utils.h

nearly all of the enhancement code

getopt.c
getopt1.c
getopt.h

the GNU getopt package for command line parsing

dos-emx.mak
dos-dj.mak
os2.mak
unix.mak

makefile
makefile
makefile
makefile

source including system dependent code

1 of the system independent functions
2 of the system independent functions
3 of the system independent functions
4 of the system independent functions

for
for
for
for

EMX GNU C under MS-DOS

DJGPP GNU C under MS-DOS
EMX GNU C under OS/2
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
csf
io
mem
misc
search

all debugging categories

CS file processing
file I/O
memory allocation and capacity
other debugging information
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
Hash_Size
Max_Cites
Max_Ent_Ints
Max_Ent_Strs
Max_Fields
Max_Strings
Pool_Size
Wiz_Fn_Space

8,501 (4,253)
10,000 (5,000)
2,000
(750)
4,000 (3,000)
6,000 (3,000)
30,000 (17,250)
10,000 (4,000)
130,000 (65,530)
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
Hash_Size
Max_Cites
Max_Ent_Ints
Max_Ent_Strs
Max_Fields
Max_Strings
Pool_Size
Wiz_Fn_Space

16,319 (4,253)
19,000 (5,000)
5,000
(750)
5,000 (3,000)
10,000 (3,000)
85,000 (17,250)
19,000 (4,000)
500,000 (65,530)
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
Hash_Size
Max_Cites
Max_Ent_Ints
Max_Ent_Strs
Max_Fields
Max_Strings
Pool_Size
Wiz_Fn_Space

30,011 (4,253)
35,000 (5,000)
7,500
(750)
7,500 (3,000)
10,000 (3,000)
125,000 (17,250)
30,000 (4,000)
750,000 (65,530)
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:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:
D-SCH:

Search strategy for .aux files:

search path environment variable: <undefined>
fallback search path: <undefined>
Search strategy for .bib files:
search path environment variable: BIBINPUT
BIBINPUT value: e:\usr\c\bibtex
fallback search path: e:/usr/latex/bibtex;e:/emtex/bibtex/bib
Search strategy for .bst files:
search path environment variable: BSTINPUT
BSTINPUT value: <undefined>
fallback search path: e:/usr/latex/bibtex;e:/emtex/bibtex/bst
Search strategy for .csf files:
search path environment variable: CSFINPUT
CSFINPUT value: e:\usr\c\bibtex
fallback search path: e:/usr/latex/bibtex;e:/emtex/bibtex/csf
Default .csf file:
file name environment variable: BIBTEX_CSFILE
BIBTEX_CSFILE value: e:/emtex/texinput/cp437lat.csf
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
BSTINPUT
CSFINPUT
BIBTEX_CSFILE
TMP

search path for database (.bib) files

search path for style (.bst) files
search path for CS (.csf) files
the default CS file
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
SET
SET
SET

BIBINPUT=e:\data\tex\bibtex;c:\emtex\bibtex\bib
BSTINPUT=e:\data\tex\bibtex;c:\emtex\bibtex\bst
CSFINPUT=e:\data\tex\bibtex
BIBTEX_CSFILE=c:\data\tex\bibtex\cp850lat.csf

Examples for Unix:

setenv
setenv
setenv
setenv

BIBINPUT /u/kempson/bibtex:/usr/local/lib/tex/bib-files
BSTINPUT /u/kempson/bibtex:/usr/local/lib/tex/bst-files
CSFINPUT /u/kempson/bibtex:/usr/local/lib/tex/csf-files
BIBTEX_CSFILE /usr/local/lib/tex/csf-files/88591lat.csf

Examples for VMS:

define
define
define
define

BIBINPUT "sys$login:,disk$tex:[bibtex.bib-files]"
BSTINPUT "sys$login:,disk$tex:[bibtex.bst-files]"
CSFINPUT "sys$login:,disk$tex:[bibtex.csf-files]"
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
dos-dj.mak
os2.mak
unix.mak

makefile
makefile
makefile
makefile

for
for
for
for

EMX GNU C under MS-DOS

DJGPP GNU C under MS-DOS
EMX GNU C under OS/2
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 *******************************