diff options
Diffstat (limited to 'Build/source/texk/bibtexu/00readme.txt')
| -rw-r--r-- | Build/source/texk/bibtexu/00readme.txt | 903 |
1 files changed, 0 insertions, 903 deletions
diff --git a/Build/source/texk/bibtexu/00readme.txt b/Build/source/texk/bibtexu/00readme.txt deleted file mode 100644 index 6322e51fcd3..00000000000 --- a/Build/source/texk/bibtexu/00readme.txt +++ /dev/null @@ -1,903 +0,0 @@ -****************************************************************************** -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 ******************************* |