From: Bruno Haible Date: Mon, 17 Feb 2003 19:47:07 +0000 (+0000) Subject: Obsolete autogenerated files. X-Git-Tag: v0.12~255 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=370d9e442894b29b7c3402242641ab040b00bef1;p=thirdparty%2Fgettext.git Obsolete autogenerated files. --- diff --git a/man/autopoint.1 b/man/autopoint.1 deleted file mode 100644 index dfeeadf96..000000000 --- a/man/autopoint.1 +++ /dev/null @@ -1,45 +0,0 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.24. -.TH AUTOPOINT "1" "January 2003" "GNU gettext 0.11.6-pre2" GNU -.SH NAME -autopoint \- copies standard gettext infrastructure -.SH SYNOPSIS -.B autopoint -[\fIOPTION\fR]... -.SH DESCRIPTION -.\" Add any additional description here -.PP -Copies standard gettext infrastructure files into a source package. -.SH OPTIONS -.TP -\fB\-\-help\fR -print this help and exit -.TP -\fB\-\-version\fR -print version information and exit -.TP -\fB\-f\fR, \fB\-\-force\fR -force overwriting of files that already exist -.TP -\fB\-n\fR, \fB\-\-dry\-run\fR -print modifications but don't perform them -.SH AUTHOR -Written by Bruno Haible -.SH "REPORTING BUGS" -Report bugs to . -.SH COPYRIGHT -Copyright \(co 2002 Free Software Foundation, Inc. -.br -This is free software; see the source for copying conditions. There is NO -warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. -.SH "SEE ALSO" -The full documentation for -.B autopoint -is maintained as a Texinfo manual. If the -.B info -and -.B autopoint -programs are properly installed at your site, the command -.IP -.B info autopoint -.PP -should give you access to the complete manual. diff --git a/man/autopoint.1.html b/man/autopoint.1.html deleted file mode 100644 index 79097bb75..000000000 --- a/man/autopoint.1.html +++ /dev/null @@ -1,148 +0,0 @@ - - - - -AUTOPOINT - - - -

AUTOPOINT

-NAME
-SYNOPSIS
-DESCRIPTION
-OPTIONS
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-autopoint - copies standard gettext infrastructure

- -

SYNOPSIS

- - - -

-autopoint [OPTION]...

- -

DESCRIPTION

- - - -

-Copies standard gettext infrastructure files into a source -package.

- -

OPTIONS

- - - -

---help

- - - -

-print this help and exit

- - - -

---version

- - - -

-print version information and exit

- - - -

--f, --force

- - - -

-force overwriting of files that already exist

- - - -

--n, --dry-run

- - - -

-print modifications but don't perform them

- -

AUTHOR

- - - -

-Written by Bruno Haible

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

-Copyright 2002 Free Software Foundation, Inc.
-This is free software; see the source for copying -conditions. There is NO warranty; not even for -MERCHANTABILITY or FITNESS FOR A PARTICULAR -PURPOSE.

- -

BIND_TEXTDOMAIN_CODESET

-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-BUGS
-SEE ALSO
- -

- - - -

NAME

- - -

-bind_textdomain_codeset - set encoding of message translations

- -

SYNOPSIS

- - - -

#include <libintl.h>
-
-char * bind_textdomain_codeset (const char * domainname,
-                                const char * codeset);
-

- -

DESCRIPTION

- - - -

-The bind_textdomain_codeset function sets the output -codeset for message catalogs for domain -domainname.

- - - -

-A message domain is a set of translatable msgid -messages. Usually, every software package has its own -message domain.

- - - -

-By default, the gettext family of functions returns -translated messages in the locale's character encoding, -which can be retrieved as nl_langinfo(CODESET). The -need for calling bind_textdomain_codeset arises for -programs which store strings in a locale independent way -(e.g. UTF-8) and want to avoid an extra character set -conversion on the returned translated messages.

- - - -

-domainname must be a non-empty string.

- - - -

-If codeset is not NULL, it must be a valid encoding -name which can be used for the iconv_open function. -The bind_textdomain_codeset function sets the output -codeset for message catalogs belonging to domain -domainname to codeset. The function makes -copies of the argument strings as needed.

- - - -

-If codeset is NULL, the function returns the -previously set codeset for domain domainname. The -default is NULL, denoting the locale's character -encoding.

- -

RETURN VALUE

- - - -

-If successful, the bind_textdomain_codeset function -returns the current codeset for domain domainname, -after possibly changing it. The resulting string is valid -until the next bind_textdomain_codeset call for the -same domainname and must not be modified or freed. If -a memory allocation failure occurs, it sets errno to -ENOMEM and returns NULL. If no codeset has been set -for domain domainname, it returns NULL.

- -

ERRORS

- - - -

-The following error can occur, among others:

- - - -

-ENOMEM

- - - -

-Not enough memory available.

- -

BUGS

- - - -

-The return type ought to be const char *, but is -char * to avoid warnings in C code predating ANSI -C.

- -

BINDTEXTDOMAIN

-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-BUGS
-SEE ALSO
- -

- - - -

NAME

- - -

-bindtextdomain - set directory containing message catalogs

- -

SYNOPSIS

- - - -

#include <libintl.h>
-
-char * bindtextdomain (const char * domainname, const char * dirname);
-

- -

DESCRIPTION

- - - -

-The bindtextdomain function sets the base directory -of the hierarchy containing message catalogs for a given -message domain.

- - - -

-A message domain is a set of translatable msgid -messages. Usually, every software package has its own -message domain. The need for calling bindtextdomain -arises because packages are not always installed with the -same prefix as the <libintl.h> header and the -libc/libintl libraries.

- - - -

-Message catalogs will be expected at the pathnames -dirname/locale/category/domainname.mo, -where locale is a locale name and category is -a locale facet such as LC_MESSAGES.

- - - -

-domainname must be a non-empty string.

- - - -

-If dirname is not NULL, the base directory for -message catalogs belonging to domain domainname is -set to dirname. The function makes copies of the -argument strings as needed. If the program wishes to call -the chdir function, it is important that -dirname be an absolute pathname; otherwise it cannot -be guaranteed that the message catalogs will be -found.

- - - -

-If dirname is NULL, the function returns the -previously set base directory for domain -domainname.

- -

RETURN VALUE

- - - -

-If successful, the bindtextdomain function returns -the current base directory for domain domainname, -after possibly changing it. The resulting string is valid -until the next bindtextdomain call for the same -domainname and must not be modified or freed. If a -memory allocation failure occurs, it sets errno to -ENOMEM and returns NULL.

- -

ERRORS

- - - -

-The following error can occur, among others:

- - - -

-ENOMEM

- - - -

-Not enough memory available.

- -

BUGS

- - - -

-The return type ought to be const char *, but is -char * to avoid warnings in C code predating ANSI -C.

- -

GETTEXT

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-gettext - translate message

- -

SYNOPSIS

- - - -

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

- -

DESCRIPTION

- - - -

-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.

- - - -

--d, --domain=TEXTDOMAIN

- - - -

-retrieve translated messages from TEXTDOMAIN

- - - -

--e

- - - -

-enable expansion of some escape sequences

- - - -

--E

- - - -

-(ignored for compatibility)

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--n

- - - -

-suppress trailing newline

- - - -

--V, --version

- - - -

-display 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. Standard -search directory: @localedir@

- -

AUTHOR

- - - -

-Written by Ulrich Drepper.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

-Copyright 1995-1997, 2000, 2001 Free Software Foundation, -Inc.
-This is free software; see the source for copying -conditions. There is NO warranty; not even for -MERCHANTABILITY or FITNESS FOR A PARTICULAR -PURPOSE.

- -

GETTEXT

-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-BUGS
-SEE ALSO
- -

- - - -

NAME

- - -

-gettext, dgettext, dcgettext - translate message

- -

SYNOPSIS

- - - -

#include <libintl.h>
-
-char * gettext (const char * msgid);
-char * dgettext (const char * domainname, const char * msgid);
-char * dcgettext (const char * domainname, const char * msgid,
-                  int category);
-

- -

DESCRIPTION

- - - -

-The gettext, dgettext and dcgettext -functions attempt to translate a text string into the user's -native language, by looking up the translation in a message -catalog.

- - - -

-The msgid argument identifies the message to be -translated. By convention, it is the English version of the -message, with non-ASCII characters replaced by ASCII -approximations. This choice allows the translators to work -with message catalogs, called PO files, that contain both -the English and the translated versions of each message, and -can be installed using the msgfmt -utility.

- - - -

-A message domain is a set of translatable msgid -messages. Usually, every software package has its own -message domain. The domain name is used to determine the -message catalog where the translation is looked up; it must -be a non-empty string. For the gettext function, it -is specified through a preceding textdomain call. For -the dgettext and dcgettext functions, it is -passed as the domainname argument; if this argument -is NULL, the domain name specified through a preceding -textdomain call is used instead.

- - - -

-Translation lookup operates in the context of the current -locale. For the gettext and dgettext -functions, the LC_MESSAGES locale facet is used. It -is determined by a preceding call to the setlocale -function. setlocale(LC_ALL,"") initializes -the LC_MESSAGES locale based on the first nonempty -value of the three environment variables LC_ALL, -LC_MESSAGES, LANG; see setlocale(3). -For the dcgettext function, the locale facet is -determined by the category argument, which should be -one of the LC_xxx constants defined in the -<locale.h> header, excluding LC_ALL. In both -cases, the functions also use the LC_CTYPE locale -facet in order to convert the translated message from the -translator's codeset to the current locale's codeset, unless -overridden by a prior call to the -bind_textdomain_codeset function.

- - - -

-The message catalog used by the functions is at the pathname -dirname/locale/category/domainname.mo. -Here dirname is the directory specified through -bindtextdomain. Its default is system and -configuration dependent; typically it is -prefix/share/locale, where prefix is the -installation prefix of the package. locale is the -name of the current locale facet; the GNU implementation -also tries generalizations, such as the language name -without the territory name. category is -LC_MESSAGES for the gettext and -dgettext functions, or the argument passed to the -dcgettext function.

- - - -

-If the LANGUAGE environment variable is set to a -nonempty value, and the locale is not the "C" -locale, the value of LANGUAGE is assumed to contain a -colon separated list of locale names. The functions will -attempt to look up a translation of msgid in each of -the locales in turn. This is a GNU extension.

- - - -

-In the "C" locale, or if none of the used catalogs -contain a translation for msgid, the gettext, -dgettext and dcgettext functions return -msgid.

- -

RETURN VALUE

- - - -

-If a translation was found in one of the specified catalogs, -it is converted to the locale's codeset and returned. The -resulting string is statically allocated and must not be -modified or freed. Otherwise msgid is -returned.

- -

ERRORS

- - - -

-errno is not modified.

- -

BUGS

- - - -

-The return type ought to be const char *, but is -char * to avoid warnings in C code predating ANSI -C.

- - - -

-When an empty string is used for msgid, the functions -may return a nonempty string.

- -

GETTEXTIZE

-NAME
-SYNOPSIS
-DESCRIPTION
-OPTIONS
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-gettextize - install or upgrade gettext infrastructure

- -

SYNOPSIS

- - - -

-gettextize [OPTION]... -[package-dir]

- -

DESCRIPTION

- - - -

-Prepares a source package to use gettext.

- -

OPTIONS

- - - -

---help

- - - -

-print this help and exit

- - - -

---version

- - - -

-print version information and exit

- - - -

--c, --copy

- - - -

-copy files instead of making symlinks

- - - -

--f, --force

- - - -

-force writing of new files even if old exist

- - - -

---intl

- - - -

-install libintl in a subdirectory

- - - -

---no-changelog

- - - -

-don't update or create ChangeLog files

- - - -

--n, --dry-run

- - - -

-print modifications but don't perform them

- -

AUTHOR

- - - -

-Written by Ulrich Drepper

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

-Copyright 1995-1998, 2000-2002 Free Software Foundation, -Inc.
-This is free software; see the source for copying -conditions. There is NO warranty; not even for -MERCHANTABILITY or FITNESS FOR A PARTICULAR -PURPOSE.

- -

MSGATTRIB

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgattrib - attribute matching and manipulation on message catalog

- -

SYNOPSIS

- - - -

-msgattrib [OPTION] -[INPUTFILE]

- -

DESCRIPTION

- - - -

-Filters the messages of a translation catalog according to -their attributes, and manipulates the -attributes.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

-INPUTFILE

- - - -

-input PO file

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If no input file is given or if it is -, standard input is -read.

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

-The results are written to standard output if no output file -is specified or if it is -.

- - - -

-Message selection:

- - - -

---translated

- - - -

-keep translated, remove untranslated messages

- - - -

---untranslated

- - - -

-keep untranslated, remove translated messages

- - - -

---no-fuzzy

- - - -

-remove 'fuzzy' marked messages

- - - -

---only-fuzzy

- - - -

-keep 'fuzzy' marked messages

- - - -

---no-obsolete

- - - -

-remove obsolete #~ messages

- - - -

---only-obsolete

- - - -

-keep obsolete #~ messages

- - - -

-Attribute manipulation:

- - - -

---set-fuzzy

- - - -

-set all messages 'fuzzy'

- - - -

---clear-fuzzy

- - - -

-set all messages non-'fuzzy'

- - - -

---set-obsolete

- - - -

-set all messages obsolete

- - - -

---clear-obsolete

- - - -

-set all messages non-obsolete

- - - -

---fuzzy

- - - -

-synonym for --only-fuzzy --clear-fuzzy

- - - -

---obsolete

- - - -

-synonym for --only-obsolete ---clear-obsolete

- - - -

-Output details:

- - - -

--e, --no-escape

- - - -

-do not use C escapes in output (default)

- - - -

--E, --escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

--i, --indent

- - - -

-write the .po file using indented style

- - - -

---no-location

- - - -

-do not write '#: filename:line' lines

- - - -

--n, --add-location

- - - -

-generate '#: filename:line' lines (default)

- - - -

---strict

- - - -

-write out strict Uniforum conforming .po file

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

--s, --sort-output

- - - -

-generate sorted output

- - - -

--F, --sort-by-file

- - - -

-sort output by file location

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Bruno Haible.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

-Copyright 2001-2002 Free Software Foundation, Inc.
-This is free software; see the source for copying -conditions. There is NO warranty; not even for -MERCHANTABILITY or FITNESS FOR A PARTICULAR -PURPOSE.

- -

MSGCAT

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgcat - combines several message catalogs

- -

SYNOPSIS

- - - -

-msgcat [OPTION] -[INPUTFILE]...

- -

DESCRIPTION

- - - -

-Concatenates and merges the specified PO files. Find -messages which are common to two or more of the specified PO -files. By using the --more-than option, greater -commonality may be requested before messages are printed. -Conversely, the --less-than option may be used to -specify less commonality before messages are printed (i.e. ---less-than=2 will only print the unique -messages). Translations, comments and extract comments will -be cumulated, except that if --use-first is -specified, they will be taken from the first PO file to -define them. File positions from all PO files will be -cumulated.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

-INPUTFILE ...

- - - -

-input files

- - - -

--f, --files-from=FILE

- - - -

-get list of input files from FILE

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If input file is -, standard input is read.

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

-The results are written to standard output if no output file -is specified or if it is -.

- - - -

-Message selection:

- - - -

--<, --less-than=NUMBER

- - - -

-print messages with less than this many definitions, -defaults to infinite if not set

- - - -

-->, --more-than=NUMBER

- - - -

-print messages with more than this many definitions, -defaults to 0 if not set

- - - -

--u, --unique

- - - -

-shorthand for --less-than=2, requests that -only unique messages be printed

- - - -

-Output details:

- - - -

--t, --to-code=NAME

- - - -

-encoding for output

- - - -

---use-first

- - - -

-use first available translation for each message, don't -merge several translations

- - - -

--e, --no-escape

- - - -

-do not use C escapes in output (default)

- - - -

--E, --escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

--i, --indent

- - - -

-write the .po file using indented style

- - - -

---no-location

- - - -

-do not write '#: filename:line' lines

- - - -

--n, --add-location

- - - -

-generate '#: filename:line' lines (default)

- - - -

---strict

- - - -

-write out strict Uniforum conforming .po file

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

--s, --sort-output

- - - -

-generate sorted output

- - - -

--F, --sort-by-file

- - - -

-sort output by file location

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Bruno Haible.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGCMP

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgcmp - compare message catalog and template

- -

SYNOPSIS

- - - -

-msgcmp [OPTION] def.po -ref.pot

- -

DESCRIPTION

- - - -

-Compare two Uniforum style .po files to check that both -contain the same set of msgid strings. The def.po file is an -existing PO file with the translations. The ref.pot file is -the last created PO file, or a PO Template file (generally -created by xgettext). This is useful for checking that you -have translated each and every message in your program. -Where an exact match cannot be found, fuzzy matching is used -to produce better diagnostics.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

-def.po

- - - -

-translations

- - - -

-ref.pot

- - - -

-references to the sources

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-Operation modifiers:

- - - -

--m, --multi-domain

- - - -

-apply ref.pot to each of the domains in def.po

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Peter Miller.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGCOMM

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgcomm - match two message catalogs

- -

SYNOPSIS

- - - -

-msgcomm [OPTION] -[INPUTFILE]...

- -

DESCRIPTION

- - - -

-Find messages which are common to two or more of the -specified PO files. By using the --more-than option, -greater commonality may be requested before messages are -printed. Conversely, the --less-than option may be -used to specify less commonality before messages are printed -(i.e. --less-than=2 will only print the unique -messages). Translations, comments and extract comments will -be preserved, but only from the first PO file to define -them. File positions from all PO files will be -cumulated.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

-INPUTFILE ...

- - - -

-input files

- - - -

--f, --files-from=FILE

- - - -

-get list of input files from FILE

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If input file is -, standard input is read.

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

-The results are written to standard output if no output file -is specified or if it is -.

- - - -

-Message selection:

- - - -

--<, --less-than=NUMBER

- - - -

-print messages with less than this many definitions, -defaults to infinite if not set

- - - -

-->, --more-than=NUMBER

- - - -

-print messages with more than this many definitions, -defaults to 1 if not set

- - - -

--u, --unique

- - - -

-shorthand for --less-than=2, requests that -only unique messages be printed

- - - -

-Output details:

- - - -

--e, --no-escape

- - - -

-do not use C escapes in output (default)

- - - -

--E, --escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

--i, --indent

- - - -

-write the .po file using indented style

- - - -

---no-location

- - - -

-do not write '#: filename:line' lines

- - - -

--n, --add-location

- - - -

-generate '#: filename:line' lines (default)

- - - -

---strict

- - - -

-write out strict Uniforum conforming .po file

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

--s, --sort-output

- - - -

-generate sorted output

- - - -

--F, --sort-by-file

- - - -

-sort output by file location

- - - -

---omit-header

- - - -

-don't write header with `msgid ""' -entry

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Peter Miller.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGCONV

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgconv - character set conversion for message catalog

- -

SYNOPSIS

- - - -

-msgconv [OPTION] -[INPUTFILE]

- -

DESCRIPTION

- - - -

-Converts a translation catalog to a different character -encoding.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

-INPUTFILE

- - - -

-input PO file

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If no input file is given or if it is -, standard input is -read.

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

-The results are written to standard output if no output file -is specified or if it is -.

- - - -

-Conversion target:

- - - -

--t, --to-code=NAME

- - - -

-encoding for output

- - - -

-The default encoding is the current locale's -encoding.

- - - -

-Output details:

- - - -

--e, --no-escape

- - - -

-do not use C escapes in output (default)

- - - -

--E, --escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

--i, --indent

- - - -

-indented output style

- - - -

---no-location

- - - -

-suppress '#: filename:line' lines

- - - -

---add-location

- - - -

-preserve '#: filename:line' lines (default)

- - - -

---strict

- - - -

-strict Uniforum output style

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

--s, --sort-output

- - - -

-generate sorted output

- - - -

--F, --sort-by-file

- - - -

-sort output by file location

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Bruno Haible.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGEN

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgen - create English message catalog

- -

SYNOPSIS

- - - -

-msgen [OPTION] INPUTFILE

- -

DESCRIPTION

- - - -

-Creates an English translation catalog. The input file is -the last created English PO file, or a PO Template file -(generally created by xgettext). Untranslated entries are -assigned a translation that is identical to the msgid, and -are marked fuzzy.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

-INPUTFILE

- - - -

-input PO or POT file

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If input file is -, standard input is read.

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

-The results are written to standard output if no output file -is specified or if it is -.

- - - -

-Output details:

- - - -

--e, --no-escape

- - - -

-do not use C escapes in output (default)

- - - -

--E, --escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

--i, --indent

- - - -

-indented output style

- - - -

---no-location

- - - -

-suppress '#: filename:line' lines

- - - -

---add-location

- - - -

-preserve '#: filename:line' lines (default)

- - - -

---strict

- - - -

-strict Uniforum output style

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

--s, --sort-output

- - - -

-generate sorted output

- - - -

--F, --sort-by-file

- - - -

-sort output by file location

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Bruno Haible.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGEXEC

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgexec - process translations of message catalog

- -

SYNOPSIS

- - - -

-msgexec [OPTION] COMMAND -[COMMAND-OPTION]

- -

DESCRIPTION

- - - -

-Applies a command to all translations of a translation -catalog. The COMMAND can be any program that reads a -translation from standard input. It is invoked once for each -translation. Its output becomes msgexec's output. msgexec's -return code is the maximum return code across all -invocations.

- - - -

-A special builtin command called '0' outputs the -translation, followed by a null byte. The output of -"msgexec 0" is suitable as input for "xargs --0".

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

--i, --input=INPUTFILE

- - - -

-input PO file

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If no input file is given or if it is -, standard input is -read.

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Bruno Haible.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGFILTER

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgfilter - edit translations of message catalog

- -

SYNOPSIS

- - - -

-msgfilter [OPTION] FILTER -[FILTER-OPTION]

- -

DESCRIPTION

- - - -

-Applies a filter to all translations of a translation -catalog.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

--i, --input=INPUTFILE

- - - -

-input PO file

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If no input file is given or if it is -, standard input is -read.

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

-The results are written to standard output if no output file -is specified or if it is -.

- - - -

-The FILTER can be any program that reads a translation from -standard input and writes a modified translation to standard -output.

- - - -

-Useful FILTER-OPTIONs when the FILTER is -'sed':

- - - -

--e, --expression=SCRIPT

- - - -

-add SCRIPT to the commands to be executed

- - - -

--f, --file=SCRIPTFILE

- - - -

-add the contents of SCRIPTFILE to the commands to be -executed

- - - -

--n, --quiet, --silent

- - - -

-suppress automatic printing of pattern space

- - - -

-Output details:

- - - -

---no-escape

- - - -

-do not use C escapes in output (default)

- - - -

--E, --escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

---indent

- - - -

-indented output style

- - - -

---keep-header

- - - -

-keep header entry unmodified, don't filter it

- - - -

---no-location

- - - -

-suppress '#: filename:line' lines

- - - -

---add-location

- - - -

-preserve '#: filename:line' lines (default)

- - - -

---strict

- - - -

-strict Uniforum output style

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

--s, --sort-output

- - - -

-generate sorted output

- - - -

--F, --sort-by-file

- - - -

-sort output by file location

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Bruno Haible.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGFMT

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgfmt - compile message catalog to binary format

- -

SYNOPSIS

- - - -

-msgfmt [OPTION] filename.po -...

- -

DESCRIPTION

- - - -

-Generate binary message catalog from textual translation -description.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

-filename.po ...

- - - -

-input files

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If input file is -, standard input is read.

- - - -

-Operation mode:

- - - -

--j, --java

- - - -

-Java mode: generate a Java ResourceBundle class

- - - -

---java2

- - - -

-like --java, and assume Java2 (JDK 1.2 or -higher)

- - - -

---tcl

- - - -

-Tcl mode: generate a tcl/msgcat .msg file

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

---strict

- - - -

-enable strict Uniforum mode

- - - -

-If output file is -, output is written to standard -output.

- - - -

-Output file location in Java mode:

- - - -

--r, --resource=RESOURCE

- - - -

-resource name

- - - -

--l, --locale=LOCALE

- - - -

-locale name, either language or -language_COUNTRY

- - - -

--d DIRECTORY

- - - -

-base directory of classes directory hierarchy

- - - -

-The class name is determined by appending the locale name to -the resource name, separated with an underscore. The --d option is mandatory. The class is written under -the specified directory.

- - - -

-Output file location in Tcl mode:

- - - -

--l, --locale=LOCALE

- - - -

-locale name, either language or -language_COUNTRY

- - - -

--d DIRECTORY

- - - -

-base directory of .msg message catalogs

- - - -

-The -l and -d options are mandatory. The .msg -file is written in the specified directory.

- - - -

-Input file interpretation:

- - - -

--c, --check

- - - -

-perform all the checks implied by --check-format, ---check-header, --check-domain

- - - -

---check-format

- - - -

-check language dependent format strings

- - - -

---check-header

- - - -

-verify presence and contents of the header -entry

- - - -

---check-domain

- - - -

-check for conflicts between domain directives and the ---output-file option

- - - -

--C, --check-compatibility

- - - -

-check that GNU msgfmt behaves like X/Open -msgfmt

- - - -

---check-accelerators[=CHAR]

- - - -

-check presence of keyboard accelerators for menu -items

- - - -

--f, --use-fuzzy

- - - -

-use fuzzy entries in output

- - - -

-Output details:

- - - -

--a, --alignment=NUMBER

- - - -

-align strings to NUMBER bytes (default: 1)

- - - -

---no-hash

- - - -

-binary file will not include the hash table

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- - - -

---statistics

- - - -

-print statistics about translations

- - - -

--v, --verbose

- - - -

-increase verbosity level

- -

AUTHOR

- - - -

-Written by Ulrich Drepper.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGGREP

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msggrep - pattern matching on message catalog

- -

SYNOPSIS

- - - -

-msggrep [OPTION] -[INPUTFILE]

- -

DESCRIPTION

- - - -

-Extracts all messages of a translation catalog that match a -given pattern or belong to some given source -files.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

-INPUTFILE

- - - -

-input PO file

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If no input file is given or if it is -, standard input is -read.

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

-The results are written to standard output if no output file -is specified or if it is -.

- - - -

-Message selection:

- - - -

-[-N SOURCEFILE]... [-M DOMAINNAME]... [-K MSGID-PATTERN] [-T -MSGSTR-PATTERN] [-C COMMENT-PATTERN]

- - - -

-A message is selected if it comes from one of the specified -source files, or if it comes from one of the specified -domains, or if -K is given and its key (msgid or -msgid_plural) matches MSGID-PATTERN, or if -T is -given and its translation (msgstr) matches MSGSTR-PATTERN, -or if -C is given and the translator's comment -matches COMMENT-PATTERN.

- - - -

-When more than one selection criterion is specified, the set -of selected messages is the union of the selected messages -of each criterion.

- - - -

-MSGID-PATTERN or MSGSTR-PATTERN syntax:

- - - -

-[-E | -F] [-e PATTERN | -f -FILE]...

- - - -

-PATTERNs are basic regular expressions by default, or -extended regular expressions if -E is given, or fixed -strings if -F is given.

- - - -

--N, --location=SOURCEFILE

- - - -

-select messages extracted from SOURCEFILE

- - - -

--M, --domain=DOMAINNAME

- - - -

-select messages belonging to domain DOMAINNAME

- - - -

--K, --msgid

- - - -

-start of patterns for the msgid

- - - -

--T, --msgstr

- - - -

-start of patterns for the msgstr

- - - -

--E, --extended-regexp

- - - -

-PATTERN is an extended regular expression

- - - -

--F, --fixed-strings

- - - -

-PATTERN is a set of newline-separated strings

- - - -

--e, --regexp=PATTERN

- - - -

-use PATTERN as a regular expression

- - - -

--f, --file=FILE

- - - -

-obtain PATTERN from FILE

- - - -

--i, --ignore-case

- - - -

-ignore case distinctions

- - - -

-Output details:

- - - -

---no-escape

- - - -

-do not use C escapes in output (default)

- - - -

---escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

---indent

- - - -

-indented output style

- - - -

---no-location

- - - -

-suppress '#: filename:line' lines

- - - -

---add-location

- - - -

-preserve '#: filename:line' lines (default)

- - - -

---strict

- - - -

-strict Uniforum output style

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

---sort-output

- - - -

-generate sorted output

- - - -

---sort-by-file

- - - -

-sort output by file location

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Bruno Haible.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGINIT

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msginit - initialize a message catalog

- -

SYNOPSIS

- - - -

-msginit [OPTION]

- -

DESCRIPTION

- - - -

-Creates a new PO file, initializing the meta information -with values from the user's environment.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

--i, --input=INPUTFILE

- - - -

-input POT file

- - - -

-If no input file is given, the current directory is searched -for the POT file. If it is -, standard input is -read.

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified PO file

- - - -

-If no output file is given, it depends on the ---locale option or the user's locale setting. If it -is -, the results are written to standard -output.

- - - -

-Output details:

- - - -

--l, --locale=LL_CC

- - - -

-set target locale

- - - -

---no-translator

- - - -

-assume the PO file is automatically generated

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Bruno Haible.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGMERGE

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgmerge - merge message catalog and template

- -

SYNOPSIS

- - - -

-msgmerge [OPTION] def.po -ref.pot

- -

DESCRIPTION

- - - -

-Merges two Uniforum style .po files together. The def.po -file is an existing PO file with translations which will be -taken over to the newly created file as long as they still -match; comments will be preserved, but extracted comments -and file positions will be discarded. The ref.pot file is -the last created PO file with up-to-date source references -but old translations, or a PO Template file (generally -created by xgettext); any translations or comments in the -file will be discarded, however dot comments and file -positions will be preserved. Where an exact match cannot be -found, fuzzy matching is used to produce better -results.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

-def.po

- - - -

-translations referring to old sources

- - - -

-ref.pot

- - - -

-references to new sources

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

--C, --compendium=FILE

- - - -

-additional library of message translations, may be specified -more than once

- - - -

-Operation mode:

- - - -

--U, --update

- - - -

-update def.po, do nothing if def.po already up to -date

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

-The results are written to standard output if no output file -is specified or if it is -.

- - - -

-Output file location in update mode: The result is written -back to def.po.

- - - -

---backup=CONTROL

- - - -

-make a backup of def.po

- - - -

---suffix=SUFFIX

- - - -

-override the usual backup suffix

- - - -

-The version control method may be selected via the ---backup option or through the VERSION_CONTROL -environment variable. Here are the values:

- - - -

-none, off

- - - -

-never make backups (even if --backup is -given)

- - - -

-numbered, t

- - - -

-make numbered backups

- - - -

-existing, nil

- - - -

-numbered if numbered backups exist, simple -otherwise

- - - -

-simple, never

- - - -

-always make simple backups

- - - -

-The backup suffix is `~', unless set with --suffix or -the SIMPLE_BACKUP_SUFFIX environment variable.

- - - -

-Operation modifiers:

- - - -

--m, --multi-domain

- - - -

-apply ref.pot to each of the domains in def.po

- - - -

-Output details:

- - - -

--e, --no-escape

- - - -

-do not use C escapes in output (default)

- - - -

--E, --escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

--i, --indent

- - - -

-indented output style

- - - -

---no-location

- - - -

-suppress '#: filename:line' lines

- - - -

---add-location

- - - -

-preserve '#: filename:line' lines (default)

- - - -

---strict

- - - -

-strict Uniforum output style

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

--s, --sort-output

- - - -

-generate sorted output

- - - -

--F, --sort-by-file

- - - -

-sort output by file location

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- - - -

--v, --verbose

- - - -

-increase verbosity level

- - - -

--q, --quiet, --silent

- - - -

-suppress progress indicators

- -

AUTHOR

- - - -

-Written by Peter Miller.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGUNFMT

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msgunfmt - uncompile message catalog from binary format

- -

SYNOPSIS

- - - -

-msgunfmt [OPTION] -[FILE]...

- -

DESCRIPTION

- - - -

-Convert binary message catalog to Uniforum style .po -file.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Operation mode:

- - - -

--j, --java

- - - -

-Java mode: input is a Java ResourceBundle class

- - - -

---tcl

- - - -

-Tcl mode: input is a tcl/msgcat .msg file

- - - -

-Input file location:

- - - -

-FILE ...

- - - -

-input .mo files

- - - -

-If no input file is given or if it is -, standard input is -read.

- - - -

-Input file location in Java mode:

- - - -

--r, --resource=RESOURCE

- - - -

-resource name

- - - -

--l, --locale=LOCALE

- - - -

-locale name, either language or -language_COUNTRY

- - - -

-The class name is determined by appending the locale name to -the resource name, separated with an underscore. The class -is located using the CLASSPATH.

- - - -

-Input file location in Tcl mode:

- - - -

--l, --locale=LOCALE

- - - -

-locale name, either language or -language_COUNTRY

- - - -

--d DIRECTORY

- - - -

-base directory of .msg message catalogs

- - - -

-The -l and -d options are mandatory. The .msg -file is located in the specified directory.

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

-The results are written to standard output if no output file -is specified or if it is -.

- - - -

-Output details:

- - - -

--e, --no-escape

- - - -

-do not use C escapes in output (default)

- - - -

--E, --escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

--i, --indent

- - - -

-write indented output style

- - - -

---strict

- - - -

-write strict uniforum style

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

--s, --sort-output

- - - -

-generate sorted output

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- - - -

--v, --verbose

- - - -

-increase verbosity level

- -

AUTHOR

- - - -

-Written by Ulrich Drepper.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

MSGUNIQ

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-msguniq - unify duplicate translations in message catalog

- -

SYNOPSIS

- - - -

-msguniq [OPTION] -[INPUTFILE]

- -

DESCRIPTION

- - - -

-Unifies duplicate translations in a translation catalog. -Finds duplicate translations of the same message ID. Such -duplicates are invalid input for other programs like msgfmt, -msgmerge or msgcat. By default, duplicates are merged -together. When using the --repeated option, only -duplicates are output, and all other messages are discarded. -Comments and extracted comments will be cumulated, except -that if --use-first is specified, they will be taken -from the first translation. File positions will be -cumulated. When using the --unique option, duplicates -are discarded.

- - - -

-Mandatory arguments to long options are mandatory for short -options too.

- - - -

-Input file location:

- - - -

-INPUTFILE

- - - -

-input PO file

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If no input file is given or if it is -, standard input is -read.

- - - -

-Output file location:

- - - -

--o, --output-file=FILE

- - - -

-write output to specified file

- - - -

-The results are written to standard output if no output file -is specified or if it is -.

- - - -

-Message selection:

- - - -

--d, --repeated

- - - -

-print only duplicates

- - - -

--u, --unique

- - - -

-print only unique messages, discard duplicates

- - - -

-Output details:

- - - -

--t, --to-code=NAME

- - - -

-encoding for output

- - - -

---use-first

- - - -

-use first available translation for each message, don't -merge several translations

- - - -

--e, --no-escape

- - - -

-do not use C escapes in output (default)

- - - -

--E, --escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

--i, --indent

- - - -

-write the .po file using indented style

- - - -

---no-location

- - - -

-do not write '#: filename:line' lines

- - - -

--n, --add-location

- - - -

-generate '#: filename:line' lines (default)

- - - -

---strict

- - - -

-write out strict Uniforum conforming .po file

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

--s, --sort-output

- - - -

-generate sorted output

- - - -

--F, --sort-by-file

- - - -

-sort output by file location

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Bruno Haible.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

NGETTEXT

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-ngettext - translate message and choose plural form

- -

SYNOPSIS

- - - -

-ngettext [OPTION] [TEXTDOMAIN] MSGID -MSGID-PLURAL COUNT

- -

DESCRIPTION

- - - -

-The ngettext program translates a natural language -message into the user's language, by looking up the -translation in a message catalog, and chooses the -appropriate plural form, which depends on the number -COUNT and the language of the message catalog where -the translation was found.

- - - -

-Display native language translation of a textual message -whose grammatical form depends on a number.

- - - -

--d, --domain=TEXTDOMAIN

- - - -

-retrieve translated message from TEXTDOMAIN

- - - -

--e

- - - -

-enable expansion of some escape sequences

- - - -

--E

- - - -

-(ignored for compatibility)

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-display version information and exit

- - - -

-[TEXTDOMAIN]

- - - -

-retrieve translated message from TEXTDOMAIN

- - - -

-MSGID MSGID-PLURAL

- - - -

-translate MSGID (singular) / MSGID-PLURAL -(plural)

- - - -

-COUNT

- - - -

-choose singular/plural form based on this value

- - - -

- -

AUTHOR

- - - -

-Written by Ulrich Drepper.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -

NGETTEXT

-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-BUGS
-SEE ALSO
- -

- - - -

NAME

- - -

-ngettext, dngettext, dcngettext - translate message and choose plural form

- -

SYNOPSIS

- - - -

#include <libintl.h>
-
-char * ngettext (const char * msgid, const char * msgid_plural,
-                 unsigned long int n);
-char * dngettext (const char * domainname,
-                  const char * msgid, const char * msgid_plural,
-                  unsigned long int n);
-char * dcngettext (const char * domainname,
-                   const char * msgid, const char * msgid_plural,
-                   unsigned long int n, int category);
-

- -

DESCRIPTION

- - - -

-The ngettext, dngettext and dcngettext -functions attempt to translate a text string into the user's -native language, by looking up the appropriate plural form -of the translation in a message catalog.

- - - -

-Plural forms are grammatical variants depending on the a -number. Some languages have two forms, called singular and -plural. Other languages have three forms, called singular, -dual and plural. There are also languages with four -forms.

- - - -

-The ngettext, dngettext and dcngettext -functions work like the gettext, dgettext and -dcgettext functions, respectively. Additionally, they -choose the appropriate plural form, which depends on the -number n and the language of the message catalog -where the translation was found.

- - - -

-In the "C" locale, or if none of the used catalogs -contain a translation for msgid, the ngettext, -dngettext and dcngettext functions return -msgid if n == 1, or msgid_plural if -n != 1.

- -

RETURN VALUE

- - - -

-If a translation was found in one of the specified catalogs, -the appropriate plural form is converted to the locale's -codeset and returned. The resulting string is statically -allocated and must not be modified or freed. Otherwise -msgid or msgid_plural is returned, as -described above.

- -

ERRORS

- - - -

-errno is not modified.

- -

BUGS

- - - -

-The return type ought to be const char *, but is -char * to avoid warnings in C code predating ANSI -C.

- -

TEXTDOMAIN

-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-BUGS
-SEE ALSO
- -

- - - -

NAME

- - -

-textdomain - set domain for future gettext() calls

- -

SYNOPSIS

- - - -

#include <libintl.h>
-
-char * textdomain (const char * domainname);
-

- -

DESCRIPTION

- - - -

-The textdomain function sets or retrieves the current -message domain.

- - - -

-The current message domain is used by the gettext, -ngettext functions, and by the dgettext, -dcgettext, dngettext and dcngettext -functions when called with a NULL domainname -argument.

- - - -

-If domainname is not NULL, the current message domain -is set to domainname. The string the function stores -internally is a copy of the domainname -argument.

- - - -

-If domainname is NULL, the function returns the -current message domain.

- -

RETURN VALUE

- - - -

-If successful, the textdomain function returns the -current message domain, after possibly changing it. The -resulting string is valid until the next textdomain -call and must not be modified or freed. If a memory -allocation failure occurs, it sets errno to -ENOMEM and returns NULL.

- -

ERRORS

- - - -

-The following error can occur, among others:

- - - -

-ENOMEM

- - - -

-Not enough memory available.

- -

BUGS

- - - -

-The return type ought to be const char *, but is -char * to avoid warnings in C code predating ANSI -C.

- -

XGETTEXT

-NAME
-SYNOPSIS
-DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
- -

- - -

NAME

- - -

-xgettext - extract gettext strings from source

- -

SYNOPSIS

- - - -

-xgettext [OPTION] -[INPUTFILE]...

- -

DESCRIPTION

- - - -

-Extract translatable strings from given input -files.

- - - -

-Mandatory arguments to long options are mandatory for short -options too. Similarly for optional arguments.

- - - -

-Input file location:

- - - -

-INPUTFILE ...

- - - -

-input files

- - - -

--f, --files-from=FILE

- - - -

-get list of input files from FILE

- - - -

--D, --directory=DIRECTORY

- - - -

-add DIRECTORY to list for input files search

- - - -

-If input file is -, standard input is read.

- - - -

-Output file location:

- - - -

--d, --default-domain=NAME

- - - -

-use NAME.po for output (instead of messages.po)

- - - -

--o, --output=FILE

- - - -

-write output to specified file

- - - -

--p, --output-dir=DIR

- - - -

-output files will be placed in directory DIR

- - - -

-If output file is -, output is written to standard -output.

- - - -

-Choice of input file language:

- - - -

--L, --language=NAME

- - - -

-recognise the specified language (C, C++, ObjectiveC, PO, -Python, Lisp, EmacsLisp, librep, Smalltalk, Java, awk, YCP, -Tcl, PHP, RST, Glade)

- - - -

--C, --c++

- - - -

-shorthand for --language=C++

- - - -

-By default the language is guessed depending on the input -file name extension.

- - - -

-Input file interpretation:

- - - -

---from-code=NAME

- - - -

-encoding of input files (except for Python, Tcl, -Glade)

- - - -

-By default the input files are assumed to be in -ASCII.

- - - -

-Operation mode:

- - - -

--j, --join-existing

- - - -

-join messages with existing file

- - - -

--x, --exclude-file=FILE.po

- - - -

-entries from FILE.po are not extracted

- - - -

--c, --add-comments[=TAG]

- - - -

-place comment block with TAG (or those preceding keyword -lines) in output file

- - - -

-Language=C/C++ specific options:

- - - -

--a, --extract-all

- - - -

-extract all strings

- - - -

--k, --keyword[=WORD]

- - - -

-additional keyword to be looked for (without WORD means not -to use default keywords)

- - - -

--T, --trigraphs

- - - -

-understand ANSI C trigraphs for input

- - - -

---debug

- - - -

-more detailed formatstring recognition result

- - - -

-Output details:

- - - -

--e, --no-escape

- - - -

-do not use C escapes in output (default)

- - - -

--E, --escape

- - - -

-use C escapes in output, no extended chars

- - - -

---force-po

- - - -

-write PO file even if empty

- - - -

--i, --indent

- - - -

-write the .po file using indented style

- - - -

---no-location

- - - -

-do not write '#: filename:line' lines

- - - -

--n, --add-location

- - - -

-generate '#: filename:line' lines (default)

- - - -

---strict

- - - -

-write out strict Uniforum conforming .po file

- - - -

--w, --width=NUMBER

- - - -

-set output page width

- - - -

---no-wrap

- - - -

-do not break long message lines, longer than the output page -width, into several lines

- - - -

--s, --sort-output

- - - -

-generate sorted output

- - - -

--F, --sort-by-file

- - - -

-sort output by file location

- - - -

---omit-header

- - - -

-don't write header with `msgid ""' -entry

- - - -

---copyright-holder=STRING

- - - -

-set copyright holder in output

- - - -

---foreign-user

- - - -

-omit FSF copyright in output for foreign user

- - - -

--m, ---msgstr-prefix[=STRING]

- - - -

-use STRING or "" as prefix for msgstr -entries

- - - -

--M, ---msgstr-suffix[=STRING]

- - - -

-use STRING or "" as suffix for msgstr -entries

- - - -

-Informative output:

- - - -

--h, --help

- - - -

-display this help and exit

- - - -

--V, --version

- - - -

-output version information and exit

- -

AUTHOR

- - - -

-Written by Ulrich Drepper.

- -

REPORTING BUGS

- - - -

-Report bugs to <bug-gnu-gettext@gnu.org>.

- -

COPYRIGHT

- - - -

- -