Changes in version 0.1.0 (2025-02-14)                  

Breaking Changes

  - The package's lifecycle is set back to experimental.
      - All features are still well tested and documented, but they may
        change again in a near future. I am thinking about introducing
        many small changes to the interface of classes Text and
        Translator.
  - R >= 4.3.0 is now required. This is necessary to
      - leverage native UTF-8 support on Windows,
      - use function shorthands (\(...)) and
      - use the native pipe operator |> and related placeholders _.
  - Package stringi is now required at runtime.
      - This package dramatically increases the performance of
        normalize().
      - Its usage within the package will gradually increase over time.
  - Option transltr.default.path is renamed to transltr.path.
  - constant() is removed. While it technically was an unexported
    function, it was used to pass default values to many function
    arguments.
  - find_source() loses argument strict. It is replaced by new argument
    interface.
  - as_text.call() loses arguments strict and validate following the new
    interface mechanism of find_source(). It was rewritten accordingly.
  - translate() is removed and replaced by the new interface mechanism
    of find_source(). See the documentation of the latter for more
    information.

New Features

  - find_source() now detects calls to method Translator$translate() by
    default. Users may change this default behavior by passing a custom
    interface (a wrapper function) to find_source(). Since this work on
    a lexical basis, the function does not have to be defined at the
    time find_source() is called.
      - Users may migrate to the new mechanism by binding deprecated
        symbol translate to a function that calls method
        Translator$translate() in the environment of their choice (where
        it fits).
  - New option transltr.verbose. It can be used to set all verbose
    arguments to either TRUE or FALSE.
  - New function normalize(). The latter used to be internal but it is
    now exported for convenience. It documents how strings are
    standardized.
  - New method Translator$set_default_value(). It controls what methods
    Translator$translate() and Translator$get_translation() return when
    there is no translation.
  - Documentation of find_source() and class Translator is now more
    thorough.
  - Many details were added to the package's documentation overall. It
    was also simplified whenever appropriate.

Bug Fixes

  - export.Text() and export_translations() now wrap lines longer
    than 80 characters automatically via new internal function
    str_wrap().
      - Consequently, so does serialize() and serialize_translations().
  - normalize() now handles edge cases appropriately thanks to stringi.
  - format.Text() and format.Translator() now escape newline characters.
  - Identifiers of serialized Location objects embedded into serialized
    Text objects are now much shorter.
  - find_source() uses relative paths (to the project's working
    directory) by default.

Notes

  - The official title of the package (as it appears in DESCRIPTION) is
    now Support Many Languages in R.
  - The package now has a pkgdown website. See
    https://transltr.ununoctium.dev. It is not yet complete and requires
    more work.
  - A lot of typos were corrected here and there in the documentation.
  - Comments included in Translator and translations files were updated.
  - In outputs, Source Text is now used (it used to be pluralized).
  - The source code was (lightly) tidied.

Translations

The package is not yet translated.

                 Changes in version 0.0.1 (2025-01-24)                  

This is the first release of the package. While an extensive set of unit
tests fully covers it, some features could be modified in the future.
Treat it as a beta version until version 1.0.0 is released.