gettext(1)

gettext1

Translate message

Usage

gettext [OPTION] [[TEXTDOMAIN] MSGID]

gettext [OPTION] -s [MSGID] ...

Overview

The gettext program translates a natural language message into the user's language, by looking up the translation in a message catalog.

Display native language translation of a textual message.

Options and arguments:

-d, --domain=TEXTDOMAIN

retrieve translated messages from TEXTDOMAIN

-c, --context=CONTEXT

specify context for MSGID

-e

enable expansion of some escape sequences

-n

suppress trailing newline

-E

(ignored for compatibility)

[TEXTDOMAIN] MSGID

retrieve translated message corresponding to MSGID from TEXTDOMAIN

Informative output:

-h, --help

display this help and exit

-V, --version

display version information and exit

If the TEXTDOMAIN parameter is not given, the domain is determined from the environment variable TEXTDOMAIN. If the message catalog is not found in the regular directory, another location can be specified with the environment variable TEXTDOMAINDIR. When used with the -s option the program behaves like the 'echo' command. But it does not simply copy its arguments to stdout. Instead those messages found in the selected catalog are translated. Standard search directory: /usr/share/locale

Releases

15 releases since Debian 2.1 (Slink); the text changed 12 times.

  1. 2.1
  2. 2.2
  3. 3.0
  4. 3.1
  5. 4.0
  6. 5.0
  7. 6.0–7
  8. 8
  9. 9–10
  10. 11
  11. 12
  12. 13
  13. Arch

--context since Debian 11 (Bullseye); --domain since Debian 3.0 (Woody); --help since Debian 3.0 (Woody); --version since Debian 3.0 (Woody); -E since Debian 3.0 (Woody); -V since Debian 3.0 (Woody); -c since Debian 11 (Bullseye); -d since Debian 3.0 (Woody); -e since Debian 3.0 (Woody); -h since Debian 3.0 (Woody); -n since Debian 3.0 (Woody).

Author

Written by Ulrich Drepper.

Reporting bugs

Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext> or by email to <[email protected]>.

From gettext 1.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.