summaryrefslogtreecommitdiff
path: root/docs/markdown/i18n-module.md
AgeCommit message (Collapse)Author
2025-11-25docs: Fix minor typo in i18n module docsPhilip Withnall
Signed-off-by: Philip Withnall <pwithnall@gnome.org>
2025-10-01Allow CustomTarget source for i18n.xgettextCharles Brunet
Fixes #15054
2025-07-22Docs: standardize between list and array as arrayDylan Baker
When arrays were added they were called arrays. Because the are implemented with Python lists, that language started leaking into talking about Meson types. This is confusing. I've attempted, as much as possible, to move to using one name, array. I picked array because 1) It's the original name used, and 2) what Meson has are more properly arrays as they have a fixed length, while a critical property of lists are the ability to link and unlink them. There are a couple of places where the list language has leaked into the names of keyword arguments. I have not made any attempt to change those, I don't know if it's that useful or not.
2025-04-09New xgettext method for i18n moduleCharles Brunet
This method call xgettext to extract translatable string from source files into a .pot translation template. It differs from a plain CustomTarget in three ways: - It accepts build targets as sources, and automatically resolves source files from those build targets; - It detects command lines that are too long, and writes, at config time, the list of source files into a text file to be consumed by the xgettext command; - It detects dependencies between pot extraction targets, based on the dependencies between source targets.
2023-04-11fix various spelling issuesJosh Soref
Signed-off-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
2022-06-27docs: fix broken links in i18n modueEli Schwartz
We want to talk about the kwargs to the custom_target() function, but tried to link to custom_tgt instead, which is not a function. It is an object, but this was the wrong reference method for a type. We want the function anyway, so use that.
2022-05-31docs: fix incorrect linkEli Schwartz
When referring to the custom_target docs, we want to point to the docs on the function, not the docs on the returned method.
2022-05-31fix bug in i18n merge_file/itstool_join revealed by previous commitEli Schwartz
Logically, i18n.merge_file cannot ever take a MULTI_OUTPUT_KW, but it does take a CT_OUTPUT_KW-like interface. Actually trying to pass multiple merge_file outputs causes the msgfmthelper script to be entirely malformed in the arguments it accepts, and treat the broken one like a --flag, then exit with argparse errors. Even if we somehow assumed that somehow it was designed to actually allow this, msgfmt doesn't support conceptually passing multiple outputs so that would be a msgfmt error instead of an error inside the guts of `meson --internal msgfmthelper`. Same logic applies again for the itstool command and the itstool internal helper. Catch this error at configuration time by using the single-output kwarg form. Likewise, it's totally nonsense to accept multiple install_dir or install_tags, and ever since commit 11f96380351a88059ec55f1070fdebc1b1033117 the CustomTarget itself won't even check this.
2022-01-22fix broken version annotations for the new itstool_join featureEli Schwartz
It was not added in 0.61.0 as that was already released.
2022-01-21i18n: Add support for joining XML localization via itstoolMatthias Klumpp
2021-10-03docs: Fix broken linksDaniel Mensinger
2021-08-31i18n module: provide targets as return value for gettext()Eli Schwartz
Users may wish to make use of these files for their own purposes. For example, the -pot and -update-po pseudo targets could be reused in an alias_target(), and at least one person wanted to reuse the built .mo files as custom_target input. Fixes #6227
2019-04-22i18n: add args keyword to merge_fileKonstantin
* i18n: add args keyword to merge_file * i18n: add testcase to msgfmt args
2019-01-26Add install_dir to i18n.gettextSergey Shatunov
2018-02-11Re-link remaining github wiki urls to mesonbuild.com siteSami Kerola
2017-11-13docs: Remove extra whitespace from i18nTingPing
2017-09-22Update i18n markdown page to add the new install parameterCorentin Noël
2017-08-21Wrapped and alphabetized the remaining modules.Jussi Pakkanen
2017-06-03docs: Complete list of targets from i18n.gettext()TingPing
2017-04-29docs: Add data_dirs to i18n.merge_file()Patrick Griffis
2017-04-26docs: Import the website and wiki and build with hotdocThibault Saunier
This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it.