more info in bibtexu documents

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

5 files changed, 212 insertions, 5 deletions

diff --git a/Master/texmf-dist/doc/bibtexu/README b/Master/texmf-dist/doc/bibtexu/README
index 6b6cf693e80..5c72795e8a0 100644
--- a/Master/texmf-dist/doc/bibtexu/README
+++ b/Master/texmf-dist/doc/bibtexu/README
@@ -2,12 +2,54 @@ 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.
+UTF-8 encoded files.  It was written by Yannis Haralambous and his
+students of Télécom Bretagne.
 
+New features in this tool include:
+  * UTF-8 compatibility of Unicode encoding
+  * integration of sort and case-change routines from the ICU library
+  * dependency on Unix locale (which can also be indicated manually
+    through a command line option)
+
+In less technical terms, BibTeXu allows the processing of
+bibliographic references in all scripts of the world while leaving
+some flexibility in the method of sorting and changing of case.
+
+The first release of BibTeXu (sources + precompiled binaries) was
+dated on 2009-09-23, which appeared on the website by Yannis [1].
+It was later presented at Journée GUTenberg, a conference in France,
+on 2009-11-21 [2, 3].
+
+References:
+  [1] http://omega2.enstb.org/yannis/ (dead link)
+  [2] https://www.gutenberg.eu.org/Journee-GUTenberg-2009
+  [3] Lettre GUTenberg 36 published in 2010
+
+
+Status of BibTeXu in TeX Live
+=============================
+
+BibTeXu has been integrated into TeX Live 2010.
 The one shipped with TL is updated so that BibTeX, BibTeX8 and BibTeXu
-shares more or less the same behavior wrt memory allocation, etc.
+share 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.
+
+Despite of that, it is likely that BibTeXu shipped with TL still does
+not behave as expected.  The precompiled binaries of the first release
+by Yannis on 2009-09-23 seemed to work to some extent, so there might
+have been some inconsistency in the integration.
+
+The files in examples/ show the expected behavior:
+  * test.tex: the input XeLaTeX source, which uses a Unicode font
+              covering Latin, Greek and Chinese
+  * test.bib: the input BIB file
+  * test.bbl: expected output of BibTeXu
+              (obtained from BibTeXu 2009-09-23 with ICU 4.2.1)
+  * test.pdf: expected final output of XeLaTeX
+
+Hope that this works in the future.
+
+
+This README file was written by TeX Live team, on 2019-03-02.
+Public domain.
diff --git a/Master/texmf-dist/doc/bibtexu/examples/test.bbl b/Master/texmf-dist/doc/bibtexu/examples/test.bbl
new file mode 100644
index 00000000000..66d054801a5
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtexu/examples/test.bbl
@@ -0,0 +1,44 @@
+\begin{thebibliography}{1}
+
+\bibitem{cle2}
+Nicolas Échelon.
+\newblock {\em La vie est un long fleuve tranquille}.
+\newblock Les Éditions du désastre, 2009.
+
+\bibitem{cle8}
+Nicolas Œtingen.
+\newblock {\em Un livre}.
+\newblock Les Éditions du désastre, 2009.
+
+\bibitem{cle4}
+Nicolas Tarantin.
+\newblock {\em En revenant de Tarascon}.
+\newblock Les Éditions du désastre, 2009.
+
+\bibitem{cle1}
+Διογένης.
+\newblock {\em Μήπως εἴδατε τὸ φανάρι μου;}.
+\newblock Τὰ σοφὰ βιβλία, 2009.
+
+\bibitem{cle7}
+Μῆτσος Ἕλληνας.
+\newblock {\em Τὸ καλὸ παράδειγμα}.
+\newblock Ἐκδοτικὸς οἶκος «Δὲν βαριέσαι», 2009.
+
+\bibitem{cle5}
+Ζαχαρίας Ζαχαρόπουλος.
+\newblock {\em Μοῦ λένε νὰ μὴν κλαίω, μὰ τί νὰ
+  κάνω, ἀφοῦ σὲ χάνω}.
+\newblock Ἐκδόσεις τῶν χαμένων ἐλπίδων, 2009.
+
+\bibitem{cle6}
+节列表 天王最新章.
+\newblock {\em 製版・文書処理システム Ω}.
+\newblock Les Éditions du désastre, 2009.
+
+\bibitem{cle3}
+格的儿子 天堂最新的章节表.
+\newblock {\em 製版・文書処理システム Ω}.
+\newblock Les Éditions du désastre, 2009.
+
+\end{thebibliography}
diff --git a/Master/texmf-dist/doc/bibtexu/examples/test.bib b/Master/texmf-dist/doc/bibtexu/examples/test.bib
new file mode 100644
index 00000000000..b442eeb88a2
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtexu/examples/test.bib
@@ -0,0 +1,48 @@
+
+@book{cle1,
+	Author = {Διογένης},
+	Publisher = {Τὰ σοφὰ βιβλία},
+	Title = {Μήπως εἴδατε τὸ φανάρι μου;},
+	Year = {2009}}
+
+@book{cle2,
+	Author = {Échelon, Nicolas},
+	Publisher = {Les Éditions du désastre},
+	Title = {La vie est un long fleuve tranquille},
+	Year = {2009}}
+
+@book{cle3,
+	Author = {天堂最新的章节表, 格的儿子},
+	Publisher = {Les Éditions du désastre},
+	Title = {製版・文書処理システム Ω},
+	Year = {2009}}
+
+@book{cle4,
+	Author = {Tarantin, Nicolas},
+	Publisher = {Les Éditions du désastre},
+	Title = {En revenant de Tarascon},
+	Year = {2009}}
+
+@book{cle5,
+	Author = {Ζαχαρόπουλος, Ζαχαρίας},
+	Publisher = {Ἐκδόσεις τῶν χαμένων ἐλπίδων},
+	Title = {Μοῦ λένε νὰ μὴν κλαίω, μὰ τί νὰ κάνω, ἀφοῦ σὲ χάνω},
+	Year = {2009}}
+
+@book{cle6,
+	Author = {天王最新章, 节列表},
+	Publisher = {Les Éditions du désastre},
+	Title = {製版・文書処理システム Ω},
+	Year = {2009}}
+
+@book{cle7,
+	Author = {Ἕλληνας, Μῆτσος},
+	Publisher = {Ἐκδοτικὸς οἶκος «Δὲν βαριέσαι»},
+	Title = {Τὸ καλὸ παράδειγμα},
+	Year = {2009}}
+
+@book{cle8,
+	Author = {Œtingen, Nicolas},
+	Publisher = {Les Éditions du désastre},
+	Title = {Un livre},
+	Year = {2009}}
diff --git a/Master/texmf-dist/doc/bibtexu/examples/test.pdf b/Master/texmf-dist/doc/bibtexu/examples/test.pdf
new file mode 100644
index 00000000000..55d267d3941
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtexu/examples/test.pdf
diff --git a/Master/texmf-dist/doc/bibtexu/examples/test.tex b/Master/texmf-dist/doc/bibtexu/examples/test.tex
new file mode 100644
index 00000000000..4cd387bace2
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtexu/examples/test.tex
@@ -0,0 +1,73 @@
+\documentclass{article}
+\title{Test file for Bib\TeX u}
+\author{Yannis Haralambous}
+\begin{document}
+\maketitle
+\font\x="Arial Unicode MS"
+\let\em\x
+\x
+
+This is a test file for Bib\TeX u. The BIB file is as follows:
+
+\medskip
+
+\noindent@book\{cle1,\\
+	Author = \{Διογένης\},\\
+	Publisher = \{Τὰ σοφὰ βιβλία\},\\
+	Title = \{Μήπως εἴδατε τὸ φανάρι μου;\},\\
+	Year = \{2009\}\}\\
+
+\noindent@book\{cle2,\\
+	Author = \{Échelon, Nicolas\},\\
+	Publisher = \{Les Éditions du désastre\},\\
+	Title = \{La vie est un long fleuve tranquille\},\\
+	Year = \{2009\}\}\\
+
+\noindent@book\{cle3,\\
+	Author = \{天堂最新的章节表, 格的儿子\},\\
+	Publisher = \{Les Éditions du désastre\},\\
+	Title = \{製版・文書処理システム Ω\},\\
+	Year = \{2009\}\}\\
+
+\noindent@book\{cle4,\\
+	Author = \{Tarantin, Nicolas\},\\
+	Publisher = \{Les Éditions du désastre\},\\
+	Title = \{En revenant de Tarascon\},\\
+	Year = \{2009\}\}\\
+
+\noindent@book\{cle5,\\
+	Author = \{Ζαχαρόπουλος, Ζαχαρίας\},\\
+	Publisher = \{Ἐκδόσεις τῶν χαμένων ἐλπίδων\},\\
+	Title = \{Μοῦ λένε νὰ μὴν κλαίω, μὰ τί νὰ κάνω, ἀφοῦ σὲ χάνω\},\\
+	Year = \{2009\}\}\\
+
+\noindent@book\{cle6,\\
+	Author = \{天王最新章, 节列表\},\\
+	Publisher = \{Les Éditions du désastre\},\\
+	Title = \{製版・文書処理システム Ω\},\\
+	Year = \{2009\}\}\\
+
+\noindent@book\{cle7,\\
+	Author = \{Ἕλληνας, Μῆτσος\},\\
+	Publisher = \{Ἐκδοτικὸς οἶκος «Δὲν βαριέσαι»\},\\
+	Title = \{Τὸ καλὸ παράδειγμα\},\\
+	Year = \{2009\}\}\\
+
+\noindent@book\{cle8,\\
+	Author = \{Œtingen, Nicolas\},\\
+	Publisher = \{Les Éditions du désastre\},\\
+	Title = \{Un livre\},\\
+	Year = \{2009\}\}\\
+
+\medskip
+
+As you can see, we have mixed together entries in French, Greek and Chinese. The challenge of the French entries is that Échelon should be sorted as ”echelon” and Œtingen sorted as “oetingen” so that the right order is : Échelon < Œtingen < Tartarin.
+
+Same problem in Greek: Ἕλληνας should be sorted as “ελληνας” and hence should appear between Διογένης and Ζαχαρόπουλος.
+
+Have fun with Bib\TeX u! Once testing and debugging is finished we will write a paper for TUGboat.
+
+\nocite{*}
+\bibliographystyle{plain}
+\bibliography{test}
+\end{document}