summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/babel/README.md
blob: ad9d1740776f9f4da93dc618a8e8fcd8c54016ef (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
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