summaryrefslogtreecommitdiff
path: root/README.rst
blob: 0c2f698f8bd5f15bf9365c86e9b1edb81d24cb7b (plain) (blame)
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
112
113
=========================
 README for musl-locales
=========================
:Authors:
  * **Konstantin**, original developer
  * **A. Wilcox**, maintainer
  * **Contributors**, translations and fixes (see commit log)
:Status:
  Production




Introduction
============

This repository contains code and translation files for better locale support
for the `musl libc`_.

The **locale(1)** command displays information about the currently set locale,
or displays a list of locales available on the system.

The translation files provide localisation to musl, including libc-provided
error messages, date and time strings, and so forth.

.. _`musl libc`: https://musl.libc.org


License
```````

Translation files are provided under the MIT license.  The **locale(1)**
implementation is provided under the LGPL v3 license (LGPL-3.0-only).




Building
========

This section contains information about building the **locale(1)** command and
translations.


Requirements
````````````

This package uses the CMake build system.

To build the translation files, you will need an implementation of ``msgfmt``
and ``xgettext``.  Both GNU gettext and gettext-tiny are supported.

To build the **locale(1)** command, you will need a C compiler, the musl libc,
and an implementation of ``libintl``.  Again, GNU gettext and gettext-tiny are
both supported.


Commands
````````

To build in the same directory as the source::

    cmake .
    make
    sudo make install

Out-of-tree builds are also supported::

    cmake -Bbuild .
    make -C build
    sudo make -C build install




Included translations
=====================

This section contains information about the translations included with the
musl-locales package.  Note that "fully translated" does not mean that a given
translation is free from defects.  Feel free to open an issue or merge request
if you identify an issue in any translation, including those listed as fully
translated.


========  ===============================================
Language  Status
========  ===============================================
cs_CZ     Fully translated.
de_DE     Date/time strings only.
en_GB     Messages translated where different from en_US.
es_ES     Date/time strings only.
fi_FI     Date/time strings only.
fr_FR     Date/time strings only.
it_IT     Date/time strings only.
nb_NO     Date/time strings only.
nl_NL     Date/time strings only.
pt_BR     Date/time strings only.
pt_PT     Fully translated.
ru_RU     Fully translated.
sr_RS     Fully translated.
sv_SE     Date/time strings only.
========  ===============================================




End-user packages
=================

.. image:: https://repology.org/badge/vertical-allrepos/musl-locales.svg
   :target: https://repology.org/project/musl-locales/versions
   :alt: Repology packaging status (Adélie, Alpine, Exherbo, and more)