diff options
| -rw-r--r-- | README.md | 22 | ||||
| -rw-r--r-- | README.rst | 113 |
2 files changed, 113 insertions, 22 deletions
diff --git a/README.md b/README.md deleted file mode 100644 index 7df62af..0000000 --- a/README.md +++ /dev/null @@ -1,22 +0,0 @@ -# Locales support for musl -Locale program for musl libc - -This is ```/usr/bin/locale```, which works on musl libc (with limitations in musl itself). -To install, use ```cmake . && make && sudo make install``` on musl-capable distro. -English and Russian included, also .pot file. - -## Build requirements: - - musl (with developer tools) - - gettext (with libintl and developer tools) - - С compiler (gcc or clang recommended) - - CMake - - CMake backend provider (make or ninja) - - *For alpine, you can use this command:* ```apk add --update cmake make musl-dev gcc gettext-dev libintl``` - -## License - - - All translations and scripts uses [MIT](LICENSE.MIT) - - Source files for `/usr/bin/locale` uses [LGPL](LICENSE) - -Now musl-locales in community repo of Alpine Linux)
\ No newline at end of file diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..0c2f698 --- /dev/null +++ b/README.rst @@ -0,0 +1,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) |