summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/babel/README.md
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-01-04 23:39:46 +0000
committerKarl Berry <karl@freefriends.org>2018-01-04 23:39:46 +0000
commit2c16907b492b353f234ae633ea24851c0f809242 (patch)
treea639e848a1f8919ef7529c405cb447c53ab2c389 /Master/texmf-dist/doc/latex/babel/README.md
parentbb83d426056841b56f02baa144b334892a340fa6 (diff)
babel (4jan18)
git-svn-id: svn://tug.org/texlive/trunk@46210 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/babel/README.md')
-rw-r--r--Master/texmf-dist/doc/latex/babel/README.md111
1 files changed, 111 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/babel/README.md b/Master/texmf-dist/doc/latex/babel/README.md
new file mode 100644
index 00000000000..ad9d1740776
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/babel/README.md
@@ -0,0 +1,111 @@
+## Babel 3.16
+
+This package manages culturally-determined typographical (and other)
+rules, and hyphenation patterns for a wide range of languages. Many
+language styles work with pdflatex, as well as with xelatex and
+lualatex out of the box. A few even work with plain formats.
+
+The latest stable version is available on <https://ctan.org/pkg/babel>.
+
+Version 3.9a fixed lots of bugs and added some new features, intended
+mainly to make it compatible somehow with Unicode engines. Some bugs
+have not been fixed to avoid backward incompatibilities, but they have
+been documented. Most of the new features (like package options) were
+intended to overcome issues in previous releases without changing
+significantly the behaviour of Babel.
+
+Current development is focused on Unicode engines (XeTeX and LuaTeX).
+New features related to font selection, bidi writing and the like will
+be added incrementally. Versions numbers drop the letter and now 3.10,
+3.11, etc., will be used instead. So, 3.9t is the last in the former
+series.
+
+Included is a set of ini files for about 200 languages.
+
+Languages are not part of the Babel core any more; in particular, it
+shall be no longer necessary to synchronize Babel core releases with
+releases of Babel language files. See CONTRIB for further details
+about contributing a language. You may also create an ini file or
+improve the existing ones -- it's a trivial task (no programming
+skills required at all), but don't hesitate to ask for help.
+
+The best way to install and/or update it is with the help of package
+managers.
+
+Changes are described in babel.pdf with the label "New <version>". The
+manual has been expanded to include some tips and tricks, but it will
+be improved in next releases.
+
+### Reporting Bugs
+
+If you wish to report a problem or bug in any of these packages please
+use the
+[Issue Tracker for LaTeX2e on GitHub](https://github.com/latex3/latex2e/issues)
+and follow the guidelines that pop up if you press the `New issue`
+button.
+
+In particular, to check that you are really seeing a bug, please write
+a short, self-contained document that shows the problem. This should
+include the `latexbug` package, which will warn if your test file is
+not suitable for one or the other reason. See the
+[CONTRIBUTING guide](https://github.com/latex3/latex2e/blob/master/CONTRIBUTING.md)
+for further details, or if you need to obtain the `latexbug` package.
+
+If the bug turns out to be with third-party software then please
+contact the developer, and not us!
+
+You may also report them to the author more informally on:
+
+ http://www.texnia.com/contact.html
+
+Bugs related to specific languages are best reported to their
+respective authors.
+
+### New
+
+```
+3.16 - New package option layout for bidi documents.
+ - Quotes in TU encoding
+ - Fix - \<language>date did not work correctly
+ - Fix - with some languages (eg, british), using
+ \babelfont raised an error.
+
+3.15 - New command \babelfont (in Unicode engines) to define
+ language/script dependent fonts. Related to it, new
+ keys (script, language) in \babelprovide.
+ - A common mistake is to leave some space(s) in \captions<lang>,
+ which go to the document. Now babel removes them.
+ - Fix - Error with hyphenrules in \babelprovide in some cases.
+ - Fix - \hyphenrules doesn't set \languagename any more (which
+ was against the documented behavior),
+
+3.14 - R text (Hebrew-like) and AL text (Arabic-like) in luatex, with
+ "European" and "Arabic" numbers, mirroring and unmarked L text.
+ - Fix - `import' ignored `hyphenrules' in ini files.
+
+3.13 - Existing ldf files takes priority over declared options with
+ \DeclareOption (except hebrew).
+ - With a few exceptions, ini files have reached version 1.0.
+ - New key `import' for \babelprovide, which also defines dates.
+
+[3.12 - Internal.]
+
+3.11 - Fix - error when version in format and of package
+ didn't match.
+ - Now switch.def is loaded always.
+ - First steps in bidi writing.
+
+3.10 - New versioning
+ - New macro - \babelprovide
+
+3.9t - Part of the code for 3.10 ss has been "back-ported" to this
+ release, but they are only internal changes.
+ - Fix - with \babelhyphen{soft} the hyphen could vanish.
+ - English, Indonesian and Malay "dialects" now rely on the proxy
+ files provided by these languages (eg, american.ldf, melayu.ldf).
+ If you upgrade babel, you MUST upgrade those languages, too.
+```
+
+Javier Bezos
+2018-01-04
+