summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md22
-rw-r--r--README.rst113
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)