summaryrefslogtreecommitdiff
path: root/Master/texmf-dist
diff options
context:
space:
mode:
authorNorbert Preining <preining@logic.at>2019-03-01 12:04:01 +0000
committerNorbert Preining <preining@logic.at>2019-03-01 12:04:01 +0000
commit3d0e60f45c88626adaa02b258a720f68f37d8c94 (patch)
treeb9dfa6d50c85f6d9b6cb380407df260b0db0810b /Master/texmf-dist
parent1490c646c92a850d842e4b5ed08fac5cc32ea7e7 (diff)
bibtexu: updated docs (from Hironobu Yamashita)
git-svn-id: svn://tug.org/texlive/trunk@50184 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r--Master/texmf-dist/doc/bibtexu/00readme.txt903
-rw-r--r--Master/texmf-dist/doc/bibtexu/HISTORY65
-rw-r--r--Master/texmf-dist/doc/bibtexu/README13
-rw-r--r--Master/texmf-dist/doc/bibtexu/csfile.txt318
-rw-r--r--Master/texmf-dist/doc/bibtexu/file_id.diz13
5 files changed, 13 insertions, 1299 deletions
diff --git a/Master/texmf-dist/doc/bibtexu/00readme.txt b/Master/texmf-dist/doc/bibtexu/00readme.txt
deleted file mode 100644
index 6322e51fcd3..00000000000
--- a/Master/texmf-dist/doc/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 *******************************
diff --git a/Master/texmf-dist/doc/bibtexu/HISTORY b/Master/texmf-dist/doc/bibtexu/HISTORY
deleted file mode 100644
index f9c8619dcea..00000000000
--- a/Master/texmf-dist/doc/bibtexu/HISTORY
+++ /dev/null
@@ -1,65 +0,0 @@
-******************************************************************************
-FILE: $RCSfile: HISTORY,v $
- $Revision: 3.71 $
- $Date: 1996/08/18 20:42:32 $
-******************************************************************************
-
-
-8-Bit BibTeX CHANGE HISTORY
----------------------------
-
-31-May-2005 Karl Berry
- - Applied utils.c patch from Arne J\"orgensen for space character
- sorting weight, sent to tex-live@tug.org 31 May 2005 15:52:07 +0200.
-
-v3.71 18-August-1996 Niel Kempson <snowyowl.co.uk>
-
- - Changed default environment variables used for consistency across OS
- implementations and better compatibility with emTeX. Now uses
- BIBINPUT, BSTINPUT & CSFINPUT as the default environment variables
- for .bib, .bst and .csf files respectively.
-
- "Hard-coded" fallback search paths can now be specified for use if
- the chosen environment variables are not defined. The environment
- variables and the fallback paths are now defined in the Makefile
- rather than in sysdep.h.
-
- Thanks to Lars Frellesen <frelle@math-tech.dk> for spotting the
- inconsistency and his Makefile suggestions.
-
- - Fixed bug in handling of CSF \order section. Any alpha or numeric
- character may now be specified in the sort order - previously only
- alphas were allowed and BibTeX didn't correctly sort citations like
- Knuth89, Knuth92 because the digits were ignored during sort
- comparisons. Corrected example CS files to include digits in the
- sort orders. Thanks to Andrei Grinkevitch <grin@bals.usr.pu.ru> for
- spotting this one.
-
- - Included the first contributed CS file: for codepage 866 with a Russian
- sorting order. Thanks again to Andrei Grinkevitch <grin@bals.usr.pu.ru>.
-
- - Added the missing 'd' to the sort section of 88591lat.csf. Thanks to
- Tim Geisler <geisler@pms.informatik.uni-muenchen.de>.
-
- - Removed CS files from all but the bt371csf.zip distribution file.
-
- - Clarified 00readme.txt, specifically sections dealing with environment
- variables and CS files. Moved 8-bit section describing CS files into
- a separate csfile.txt because some people were having problems when
- they tried to view the 8-bit 00readme.txt file on a 7-bit Unix
- system. Thanks to Ken Smith <kgs@maths.uq.oz.au> for highlighting
- this issue.
-
- - Reinstated the -W option (--wolfgang did work). Thanks to Thomas
- Plagwitz <tplagiwt@ix.urz.uni-heidelberg.de> for spotting this.
-
- - Fixed str_lookup() to work with a hash size > 32767.
-
- - Created new HISTORY file.
-
-
-v3.70 29-Apr-1996 Niel Kempson <snowyowl.co.uk>
-
- Final documentation & cosmetic changes for official release 3.70.
-
-******************************** END OF FILE *******************************
diff --git a/Master/texmf-dist/doc/bibtexu/README b/Master/texmf-dist/doc/bibtexu/README
new file mode 100644
index 00000000000..6b6cf693e80
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtexu/README
@@ -0,0 +1,13 @@
+BibTeXu: a Unicode compliant version of BibTeX
+======================================================================
+
+BibTeXu is the Unicode-compliant version of BibTeX, that reads (only)
+UTF-8 encoded files. It was written by Yannis Haralambous to use the
+ICU library with BibTeX. There is another 8-bit implementation of
+BibTeX, named BibTeX8 by Niel Kempson; however, BibTeXu by Yannis was
+an independent project.
+
+The one shipped with TL is updated so that BibTeX, BibTeX8 and BibTeXu
+shares more or less the same behavior wrt memory allocation, etc.
+Peter Breitenlohner put in the massive efforts needed to make this
+work in the TL build system and use the same ICU library as XeTeX.
diff --git a/Master/texmf-dist/doc/bibtexu/csfile.txt b/Master/texmf-dist/doc/bibtexu/csfile.txt
deleted file mode 100644
index 9f112a466c3..00000000000
--- a/Master/texmf-dist/doc/bibtexu/csfile.txt
+++ /dev/null
@@ -1,318 +0,0 @@
-******************************************************************************
-FILE: $RCSfile: csfile.txt,v $
- $Revision: 3.71 $
- $Date: 1996/08/18 20:41:31 $
-******************************************************************************
-
-
-An 8-bit Implementation of BibTeX 0.99 with a Very Large Capacity
-=================================================================
-
-
-Contents
---------
-
- 1. The Codepage and Sort Order (CS) File
- 1.1 CS file syntax
- 1.2 Testing a CS file
- 1.3 Sharing your CS file
-
- 2. Change Log
-
-
-
-1. The Codepage and Sort Order (CS) File
------------------------------------------
-
-The Codepage and Sort definition (CS) file is used to define the 8-bit
-character set used by BibTeX and the order in which those characters should
-be sorted.
-
-NOTE: this file contains many 8-bit characters and may cause problems
- if you try to display or print it on 7-bit systems (e.g. older
- versions of Unix).
-
-
- 1.1 CS file syntax
- ------------------
-
- The codepage and sorting order (CS) file defines how BibTeX will treat an
- 8-bit character set, specifically which characters are to be treated as
- letters, the upper/lower case relationships between characters, and the
- sorting order of characters.
-
- The CS file may contain a number of sections, each presented in the form
- of a TeX macro:
-
- \section-name{
- <section definitions>
- }
-
- Four sections are currently supported: \lowupcase, \lowercase, \uppercase
- and \order. The syntax of the four supported sections is summarised
- below.
-
- 8-bit characters may be entered naturally, but to avoid problems with
- character set translation or corruption, they can also be entered using
- the TeX-style portable notation for character codes, i.e. ^^XX, where XX
- is the hexadecimal value ofthe character code.
-
- Reading of the sections ends when the first '}' character is reached, so
- '}' can't be included in a section. You can, however, use ^^7d instead.
-
- The percent sign ('%') is used to introduce a trailing comment - it and
- all remaining characters on a line are ignored. If you need to insert a
- percent character, you can use ^^25 instead.
-
-
- \lowupcase section
-
- The \lowupcase section of the CS file is used to define the lower
- /upper and upper/lower case relationship of pairs of specified
- characters. It is only used if the relationship is symmetrical - use
- \lowercase or \upcase if it isn't.
-
- The syntax of the \lowupcase section is:
-
- \lowupcase{
- <LC-1> <UC-1> % Comment begins with a percent sign
- <LC-2> <UC-2>
- ...
- <LC-N> <UC-N>
- }
-
- Each <LC-n> <UC-n> pair of characters defines that the upper case
- equivalent of <LC-n> is <UC-n> *and* the lower case equivalent of
- <UC-n> is <LC-n>.
-
- You cannot redefine the lower or upper case equivalent of an ASCII
- character (code < 128), so all instances of <LC-n> and <UC-n> (i.e.
- both sides of the relationship) must have codes > 127.
-
-
- \lowercase section
-
- The \lowercase section of the CS file is used to define the lower
- case equivalent of specified characters. It should normally only be
- used if the relationship isn't symmetrical - use \lowupcase if it is.
-
- The syntax of the \lowercase section is:
-
- \lowercase{
- <UC-1> <LC-1> % Comment begins with a percent sign
- <UC-2> <LC-2>
- ...
- <UC-N> <LC-N>
- }
-
- Each <LC-n> <UC-n> pair of characters defines that the lower case
- equivalent of <UC-n> is <LC-n>.
-
- You cannot redefine the lower case equivalent of an ASCII character
- (code < 128), so all instances of <UC-n> (i.e. the left hand side of
- the relationship) must have codes > 127.
-
-
- \uppercase section
-
- The \uppercase section of the CS file is used to define the upper
- case equivalent of specified characters. It should normally only be
- used if the relationship isn't symmetrical - use \lowupcase if it is.
-
- The syntax of the \uppercase section is:
-
- \uppercase{
- <LC-1> <UC-1> % Comment begins with a percent sign
- <LC-2> <UC-2>
- ...
- <LC-N> <UC-N>
- }
-
- Each <LC-n> <UC-n> pair of characters defines that the upper case
- case equivalent of <LC-n> is <UC-n>.
-
- You cannot redefine the upper case equivalent of an ASCII character
- (code < 128), so all instances of <LC-n> (i.e. the left hand side of
- the relationship) must have codes > 127.
-
-
- \order section
-
- The \order section of the CS file is used to define the order in
- which characters are sorted.
-
- The syntax of the \order section is:
-
- \order{
- <char-1> % Comment begins with a percent sign
- <char-2> <char-3> % whitespace between the chars
- <char-4> - <char-5> % a hyphen between the chars
- <char-4> _ <char-5> % an underscore between the chars
- ...
- <char-n>
- }
-
- All characters on the same line are given the same sorting weight.
-
- The construct <char-1> <underscore> <char-2> is used to denote that
- all characters in the range <char-1> to <char-2> should be given the
- same sorting weight. For example, "A _ Z" would cause all ASCII
- upper case alphabetical characters to have the same sorting weight
- and would be equivalent to placing all 26 characters on the same
- line.
-
- The construct <char-1> <hyphen> <char-2> is used to denote that all
- characters in the range <char-1> to <char-2> should be given an
- ascending set of sorting weights, starting with <char-1> and ending
- with <char-2>. For example, "A - Z" would cause all upper case ASCII
- alphabetical characters to be sorted in ascending order and would be
- equivalent to placing 'A' on the first line, 'B' on the second,
- through to 'Z' on the 26th line.
-
- The characters at the beginning of the order section are given a
- lower sorting weight than characters occuring later. When sorting
- alphabetically, characters with the lowest weight come first.
-
- All characters not in the \order section (including ASCII characters)
- are given the same very high sorting weight to ensure that they come
- last when sorting alphabetically.
-
-
- 1.2 Testing a CS file
- ---------------------
-
- If you create a CS, you'll want a straightforward way of testing that
- BibTeX is interpreting it as you expect it to. The --debug=csf option
- will report the results of parsing the CS file. Specifically, BibTeX
- will report:
-
- o characters with codes > 127 that it has defined as type ALPHA
- o characters with upper case equivalents
- o characters with lower case equivalents
- o characters in ascending sorting order
-
- An example of the output when processing the cp437lat.csf CS file is
- shown below. This output will only make sense if you are using a
- computer that supports the IBM codepage 437.
-
- D-CSF: c8read_csf: trying to open CS file `cp437lat.csf' ...
- D-CSF: reading the \lowupcase section ...
- D-CSF: finished reading the \lowupcase section.
- D-CSF: reading the \uppercase section ...
- D-CSF: finished reading the \uppercase section.
- D-CSF: reading the \order section ...
- D-CSF: finished reading the \order section.
-
- D-CSF: 8-bit ALPHA characters
- D-CSF: ----------------------
- D-CSF: 80:
- D-CSF: 90: . . . . . .
- D-CSF: a0: . . . . . . . . . .
- D-CSF: b0: . . . . . . . . . . . . . . . .
- D-CSF: c0: . . . . . . . . . . . . . . . .
- D-CSF: d0: . . . . . . . . . . . . . . . .
- D-CSF: e0: . . . . . . . . . . . . . . .
- D-CSF: f0: . . . . . . . . . . . . . . . .
-
- D-CSF: Characters with upper case equivalents
- D-CSF: --------------------------------------
- D-CSF: a [61] <<< A [41] b [62] <<< B [42] c [63] <<< C [43]
- D-CSF: d [64] <<< D [44] e [65] <<< E [45] f [66] <<< F [46]
- D-CSF: g [67] <<< G [47] h [68] <<< H [48] i [69] <<< I [49]
- D-CSF: j [6a] <<< J [4a] k [6b] <<< K [4b] l [6c] <<< L [4c]
- D-CSF: m [6d] <<< M [4d] n [6e] <<< N [4e] o [6f] <<< O [4f]
- D-CSF: p [70] <<< P [50] q [71] <<< Q [51] r [72] <<< R [52]
- D-CSF: s [73] <<< S [53] t [74] <<< T [54] u [75] <<< U [55]
- D-CSF: v [76] <<< V [56] w [77] <<< W [57] x [78] <<< X [58]
- D-CSF: y [79] <<< Y [59] z [7a] <<< Z [5a] [81] <<< [9a]
- D-CSF: [82] <<< [90] [83] <<< A [41] [84] <<< [8e]
- D-CSF: [85] <<< A [41] [86] <<< [8f] [87] <<< [80]
- D-CSF: [88] <<< E [45] [89] <<< E [45] [8a] <<< E [45]
- D-CSF: [8b] <<< I [49] [8c] <<< I [49] [8d] <<< I [49]
- D-CSF: [91] <<< [92] [93] <<< O [4f] [94] <<< [99]
- D-CSF: [95] <<< O [4f] [96] <<< U [55] [97] <<< U [55]
- D-CSF: [a0] <<< A [41] [a1] <<< I [49] [a2] <<< O [4f]
- D-CSF: [a3] <<< U [55] [a4] <<< [a5]
-
- D-CSF: Characters with lower case equivalents
- D-CSF: --------------------------------------
- D-CSF: A [41] >>> a [61] B [42] >>> b [62] C [43] >>> c [63]
- D-CSF: D [44] >>> d [64] E [45] >>> e [65] F [46] >>> f [66]
- D-CSF: G [47] >>> g [67] H [48] >>> h [68] I [49] >>> i [69]
- D-CSF: J [4a] >>> j [6a] K [4b] >>> k [6b] L [4c] >>> l [6c]
- D-CSF: M [4d] >>> m [6d] N [4e] >>> n [6e] O [4f] >>> o [6f]
- D-CSF: P [50] >>> p [70] Q [51] >>> q [71] R [52] >>> r [72]
- D-CSF: S [53] >>> s [73] T [54] >>> t [74] U [55] >>> u [75]
- D-CSF: V [56] >>> v [76] W [57] >>> w [77] X [58] >>> x [78]
- D-CSF: Y [59] >>> y [79] Z [5a] >>> z [7a] [80] >>> [87]
- D-CSF: [8e] >>> [84] [8f] >>> [86] [90] >>> [82]
- D-CSF: [92] >>> [91] [99] >>> [94] [9a] >>> [81]
- D-CSF: [a5] >>> [a4]
-
- D-CSF: Characters in sorting order
- D-CSF: ---------------------------
- D-CSF: 00: 0 [30]
- D-CSF: 01: 1 [31]
- D-CSF: 02: 2 [32]
- D-CSF: 03: 3 [33]
- D-CSF: 04: 4 [34]
- D-CSF: 05: 5 [35]
- D-CSF: 06: 6 [36]
- D-CSF: 07: 7 [37]
- D-CSF: 08: 8 [38]
- D-CSF: 09: 9 [39]
- D-CSF: 0a: A [41] a [61] [83] [84] [85] [86] [8e] [8f] [a0]
- D-CSF: 0b: [91] [92]
- D-CSF: 0c: B [42] b [62]
- D-CSF: 0d: C [43] c [63] [80] [87]
- D-CSF: 0e: D [44] d [64]
- D-CSF: 0f: E [45] e [65] [82] [88] [89] [8a] [90]
- D-CSF: 10: F [46] f [66]
- D-CSF: 11: G [47] g [67]
- D-CSF: 12: H [48] h [68]
- D-CSF: 13: I [49] i [69] [8b] [8c] [8d] [a1]
- D-CSF: 14: J [4a] j [6a]
- D-CSF: 15: K [4b] k [6b]
- D-CSF: 16: L [4c] l [6c]
- D-CSF: 17: M [4d] m [6d]
- D-CSF: 18: N [4e] n [6e]
- D-CSF: 19: [a4] [a5]
- D-CSF: 1a: O [4f] o [6f] [93] [94] [95] [99] [a2]
- D-CSF: 1b: P [50] p [70]
- D-CSF: 1c: Q [51] q [71]
- D-CSF: 1d: R [52] r [72]
- D-CSF: 1e: S [53] s [73]
- D-CSF: 1f: [e1]
- D-CSF: 20: T [54] t [74]
- D-CSF: 21: U [55] u [75] [81] [96] [97] [9a] [a3]
- D-CSF: 22: V [56] v [76]
- D-CSF: 23: W [57] w [77]
- D-CSF: 24: X [58] x [78]
- D-CSF: 25: Y [59] y [79]
- D-CSF: 26: Z [5a] z [7a]
- D-CSF: (All other characters are sorted equally after any of the above.)
-
-
- 1.3 Sharing your CS file
- ------------------------
-
- Although we have provided a limited number of CS files, we hope that
- other will soon produce different examples for other character sets and
- national sorting orders. We will also be happy to accept corrections to
- the example files supplied.
-
- If you'd like to contribute a CS file, please send it to one of the
- authors or upload it to one of the CTAN FTP archives. If you e-mail a
- copy please ZIP and encode (UU/MIME) it so that we can be confident that
- the file has not become corrupted in transit.
-
-
-
-2. Change Log
---------------
-
-$Log: csfile.txt,v $
-# Revision 3.71 1996/08/18 20:41:31 kempson
-# Placed under RCS control.
-#
-******************************** END OF FILE *******************************
diff --git a/Master/texmf-dist/doc/bibtexu/file_id.diz b/Master/texmf-dist/doc/bibtexu/file_id.diz
deleted file mode 100644
index b2379e717fc..00000000000
--- a/Master/texmf-dist/doc/bibtexu/file_id.diz
+++ /dev/null
@@ -1,13 +0,0 @@
-(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>