Next: ngettext Invocation, Previous: gettext.sh, Up: sh [Contents][Index]
gettext
program
gettext [option] [[textdomain] msgid] gettext [option] -s [msgid]...
The gettext
program displays the native language translation of a
textual message.
Arguments
-c context
’--context=context
’
Specify the context for the messages to be translated. See Contexts for details.
-d textdomain
’--domain=textdomain
’
Retrieve translated messages from textdomain
. Usually a textdomain
corresponds to a package, a program, or a module of a program.
-e
’
Enable expansion of some escape sequences. This option is for compatibility
with the ‘echo
’ program or shell built-in. The escape sequences
‘\a
’, ‘\b
’, ‘\c
’, ‘\f
’, ‘\n
’, ‘\r
’, ‘\t
’,
‘\v
’, ‘\\
’, and ‘\
’ followed by one to three octal digits, are
interpreted like the System V ‘echo
’ program did.
-E
’
This option is only for compatibility with the ‘echo
’ program or shell
built-in. It has no effect.
-h
’--help
’
Display this help and exit.
-n
’
This option has only an effect if the -s
option is given. It
suppresses the additional newline at the end.
-V
’--version
’
Output version information and exit.
[textdomain] msgid
’Retrieve translated message corresponding to msgid
from textdomain
.
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. Also, a newline is
added at the end, unless either the option -n
is specified or the
option -e
is specified and some of the argument strings contains a
‘\c
’ escape sequence.
Note: xgettext
supports only the one-argument form of the
gettext
invocation, where no options are present and the
textdomain
is implicit, from the environment.
Next: ngettext Invocation, Previous: gettext.sh, Up: sh [Contents][Index]