mirror of
https://https.git.savannah.gnu.org/git/gettext.git
synced 2026-01-27 01:44:30 +00:00
Add indices.
This commit is contained in:
Bruno Haible
parent
e54357669b
commit
1e8c890ff2
@ -1,3 +1,10 @@
|
||||
2002-02-03 Eli Zaretskii <eliz@is.elta.co.il>
|
||||
Bruno Haible <bruno@clisp.org>
|
||||
|
||||
* gettext.texi: Add indices and many index entries.
|
||||
* msg*.texi, xgettext.texi: Add many index entries.
|
||||
* Makefile.am (MOSTLYCLEANFILES): New variable.
|
||||
|
||||
2002-02-02 Bruno Haible <bruno@clisp.org>
|
||||
|
||||
* gettext.texi (Creating Compendia): Use @samp instead of @command or
|
||||
|
||||
530
doc/gettext.texi
530
doc/gettext.texi
File diff suppressed because it is too large
Load Diff
@ -1,7 +1,11 @@
|
||||
@pindex msgattrib
|
||||
@cindex @code{msgattrib} program, usage
|
||||
@example
|
||||
msgattrib [@var{option}] [@var{inputfile}]
|
||||
@end example
|
||||
|
||||
@cindex filter messages according to attributes
|
||||
@cindex attribute manipulation
|
||||
The @code{msgattrib} program filters the messages of a translation catalog
|
||||
according to their attributes, and manipulates the attributes.
|
||||
|
||||
@ -13,6 +17,8 @@ Input PO file.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msgattrib} option}
|
||||
@opindex --directory@r{, @code{msgattrib} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -26,6 +32,8 @@ If no @var{inputfile} is given or if it is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msgattrib} option}
|
||||
@opindex --output-file@r{, @code{msgattrib} option}
|
||||
Write output to specified file.
|
||||
|
||||
@end table
|
||||
@ -37,48 +45,61 @@ or if it is @samp{-}.
|
||||
|
||||
@table @samp
|
||||
@item --translated
|
||||
@opindex --translated@r{, @code{msgattrib} option}
|
||||
Keep translated messages, remove untranslated messages.
|
||||
|
||||
@item --untranslated
|
||||
@opindex --untranslated@r{, @code{msgattrib} option}
|
||||
Keep untranslated messages, remove translated messages.
|
||||
|
||||
@item --no-fuzzy
|
||||
@opindex --no-fuzzy@r{, @code{msgattrib} option}
|
||||
Remove `fuzzy' marked messages.
|
||||
|
||||
@item --only-fuzzy
|
||||
@opindex --only-fuzzy@r{, @code{msgattrib} option}
|
||||
Keep `fuzzy' marked messages, remove all other messsages.
|
||||
|
||||
@item --no-obsolete
|
||||
@opindex --no-obsolete@r{, @code{msgattrib} option}
|
||||
Remove obsolete #~ messages.
|
||||
|
||||
@item --only-obsolete
|
||||
@opindex --only-obsolete@r{, @code{msgattrib} option}
|
||||
Keep obsolete #~ messages, remove all other messages.
|
||||
|
||||
@end table
|
||||
|
||||
@subsection Attribute manipulation
|
||||
|
||||
@cindex modify message attrributes
|
||||
Attributes are modified after the message selection/removal has been
|
||||
performed.
|
||||
|
||||
@table @samp
|
||||
@item --set-fuzzy
|
||||
@opindex --set-fuzzy@r{, @code{msgattrib} option}
|
||||
Set all messages `fuzzy'.
|
||||
|
||||
@item --clear-fuzzy
|
||||
@opindex --clear-fuzzy@r{, @code{msgattrib} option}
|
||||
Set all messages non-`fuzzy'.
|
||||
|
||||
@item --set-obsolete
|
||||
@opindex --set-obsolete@r{, @code{msgattrib} option}
|
||||
Set all messages obsolete.
|
||||
|
||||
@item --clear-obsolete
|
||||
@opindex --clear-obsolete@r{, @code{msgattrib} option}
|
||||
Set all messages non-obsolete.
|
||||
|
||||
@item --fuzzy
|
||||
@opindex --fuzzy@r{, @code{msgattrib} option}
|
||||
Synonym for @samp{--only-fuzzy --clear-fuzzy}: It keeps only the fuzzy
|
||||
messages and removes their `fuzzy' mark.
|
||||
|
||||
@item --obsolete
|
||||
@opindex --obsolete@r{, @code{msgattrib} option}
|
||||
Synonym for @samp{--only-obsolete --clear-obsolete}: It keeps only the
|
||||
obsolete messages and makes them non-obsolete.
|
||||
|
||||
@ -90,37 +111,50 @@ obsolete messages and makes them non-obsolete.
|
||||
|
||||
@table @samp
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{msgattrib} option}
|
||||
Always write an output file even if it contains no message.
|
||||
|
||||
@item -i
|
||||
@itemx --indent
|
||||
@opindex -i@r{, @code{msgattrib} option}
|
||||
@opindex --indent@r{, @code{msgattrib} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --no-location
|
||||
@opindex --no-location@r{, @code{msgattrib} option}
|
||||
Do not write @samp{#: @var{filename}:@var{line}} lines.
|
||||
|
||||
@item -n
|
||||
@itemx --add-location
|
||||
@opindex -n@r{, @code{msgattrib} option}
|
||||
@opindex --add-location@r{, @code{msgattrib} option}
|
||||
Generate @samp{#: @var{filename}:@var{line}} lines (default).
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msgattrib} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msgattrib} option}
|
||||
@opindex --width@r{, @code{msgattrib} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item -s
|
||||
@itemx --sort-output
|
||||
@opindex -s@r{, @code{msgattrib} option}
|
||||
@opindex --sort-output@r{, @code{msgattrib} option}
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@item -F
|
||||
@itemx --sort-by-file
|
||||
@opindex -F@r{, @code{msgattrib} option}
|
||||
@opindex --sort-by-file@r{, @code{msgattrib} option}
|
||||
Sort output by file location.
|
||||
|
||||
@end table
|
||||
@ -130,10 +164,14 @@ Sort output by file location.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgattrib} option}
|
||||
@opindex --help@r{, @code{msgattrib} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgattrib} option}
|
||||
@opindex --version@r{, @code{msgattrib} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,11 @@
|
||||
@pindex msgcat
|
||||
@cindex @code{msgcat} program, usage
|
||||
@example
|
||||
msgcat [@var{option}] [@var{inputfile}]...
|
||||
@end example
|
||||
|
||||
@cindex concatenate PO files
|
||||
@cindex merge PO files
|
||||
The @code{msgcat} program concatenates and merges the specified PO files.
|
||||
It finds messages which are common to two or more of the specified PO files.
|
||||
By using the @code{--more-than} option, greater commonality may be requested
|
||||
@ -20,11 +24,15 @@ Input files.
|
||||
|
||||
@item -f @var{file}
|
||||
@itemx --files-from=@var{file}
|
||||
@opindex -f@r{, @code{msgcat} option}
|
||||
@opindex --files-from@r{, @code{msgcat} option}
|
||||
Read the names of the input files from @var{file} instead of getting
|
||||
them from the command line.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msgcat} option}
|
||||
@opindex --directory@r{, @code{msgcat} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -38,10 +46,13 @@ If @var{inputfile} is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msgcat} option}
|
||||
@opindex --output-file@r{, @code{msgcat} option}
|
||||
Write output to specified file.
|
||||
|
||||
@end table
|
||||
|
||||
@cindex standard output, and @code{msgcat}
|
||||
The results are written to standard output if no output file is specified
|
||||
or if it is @samp{-}.
|
||||
|
||||
@ -50,16 +61,22 @@ or if it is @samp{-}.
|
||||
@table @samp
|
||||
@item -< @var{number}
|
||||
@itemx --less-than=@var{number}
|
||||
@opindex -<@r{, @code{msgcat} option}
|
||||
@opindex --less-than@r{, @code{msgcat} option}
|
||||
Print messages with less than @var{number} definitions, defaults to infinite
|
||||
if not set.
|
||||
|
||||
@item -> @var{number}
|
||||
@itemx --more-than=@var{number}
|
||||
@opindex ->@r{, @code{msgcat} option}
|
||||
@opindex --more-than@r{, @code{msgcat} option}
|
||||
Print messages with more than @var{number} definitions, defaults to 0 if not
|
||||
set.
|
||||
|
||||
@item -u
|
||||
@itemx --unique
|
||||
@opindex -u@r{, @code{msgcat} option}
|
||||
@opindex --unique@r{, @code{msgcat} option}
|
||||
Shorthand for @samp{--less-than=2}. Requests that only unique messages be
|
||||
printed.
|
||||
|
||||
@ -72,44 +89,61 @@ printed.
|
||||
@table @samp
|
||||
@item -t
|
||||
@itemx --to-code=@var{name}
|
||||
@opindex -t@r{, @code{msgcat} option}
|
||||
@opindex --to-code@r{, @code{msgcat} option}
|
||||
Specify encoding for output.
|
||||
|
||||
@item --use-first
|
||||
@opindex --use-first@r{, @code{msgcat} option}
|
||||
Use first available translation for each message. Don't merge several
|
||||
translations into one.
|
||||
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{msgcat} option}
|
||||
Always write an output file even if it contains no message.
|
||||
|
||||
@item -i
|
||||
@itemx --indent
|
||||
@opindex -i@r{, @code{msgcat} option}
|
||||
@opindex --indent@r{, @code{msgcat} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --no-location
|
||||
@opindex --no-location@r{, @code{msgcat} option}
|
||||
Do not write @samp{#: @var{filename}:@var{line}} lines.
|
||||
|
||||
@item -n
|
||||
@itemx --add-location
|
||||
@opindex -n@r{, @code{msgcat} option}
|
||||
@opindex --add-location@r{, @code{msgcat} option}
|
||||
Generate @samp{#: @var{filename}:@var{line}} lines (default).
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msgcat} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msgcat} option}
|
||||
@opindex --width@r{, @code{msgcat} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item -s
|
||||
@itemx --sort-output
|
||||
@opindex -s@r{, @code{msgcat} option}
|
||||
@opindex --sort-output@r{, @code{msgcat} option}
|
||||
@cindex sorting @code{msgcat} output
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@item -F
|
||||
@itemx --sort-by-file
|
||||
@opindex -F@r{, @code{msgcat} option}
|
||||
@opindex --sort-by-file@r{, @code{msgcat} option}
|
||||
Sort output by file location.
|
||||
|
||||
@end table
|
||||
@ -119,10 +153,14 @@ Sort output by file location.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgcat} option}
|
||||
@opindex --help@r{, @code{msgcat} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgcat} option}
|
||||
@opindex --version@r{, @code{msgcat} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,10 @@
|
||||
@pindex msgcmp
|
||||
@cindex @code{msgcmp} program, usage
|
||||
@example
|
||||
msgcmp [@var{option}] @var{def}.po @var{ref}.pot
|
||||
@end example
|
||||
|
||||
@cindex compare PO files
|
||||
The @code{msgcmp} program compares two Uniforum style .po files to check that
|
||||
both contain the same set of msgid strings. The @var{def}.po file is an
|
||||
existing PO file with the translations. The @var{ref}.pot file is the last
|
||||
@ -21,6 +24,8 @@ References to the sources.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msgcmp} option}
|
||||
@opindex --directory@r{, @code{msgcmp} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories.
|
||||
|
||||
@ -31,6 +36,8 @@ searched relative to this list of directories.
|
||||
@table @samp
|
||||
@item -m
|
||||
@itemx --multi-domain
|
||||
@opindex -m@r{, @code{msgcmp} option}
|
||||
@opindex --multi-domain@r{, @code{msgcmp} option}
|
||||
Apply @var{ref}.pot to each of the domains in @var{def}.po.
|
||||
|
||||
@end table
|
||||
@ -40,10 +47,14 @@ Apply @var{ref}.pot to each of the domains in @var{def}.po.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgcmp} option}
|
||||
@opindex --help@r{, @code{msgcmp} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgcmp} option}
|
||||
@opindex --version@r{, @code{msgcmp} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,10 @@
|
||||
@pindex msgcomm
|
||||
@cindex @code{msgcomm} program, usage
|
||||
@example
|
||||
msgcomm [@var{option}] [@var{inputfile}]...
|
||||
@end example
|
||||
|
||||
@cindex find common messages
|
||||
The @code{msgcomm} program finds messages which are common to two or more
|
||||
of the specified PO files.
|
||||
By using the @code{--more-than} option, greater commonality may be requested
|
||||
@ -20,11 +23,15 @@ Input files.
|
||||
|
||||
@item -f @var{file}
|
||||
@itemx --files-from=@var{file}
|
||||
@opindex -f@r{, @code{msgcomm} option}
|
||||
@opindex --files-from@r{, @code{msgcomm} option}
|
||||
Read the names of the input files from @var{file} instead of getting
|
||||
them from the command line.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msgcomm} option}
|
||||
@opindex --directory@r{, @code{msgcomm} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -38,6 +45,8 @@ If @var{inputfile} is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msgcomm} option}
|
||||
@opindex --output-file@r{, @code{msgcomm} option}
|
||||
Write output to specified file.
|
||||
|
||||
@end table
|
||||
@ -50,16 +59,22 @@ or if it is @samp{-}.
|
||||
@table @samp
|
||||
@item -< @var{number}
|
||||
@itemx --less-than=@var{number}
|
||||
@opindex -<@r{, @code{msgcomm} option}
|
||||
@opindex --less-than@r{, @code{msgcomm} option}
|
||||
Print messages with less than @var{number} definitions, defaults to infinite
|
||||
if not set.
|
||||
|
||||
@item -> @var{number}
|
||||
@itemx --more-than=@var{number}
|
||||
@opindex ->@r{, @code{msgcomm} option}
|
||||
@opindex --more-than@r{, @code{msgcomm} option}
|
||||
Print messages with more than @var{number} definitions, defaults to 1 if not
|
||||
set.
|
||||
|
||||
@item -u
|
||||
@itemx --unique
|
||||
@opindex -u@r{, @code{msgcomm} option}
|
||||
@opindex --unique@r{, @code{msgcomm} option}
|
||||
Shorthand for @samp{--less-than=2}. Requests that only unique messages be
|
||||
printed.
|
||||
|
||||
@ -71,40 +86,54 @@ printed.
|
||||
|
||||
@table @samp
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{msgcomm} option}
|
||||
Always write an output file even if it contains no message.
|
||||
|
||||
@item -i
|
||||
@itemx --indent
|
||||
@opindex -i@r{, @code{msgcomm} option}
|
||||
@opindex --indent@r{, @code{msgcomm} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --no-location
|
||||
@opindex --no-location@r{, @code{msgcomm} option}
|
||||
Do not write @samp{#: @var{filename}:@var{line}} lines.
|
||||
|
||||
@item -n
|
||||
@itemx --add-location
|
||||
@opindex -n@r{, @code{msgcomm} option}
|
||||
@opindex --add-location@r{, @code{msgcomm} option}
|
||||
Generate @samp{#: @var{filename}:@var{line}} lines (default).
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msgcomm} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msgcomm} option}
|
||||
@opindex --width@r{, @code{msgcomm} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item -s
|
||||
@itemx --sort-output
|
||||
@opindex -s@r{, @code{msgcomm} option}
|
||||
@opindex --sort-output@r{, @code{msgcomm} option}
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@item -F
|
||||
@itemx --sort-by-file
|
||||
@opindex -F@r{, @code{msgcomm} option}
|
||||
@opindex --sort-by-file@r{, @code{msgcomm} option}
|
||||
Sort output by file location.
|
||||
|
||||
@item --omit-header
|
||||
@opindex --omit-header@r{, @code{msgcomm} option}
|
||||
Don't write header with @samp{msgid ""} entry.
|
||||
|
||||
@end table
|
||||
@ -114,10 +143,14 @@ Don't write header with @samp{msgid ""} entry.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgcomm} option}
|
||||
@opindex --help@r{, @code{msgcomm} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgcomm} option}
|
||||
@opindex --version@r{, @code{msgcomm} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,10 @@
|
||||
@pindex msgconv
|
||||
@cindex @code{msgconv} program, usage
|
||||
@example
|
||||
msgconv [@var{option}] [@var{inputfile}]
|
||||
@end example
|
||||
|
||||
@cindex convert translations to a different encoding
|
||||
The @code{msgconv} program converts a translation catalog to a different
|
||||
character encoding.
|
||||
|
||||
@ -13,6 +16,8 @@ Input PO file.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msgconv} option}
|
||||
@opindex --directory@r{, @code{msgconv} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -26,6 +31,8 @@ If no @var{inputfile} is given or if it is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msgconv} option}
|
||||
@opindex --output-file@r{, @code{msgconv} option}
|
||||
Write output to specified file.
|
||||
|
||||
@end table
|
||||
@ -38,6 +45,8 @@ or if it is @samp{-}.
|
||||
@table @samp
|
||||
@item -t
|
||||
@itemx --to-code=@var{name}
|
||||
@opindex -t@r{, @code{msgconv} option}
|
||||
@opindex --to-code@r{, @code{msgconv} option}
|
||||
Specify encoding for output.
|
||||
|
||||
@end table
|
||||
@ -50,36 +59,48 @@ The default encoding is the current locale's encoding.
|
||||
|
||||
@table @samp
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{msgconv} option}
|
||||
Always write an output file even if it contains no message.
|
||||
|
||||
@item -i
|
||||
@itemx --indent
|
||||
@opindex -i@r{, @code{msgconv} option}
|
||||
@opindex --indent@r{, @code{msgconv} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --no-location
|
||||
@opindex --no-location@r{, @code{msgconv} option}
|
||||
Do not write @samp{#: @var{filename}:@var{line}} lines.
|
||||
|
||||
@item --add-location
|
||||
@opindex --add-location@r{, @code{msgconv} option}
|
||||
Generate @samp{#: @var{filename}:@var{line}} lines (default).
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msgconv} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msgconv} option}
|
||||
@opindex --width@r{, @code{msgconv} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item -s
|
||||
@itemx --sort-output
|
||||
@opindex -s@r{, @code{msgconv} option}
|
||||
@opindex --sort-output@r{, @code{msgconv} option}
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@item -F
|
||||
@itemx --sort-by-file
|
||||
@opindex -F@r{, @code{msgconv} option}
|
||||
@opindex --sort-by-file@r{, @code{msgconv} option}
|
||||
Sort output by file location.
|
||||
|
||||
@end table
|
||||
@ -89,10 +110,14 @@ Sort output by file location.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgconv} option}
|
||||
@opindex --help@r{, @code{msgconv} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgconv} option}
|
||||
@opindex --version@r{, @code{msgconv} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,10 @@
|
||||
@pindex msgen
|
||||
@cindex @code{msgen} program, usage
|
||||
@example
|
||||
msgen [@var{option}] @var{inputfile}
|
||||
@end example
|
||||
|
||||
@cindex generate translation catalog in English
|
||||
The @code{msgen} program 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
|
||||
@ -19,6 +22,8 @@ Input PO or POT file.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msgen} option}
|
||||
@opindex --directory@r{, @code{msgen} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -32,6 +37,8 @@ If @var{inputfile} is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msgen} option}
|
||||
@opindex --output-file@r{, @code{msgen} option}
|
||||
Write output to specified file.
|
||||
|
||||
@end table
|
||||
@ -45,36 +52,48 @@ or if it is @samp{-}.
|
||||
|
||||
@table @samp
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{msgen} option}
|
||||
Always write an output file even if it contains no message.
|
||||
|
||||
@item -i
|
||||
@itemx --indent
|
||||
@opindex -i@r{, @code{msgen} option}
|
||||
@opindex --indent@r{, @code{msgen} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --no-location
|
||||
@opindex --no-location@r{, @code{msgen} option}
|
||||
Do not write @samp{#: @var{filename}:@var{line}} lines.
|
||||
|
||||
@item --add-location
|
||||
@opindex --add-location@r{, @code{msgen} option}
|
||||
Generate @samp{#: @var{filename}:@var{line}} lines (default).
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msgen} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msgen} option}
|
||||
@opindex --width@r{, @code{msgen} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item -s
|
||||
@itemx --sort-output
|
||||
@opindex -s@r{, @code{msgen} option}
|
||||
@opindex --sort-output@r{, @code{msgen} option}
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@item -F
|
||||
@itemx --sort-by-file
|
||||
@opindex -F@r{, @code{msgen} option}
|
||||
@opindex --sort-by-file@r{, @code{msgen} option}
|
||||
Sort output by file location.
|
||||
|
||||
@end table
|
||||
@ -84,10 +103,14 @@ Sort output by file location.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgen} option}
|
||||
@opindex --help@r{, @code{msgen} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgen} option}
|
||||
@opindex --version@r{, @code{msgen} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,10 @@
|
||||
@pindex msgexec
|
||||
@cindex @code{msgexec} program, usage
|
||||
@example
|
||||
msgexec [@var{option}] @var{command} [@var{command-option}]
|
||||
@end example
|
||||
|
||||
@cindex apply command to all translations in a catalog
|
||||
The @code{msgexec} program applies a command to all translations of a
|
||||
translation catalog.
|
||||
The @var{command} can be any program that reads a translation from standard
|
||||
@ -9,15 +12,19 @@ input. It is invoked once for each translation. Its output becomes
|
||||
msgexec's output. @code{msgexec}'s return code is the maximum return code
|
||||
across all invocations.
|
||||
|
||||
@cindex @code{xargs}, and output from @code{msgexec}
|
||||
A special builtin command called @samp{0} outputs the translation, followed
|
||||
by a null byte. The output of @samp{msgexec 0} is suitable as input for
|
||||
@samp{xargs -0}.
|
||||
|
||||
@vindex MSGEXEC_MSGID@r{, environment variable}
|
||||
@vindex MSGEXEC_LOCATION@r{, environment variable}
|
||||
During each @var{command} invocation, the environment variable
|
||||
@code{MSGEXEC_MSGID} is bound to the message's msgid, and the environment
|
||||
variable @code{MSGEXEC_LOCATION} is bound to the location in the PO file
|
||||
of the message.
|
||||
|
||||
@cindex catalog encoding and @code{msgexec} output
|
||||
Note: It is your responsibility to ensure that the @var{command} can cope
|
||||
with input encoded in the translation catalog's encoding. If the
|
||||
@var{command} wants input in a particular encoding, you can in a first step
|
||||
@ -33,10 +40,14 @@ locale, by using the @code{LC_ALL} environment variable.
|
||||
@table @samp
|
||||
@item -i @var{inputfile}
|
||||
@itemx --input=@var{inputfile}
|
||||
@opindex -i@r{, @code{msgexec} option}
|
||||
@opindex --input@r{, @code{msgexec} option}
|
||||
Input PO file.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msgexec} option}
|
||||
@opindex --directory@r{, @code{msgexec} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -50,10 +61,14 @@ If no @var{inputfile} is given or if it is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgexec} option}
|
||||
@opindex --help@r{, @code{msgexec} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgexec} option}
|
||||
@opindex --version@r{, @code{msgexec} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,10 @@
|
||||
@pindex msgfilter
|
||||
@cindex @code{msgfilter} program, usage
|
||||
@example
|
||||
msgfilter [@var{option}] @var{filter} [@var{filter-option}]
|
||||
@end example
|
||||
|
||||
@cindex apply a filter to translations
|
||||
The @code{msgfilter} program applies a filter to all translations of a
|
||||
translation catalog.
|
||||
|
||||
@ -10,10 +13,14 @@ translation catalog.
|
||||
@table @samp
|
||||
@item -i @var{inputfile}
|
||||
@itemx --input=@var{inputfile}
|
||||
@opindex -i@r{, @code{msgfilter} option}
|
||||
@opindex --input@r{, @code{msgfilter} option}
|
||||
Input PO file.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msgfilter} option}
|
||||
@opindex --directory@r{, @code{msgfilter} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -27,6 +34,8 @@ If no @var{inputfile} is given or if it is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msgfilter} option}
|
||||
@opindex --output-file@r{, @code{msgfilter} option}
|
||||
Write output to specified file.
|
||||
|
||||
@end table
|
||||
@ -40,6 +49,7 @@ The @var{filter} can be any program that reads a translation from standard
|
||||
input and writes a modified translation to standard output. A frequently
|
||||
used filter is @samp{sed}.
|
||||
|
||||
@cindex @code{msgfilter} filter and catalog encoding
|
||||
Note: It is your responsibility to ensure that the @var{filter} can cope
|
||||
with input encoded in the translation catalog's encoding. If the
|
||||
@var{filter} wants input in a particular encoding, you can in a first step
|
||||
@ -50,6 +60,7 @@ you can first convert the translation catalog to UTF-8 using the
|
||||
@samp{msgconv} program and then make @samp{msgfilter} work in an UTF-8
|
||||
locale, by using the @code{LC_ALL} environment variable.
|
||||
|
||||
@cindex portability problems with @code{sed}
|
||||
Note: Most translations in a translation catalog don't end with a newline
|
||||
character. For this reason, it is important that the @var{filter}
|
||||
recognizes its last input line even if it ends without a newline, and that
|
||||
@ -63,15 +74,22 @@ does not have this limitation.
|
||||
@table @samp
|
||||
@item -e @var{script}
|
||||
@itemx --expression=@var{script}
|
||||
@opindex -e@r{, @code{msgfilter} option}
|
||||
@opindex --expression@r{, @code{msgfilter} option}
|
||||
Add @var{script} to the commands to be executed.
|
||||
|
||||
@item -f @var{scriptfile}
|
||||
@itemx --file=@var{scriptfile}
|
||||
@opindex -f@r{, @code{msgfilter} option}
|
||||
@opindex --file@r{, @code{msgfilter} option}
|
||||
Add the contents of @var{scriptfile} to the commands to be executed.
|
||||
|
||||
@item -n
|
||||
@itemx --quiet
|
||||
@itemx --silent
|
||||
@opindex -n@r{, @code{msgfilter} option}
|
||||
@opindex --quiet@r{, @code{msgfilter} option}
|
||||
@opindex --silent@r{, @code{msgfilter} option}
|
||||
Suppress automatic printing of pattern space.
|
||||
|
||||
@end table
|
||||
@ -82,40 +100,52 @@ Suppress automatic printing of pattern space.
|
||||
|
||||
@table @samp
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{msgfilter} option}
|
||||
Always write an output file even if it contains no message.
|
||||
|
||||
@item --indent
|
||||
@opindex --indent@r{, @code{msgfilter} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --keep-header
|
||||
@opindex --keep-header@r{, @code{msgfilter} option}
|
||||
Keep the header entry, i.e. the message with @samp{msgid ""}, unmodified,
|
||||
instead of filtering it. By default, the header entry is subject to
|
||||
filtering like any other message.
|
||||
|
||||
@item --no-location
|
||||
@opindex --no-location@r{, @code{msgfilter} option}
|
||||
Do not write @samp{#: @var{filename}:@var{line}} lines.
|
||||
|
||||
@item --add-location
|
||||
@opindex --add-location@r{, @code{msgfilter} option}
|
||||
Generate @samp{#: @var{filename}:@var{line}} lines (default).
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msgfilter} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msgfilter} option}
|
||||
@opindex --width@r{, @code{msgfilter} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item -s
|
||||
@itemx --sort-output
|
||||
@opindex -s@r{, @code{msgfilter} option}
|
||||
@opindex --sort-output@r{, @code{msgfilter} option}
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@item -F
|
||||
@itemx --sort-by-file
|
||||
@opindex -F@r{, @code{msgfilter} option}
|
||||
@opindex --sort-by-file@r{, @code{msgfilter} option}
|
||||
Sort output by file location.
|
||||
|
||||
@end table
|
||||
@ -125,10 +155,14 @@ Sort output by file location.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgfilter} option}
|
||||
@opindex --help@r{, @code{msgfilter} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgfilter} option}
|
||||
@opindex --version@r{, @code{msgfilter} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,10 @@
|
||||
@pindex msgfmt
|
||||
@cindex @code{msgfmt} program, usage
|
||||
@example
|
||||
msgfmt [@var{option}] @var{filename}.po @dots{}
|
||||
@end example
|
||||
|
||||
@cindex generate binary message catalog from PO file
|
||||
The @code{msgfmt} programs generates a binary message catalog from a textual
|
||||
translation description.
|
||||
|
||||
@ -12,6 +15,8 @@ translation description.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msgfmt} option}
|
||||
@opindex --directory@r{, @code{msgfmt} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -25,9 +30,13 @@ If an input file is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -j
|
||||
@itemx --java
|
||||
@opindex -j@r{, @code{msgfmt} option}
|
||||
@opindex --java@r{, @code{msgfmt} option}
|
||||
@cindex Java mode, and @code{msgfmt} program
|
||||
Java mode: generate a Java @code{ResourceBundle} class.
|
||||
|
||||
@item --java2
|
||||
@opindex --java2@r{, @code{msgfmt} option}
|
||||
Like --java, and assume Java2 (JDK 1.2 or higher).
|
||||
|
||||
@end table
|
||||
@ -37,9 +46,12 @@ Like --java, and assume Java2 (JDK 1.2 or higher).
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msgfmt} option}
|
||||
@opindex --output-file@r{, @code{msgfmt} option}
|
||||
Write output to specified file.
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msgfmt} option}
|
||||
Direct the program to work strictly following the Uniforum/Sun
|
||||
implementation. Currently this only affects the naming of the output
|
||||
file. If this option is not given the name of the output file is the
|
||||
@ -59,14 +71,19 @@ If the output @var{file} is @samp{-}, output is written to standard output.
|
||||
@table @samp
|
||||
@item -r @var{resource}
|
||||
@itemx --resource=@var{resource}
|
||||
@opindex -r@r{, @code{msgfmt} option}
|
||||
@opindex --resource@r{, @code{msgfmt} option}
|
||||
Specify the resource name.
|
||||
|
||||
@item -l @var{locale}
|
||||
@itemx --locale=@var{locale}
|
||||
@opindex -l@r{, @code{msgfmt} option}
|
||||
@opindex --locale@r{, @code{msgfmt} option}
|
||||
Specify the locale name, either a language specification of the form @var{ll}
|
||||
or a combined language and country specification of the form @var{ll_CC}.
|
||||
|
||||
@item -d @var{directory}
|
||||
@opindex -d@r{, @code{msgfmt} option}
|
||||
Specify the base directory of classes directory hierarchy.
|
||||
|
||||
@end table
|
||||
@ -80,10 +97,14 @@ is written under the specified directory.
|
||||
@table @samp
|
||||
@item -c
|
||||
@itemx --check
|
||||
@opindex -c@r{, @code{msgfmt} option}
|
||||
@opindex --check@r{, @code{msgfmt} option}
|
||||
Perform all the checks implied by @code{--check-format}, @code{--check-header},
|
||||
@code{--check-domain}.
|
||||
|
||||
@item --check-format
|
||||
@opindex --check-format@r{, @code{msgfmt} option}
|
||||
@cindex check format strings
|
||||
Check language dependent format strings.
|
||||
|
||||
If the string represents a format string used in a
|
||||
@ -107,19 +128,28 @@ consider removing the flag from the @key{#,} line. This "fix" would be
|
||||
reversed again as soon as @code{msgmerge} is called the next time.
|
||||
|
||||
@item --check-header
|
||||
@opindex --check-header@r{, @code{msgfmt} option}
|
||||
Verify presence and contents of the header entry. @xref{Header Entry},
|
||||
for a description of the various fields in the header entry.
|
||||
|
||||
@item --check-domain
|
||||
@opindex --check-domain@r{, @code{msgfmt} option}
|
||||
Check for conflicts between domain directives and the @code{--output-file}
|
||||
option
|
||||
|
||||
@item -C
|
||||
@itemx --check-compatibility
|
||||
@opindex -C@r{, @code{msgfmt} option}
|
||||
@opindex --check-compatibility@r{, @code{msgfmt} option}
|
||||
@cindex compatibility with X/Open @code{msgfmt}
|
||||
Check that GNU msgfmt behaves like X/Open msgfmt. This will give an error
|
||||
when attempting to use the GNU extensions.
|
||||
|
||||
@item --check-accelerators[=@var{char}]
|
||||
@opindex --check-accelerators@r{, @code{msgfmt} option}
|
||||
@cindex keyboard accelerator checking
|
||||
@cindex menu, keyboard accelerator support
|
||||
@cindex mnemonics of menu entries
|
||||
Check presence of keyboard accelerators for menu items. This is based on
|
||||
the convention used in some GUIs that a keyboard accelerator in a menu
|
||||
item string is designated by an immediately preceding @samp{&} character.
|
||||
@ -132,6 +162,9 @@ instead of @samp{&}.
|
||||
|
||||
@item -f
|
||||
@itemx --use-fuzzy
|
||||
@opindex -f@r{, @code{msgfmt} option}
|
||||
@opindex --use-fuzzy@r{, @code{msgfmt} option}
|
||||
@cindex force use of fuzzy entries
|
||||
Use fuzzy entries in output. Note that using this option is usually wrong,
|
||||
because fuzzy messages are exactly those which have not been validated by
|
||||
a human translator.
|
||||
@ -143,11 +176,14 @@ a human translator.
|
||||
@table @samp
|
||||
@item -a @var{number}
|
||||
@itemx --alignment=@var{number}
|
||||
@opindex -a@r{, @code{msgfmt} option}
|
||||
@opindex --alignment@r{, @code{msgfmt} option}
|
||||
Align strings to @var{number} bytes (default: 1).
|
||||
@c Currently the README mentions that this constant could be changed by
|
||||
@c the installer by changing the value in config.h. Should this go away?
|
||||
|
||||
@item --no-hash
|
||||
@opindex --no-hash@r{, @code{msgfmt} option}
|
||||
Don't include a hash table in the binary file. Lookup will be more expensive
|
||||
at run time (binary search instead of hash table lookup).
|
||||
|
||||
@ -158,17 +194,24 @@ at run time (binary search instead of hash table lookup).
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgfmt} option}
|
||||
@opindex --help@r{, @code{msgfmt} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgfmt} option}
|
||||
@opindex --version@r{, @code{msgfmt} option}
|
||||
Output version information and exit.
|
||||
|
||||
@item --statistics
|
||||
@opindex --statistics@r{, @code{msgfmt} option}
|
||||
Print statistics about translations.
|
||||
|
||||
@item -v
|
||||
@itemx --verbose
|
||||
@opindex -v@r{, @code{msgfmt} option}
|
||||
@opindex --verbose@r{, @code{msgfmt} option}
|
||||
Increase verbosity level.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,10 @@
|
||||
@pindex msggrep
|
||||
@cindex @code{msggrep} program, usage
|
||||
@example
|
||||
msggrep [@var{option}] [@var{inputfile}]
|
||||
@end example
|
||||
|
||||
@cindex search messages in a catalog
|
||||
The @code{msggrep} program extracts all messages of a translation catalog
|
||||
that match a given pattern or belong to some given source files.
|
||||
|
||||
@ -13,6 +16,8 @@ Input PO file.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msggrep} option}
|
||||
@opindex --directory@r{, @code{msggrep} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -26,6 +31,8 @@ If no @var{inputfile} is given or if it is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msggrep} option}
|
||||
@opindex --output-file@r{, @code{msggrep} option}
|
||||
Write output to specified file.
|
||||
|
||||
@end table
|
||||
@ -62,39 +69,57 @@ expressions if -E is given, or fixed strings if -F is given.
|
||||
@table @samp
|
||||
@item -N @var{sourcefile}
|
||||
@itemx --location=@var{sourcefile}
|
||||
@opindex -N@r{, @code{msggrep} option}
|
||||
@opindex --location@r{, @code{msggrep} option}
|
||||
Select messages extracted from @var{sourcefile}. @var{sourcefile} can be
|
||||
either a literal file name or a wildcard pattern.
|
||||
|
||||
@item -M @var{domainname}
|
||||
@itemx --domain=@var{domainname}
|
||||
@opindex -M@r{, @code{msggrep} option}
|
||||
@opindex --domain@r{, @code{msggrep} option}
|
||||
Select messages belonging to domain @var{domainname}.
|
||||
|
||||
@item -K
|
||||
@itemx --msgid
|
||||
@opindex -K@r{, @code{msggrep} option}
|
||||
@opindex --msgid@r{, @code{msggrep} option}
|
||||
Start of patterns for the msgid.
|
||||
|
||||
@item -T
|
||||
@itemx --msgstr
|
||||
@opindex -T@r{, @code{msggrep} option}
|
||||
@opindex --msgstr@r{, @code{msggrep} option}
|
||||
Start of patterns for the msgstr.
|
||||
|
||||
@item -E
|
||||
@itemx --extended-regexp
|
||||
@opindex -E@r{, @code{msggrep} option}
|
||||
@opindex --extended-regexp@r{, @code{msggrep} option}
|
||||
Specify that @var{pattern} is an extended regular expression.
|
||||
|
||||
@item -F
|
||||
@itemx --fixed-strings
|
||||
@opindex -F@r{, @code{msggrep} option}
|
||||
@opindex --fixed-strings@r{, @code{msggrep} option}
|
||||
Specify that @var{pattern} is a set of newline-separated strings.
|
||||
|
||||
@item -e @var{pattern}
|
||||
@itemx --regexp=@var{pattern}
|
||||
@opindex -e@r{, @code{msggrep} option}
|
||||
@opindex --regexp=@r{, @code{msggrep} option}
|
||||
Use @var{pattern} as a regular expression.
|
||||
|
||||
@item -f @var{file}
|
||||
@itemx --file=@var{file}
|
||||
@opindex -f@r{, @code{msggrep} option}
|
||||
@opindex --file@r{, @code{msggrep} option}
|
||||
Obtain @var{pattern} from @var{file}.
|
||||
|
||||
@item -i
|
||||
@itemx --ignore-case
|
||||
@opindex -i@r{, @code{msggrep} option}
|
||||
@opindex --ignore-case@r{, @code{msggrep} option}
|
||||
Ignore case distinctions.
|
||||
|
||||
@end table
|
||||
@ -105,33 +130,42 @@ Ignore case distinctions.
|
||||
|
||||
@table @samp
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{msggrep} option}
|
||||
Always write an output file even if it contains no message.
|
||||
|
||||
@item --indent
|
||||
@opindex --indent@r{, @code{msggrep} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --no-location
|
||||
@opindex --no-location@r{, @code{msggrep} option}
|
||||
Do not write @samp{#: @var{filename}:@var{line}} lines.
|
||||
|
||||
@item --add-location
|
||||
@opindex --add-location@r{, @code{msggrep} option}
|
||||
Generate @samp{#: @var{filename}:@var{line}} lines (default).
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msggrep} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msggrep} option}
|
||||
@opindex --width@r{, @code{msggrep} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item --sort-output
|
||||
@opindex --sort-output@r{, @code{msggrep} option}
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@item --sort-by-file
|
||||
@opindex --sort-by-file@r{, @code{msggrep} option}
|
||||
Sort output by file location.
|
||||
|
||||
@end table
|
||||
@ -141,10 +175,14 @@ Sort output by file location.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msggrep} option}
|
||||
@opindex --help@r{, @code{msggrep} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msggrep} option}
|
||||
@opindex --version@r{, @code{msggrep} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,11 @@
|
||||
@pindex msginit
|
||||
@cindex @code{msginit} program, usage
|
||||
@example
|
||||
msginit [@var{option}]
|
||||
@end example
|
||||
|
||||
@cindex create new PO file
|
||||
@cindex initialize new PO file
|
||||
The @code{msginit} program creates a new PO file, initializing the meta
|
||||
information with values from the user's environment.
|
||||
|
||||
@ -10,6 +14,8 @@ information with values from the user's environment.
|
||||
@table @samp
|
||||
@item -i @var{inputfile}
|
||||
@itemx --input=@var{inputfile}
|
||||
@opindex -i@r{, @code{msginit} option}
|
||||
@opindex --input@r{, @code{msginit} option}
|
||||
Input POT file.
|
||||
|
||||
@end table
|
||||
@ -22,6 +28,8 @@ POT file. If it is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msginit} option}
|
||||
@opindex --output-file@r{, @code{msginit} option}
|
||||
Write output to specified PO file.
|
||||
|
||||
@end table
|
||||
@ -35,16 +43,21 @@ standard output.
|
||||
@table @samp
|
||||
@item -l @var{ll_CC}
|
||||
@itemx --locale=@var{ll_CC}
|
||||
@opindex -l@r{, @code{msginit} option}
|
||||
@opindex --locale@r{, @code{msginit} option}
|
||||
Set target locale. @var{ll} should be a language code, and @var{CC} should
|
||||
be a country code. The command @samp{locale -a} can be used to output a list
|
||||
of all installed locales. The default is the user's locale setting.
|
||||
|
||||
@item --no-translator
|
||||
@opindex --no-translator@r{, @code{msginit} option}
|
||||
Declares that the PO file will not have a human translator and is instead
|
||||
automatically generated.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msginit} option}
|
||||
@opindex --width@r{, @code{msginit} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
@ -56,10 +69,14 @@ split across multiple lines in order to ensure that each line's width
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msginit} option}
|
||||
@opindex --help@r{, @code{msginit} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msginit} option}
|
||||
@opindex --version@r{, @code{msginit} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,3 +1,5 @@
|
||||
@pindex msgmerge
|
||||
@cindex @code{msgmerge} program, usage
|
||||
@example
|
||||
msgmerge [@var{option}] @var{def}.po @var{ref}.pot
|
||||
@end example
|
||||
@ -24,12 +26,16 @@ References to the new sources.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msgmerge} option}
|
||||
@opindex --directory@r{, @code{msgmerge} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
|
||||
@item -C @var{file}
|
||||
@itemx --compendium=@var{file}
|
||||
@opindex -C@r{, @code{msgmerge} option}
|
||||
@opindex --compendium@r{, @code{msgmerge} option}
|
||||
Specify an additional library of message translations. @xref{Compendium}.
|
||||
This option may be specified more than once.
|
||||
|
||||
@ -40,6 +46,8 @@ This option may be specified more than once.
|
||||
@table @samp
|
||||
@item -U
|
||||
@itemx --update
|
||||
@opindex -U@r{, @code{msgmerge} option}
|
||||
@opindex --update@r{, @code{msgmerge} option}
|
||||
Update @var{def}.po. Do nothing if @var{def}.po is already up to date.
|
||||
|
||||
@end table
|
||||
@ -49,10 +57,13 @@ Update @var{def}.po. Do nothing if @var{def}.po is already up to date.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msgmerge} option}
|
||||
@opindex --output-file@r{, @code{msgmerge} option}
|
||||
Write output to specified file.
|
||||
|
||||
@end table
|
||||
|
||||
@cindex standard output, and @code{msgmerge} program
|
||||
The results are written to standard output if no output file is specified
|
||||
or if it is @samp{-}.
|
||||
|
||||
@ -62,13 +73,17 @@ The result is written back to @var{def}.po.
|
||||
|
||||
@table @samp
|
||||
@item --backup=@var{control}
|
||||
@opindex --backup@r{, @code{msgmerge} option}
|
||||
@cindex backup old file, and @code{msgmerge} program
|
||||
Make a backup of @var{def}.po
|
||||
|
||||
@item --suffix=@var{suffix}
|
||||
@opindex --suffix@r{, @code{msgmerge} option}
|
||||
Override the usual backup suffix.
|
||||
|
||||
@end table
|
||||
|
||||
@cindex version control for backup files, @code{msgmerge}
|
||||
The version control method may be selected via the @code{--backup} option
|
||||
or through the @code{VERSION_CONTROL} environment variable. Here are the
|
||||
values:
|
||||
@ -101,6 +116,8 @@ The backup suffix is @samp{~}, unless set with @code{--suffix} or the
|
||||
@table @samp
|
||||
@item -m
|
||||
@itemx --multi-domain
|
||||
@opindex -m@r{, @code{msgmerge} option}
|
||||
@opindex --multi-domain@r{, @code{msgmerge} option}
|
||||
Apply @var{ref}.pot to each of the domains in @var{def}.po.
|
||||
|
||||
@end table
|
||||
@ -111,36 +128,49 @@ Apply @var{ref}.pot to each of the domains in @var{def}.po.
|
||||
|
||||
@table @samp
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{msgmerge} option}
|
||||
Always write an output file even if it contains no message.
|
||||
|
||||
@item -i
|
||||
@itemx --indent
|
||||
@opindex -i@r{, @code{msgmerge} option}
|
||||
@opindex --indent@r{, @code{msgmerge} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --no-location
|
||||
@opindex --no-location@r{, @code{msgmerge} option}
|
||||
Do not write @samp{#: @var{filename}:@var{line}} lines.
|
||||
|
||||
@item --add-location
|
||||
@opindex --add-location@r{, @code{msgmerge} option}
|
||||
Generate @samp{#: @var{filename}:@var{line}} lines (default).
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msgmerge} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msgmerge} option}
|
||||
@opindex --width@r{, @code{msgmerge} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item -s
|
||||
@itemx --sort-output
|
||||
@opindex -s@r{, @code{msgmerge} option}
|
||||
@opindex --sort-output@r{, @code{msgmerge} option}
|
||||
@cindex sorting @code{msgmerge} output
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@item -F
|
||||
@itemx --sort-by-file
|
||||
@opindex -F@r{, @code{msgmerge} option}
|
||||
@opindex --sort-by-file@r{, @code{msgmerge} option}
|
||||
Sort output by file location.
|
||||
|
||||
@end table
|
||||
@ -150,19 +180,28 @@ Sort output by file location.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgmerge} option}
|
||||
@opindex --help@r{, @code{msgmerge} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgmerge} option}
|
||||
@opindex --version@r{, @code{msgmerge} option}
|
||||
Output version information and exit.
|
||||
|
||||
@item -v
|
||||
@itemx --verbose
|
||||
@opindex -v@r{, @code{msgmerge} option}
|
||||
@opindex --verbose@r{, @code{msgmerge} option}
|
||||
Increase verbosity level.
|
||||
|
||||
@item -q
|
||||
@itemx --quiet
|
||||
@itemx --silent
|
||||
@opindex -q@r{, @code{msgmerge} option}
|
||||
@opindex --quiet@r{, @code{msgmerge} option}
|
||||
@opindex --silent@r{, @code{msgmerge} option}
|
||||
Suppress progress indicators.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,10 @@
|
||||
@pindex msgunfmt
|
||||
@cindex @code{msgunfmt} program, usage
|
||||
@example
|
||||
msgunfmt [@var{option}] [@var{file}]...
|
||||
@end example
|
||||
|
||||
@cindex convert binary message catalog into PO file
|
||||
The @code{msgunfmt} program converts a binary message catalog to a
|
||||
Uniforum style .po file.
|
||||
|
||||
@ -10,6 +13,9 @@ Uniforum style .po file.
|
||||
@table @samp
|
||||
@item -j
|
||||
@itemx --java
|
||||
@opindex -j@r{, @code{msgunfmt} option}
|
||||
@opindex --java@r{, @code{msgunfmt} option}
|
||||
@cindex Java mode, and @code{msgunfmt} program
|
||||
Java mode: generate a Java @code{ResourceBundle} class.
|
||||
|
||||
@end table
|
||||
@ -29,10 +35,14 @@ If no input @var{file} is given or if it is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -r @var{resource}
|
||||
@itemx --resource=@var{resource}
|
||||
@opindex -r@r{, @code{msgunfmt} option}
|
||||
@opindex --resource@r{, @code{msgunfmt} option}
|
||||
Specify the resource name.
|
||||
|
||||
@item -l @var{locale}
|
||||
@itemx --locale=@var{locale}
|
||||
@opindex -l@r{, @code{msgunfmt} option}
|
||||
@opindex --locale@r{, @code{msgunfmt} option}
|
||||
Specify the locale name, either a language specification of the form @var{ll}
|
||||
or a combined language and country specification of the form @var{ll_CC}.
|
||||
|
||||
@ -46,6 +56,8 @@ separated with an underscore. The class is located using the @code{CLASSPATH}.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msgunfmt} option}
|
||||
@opindex --output-file@r{, @code{msgunfmt} option}
|
||||
Write output to specified file.
|
||||
|
||||
@end table
|
||||
@ -59,25 +71,34 @@ or if it is @samp{-}.
|
||||
|
||||
@table @samp
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{msgunfmt} option}
|
||||
Always write an output file even if it contains no message.
|
||||
|
||||
@item -i
|
||||
@itemx --indent
|
||||
@opindex -i@r{, @code{msgunfmt} option}
|
||||
@opindex --indent@r{, @code{msgunfmt} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msgunfmt} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msgunfmt} option}
|
||||
@opindex --width@r{, @code{msgunfmt} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item -s
|
||||
@itemx --sort-output
|
||||
@opindex -s@r{, @code{msgunfmt} option}
|
||||
@opindex --sort-output@r{, @code{msgunfmt} option}
|
||||
@cindex sorting @code{msgunfmt} output
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@ -88,14 +109,20 @@ for the translator to understand each message's context.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msgunfmt} option}
|
||||
@opindex --help@r{, @code{msgunfmt} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msgunfmt} option}
|
||||
@opindex --version@r{, @code{msgunfmt} option}
|
||||
Output version information and exit.
|
||||
|
||||
@item -v
|
||||
@itemx --verbose
|
||||
@opindex -v@r{, @code{msgunfmt} option}
|
||||
@opindex --verbose@r{, @code{msgunfmt} option}
|
||||
Increase verbosity level.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,7 +1,11 @@
|
||||
@pindex msguniq
|
||||
@cindex @code{msguniq} program, usage
|
||||
@example
|
||||
msguniq [@var{option}] [@var{inputfile}]
|
||||
@end example
|
||||
|
||||
@cindex unify duplicate translations
|
||||
@cindex duplicate removal
|
||||
The @code{msguniq} program unifies duplicate translations in a translation
|
||||
catalog. It finds duplicate translations of the same message ID. Such
|
||||
duplicates are invalid input for other programs like @code{msgfmt},
|
||||
@ -21,6 +25,8 @@ Input PO file.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{msguniq} option}
|
||||
@opindex --directory@r{, @code{msguniq} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -34,6 +40,8 @@ If no @var{inputfile} is given or if it is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -o @var{file}
|
||||
@itemx --output-file=@var{file}
|
||||
@opindex -o@r{, @code{msguniq} option}
|
||||
@opindex --output-file@r{, @code{msguniq} option}
|
||||
Write output to specified file.
|
||||
|
||||
@end table
|
||||
@ -46,10 +54,14 @@ or if it is @samp{-}.
|
||||
@table @samp
|
||||
@item -d
|
||||
@itemx --repeated
|
||||
@opindex -d@r{, @code{msguniq} option}
|
||||
@opindex --repeated@r{, @code{msguniq} option}
|
||||
Print only duplicates.
|
||||
|
||||
@item -u
|
||||
@itemx --unique
|
||||
@opindex -u@r{, @code{msguniq} option}
|
||||
@opindex --unique@r{, @code{msguniq} option}
|
||||
Print only unique messages, discard duplicates.
|
||||
|
||||
@end table
|
||||
@ -61,44 +73,60 @@ Print only unique messages, discard duplicates.
|
||||
@table @samp
|
||||
@item -t
|
||||
@itemx --to-code=@var{name}
|
||||
@opindex -t@r{, @code{msguniq} option}
|
||||
@opindex --to-code@r{, @code{msguniq} option}
|
||||
Specify encoding for output.
|
||||
|
||||
@item --use-first
|
||||
@opindex --use-first@r{, @code{msguniq} option}
|
||||
Use first available translation for each message. Don't merge several
|
||||
translations into one.
|
||||
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{msguniq} option}
|
||||
Always write an output file even if it contains no message.
|
||||
|
||||
@item -i
|
||||
@itemx --indent
|
||||
@opindex -i@r{, @code{msguniq} option}
|
||||
@opindex --indent@r{, @code{msguniq} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --no-location
|
||||
@opindex --no-location@r{, @code{msguniq} option}
|
||||
Do not write @samp{#: @var{filename}:@var{line}} lines.
|
||||
|
||||
@item -n
|
||||
@itemx --add-location
|
||||
@opindex -n@r{, @code{msguniq} option}
|
||||
@opindex --add-location@r{, @code{msguniq} option}
|
||||
Generate @samp{#: @var{filename}:@var{line}} lines (default).
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{msguniq} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{msguniq} option}
|
||||
@opindex --width@r{, @code{msguniq} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item -s
|
||||
@itemx --sort-output
|
||||
@opindex -s@r{, @code{msguniq} option}
|
||||
@opindex --sort-output@r{, @code{msguniq} option}
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@item -F
|
||||
@itemx --sort-by-file
|
||||
@opindex -F@r{, @code{msguniq} option}
|
||||
@opindex --sort-by-file@r{, @code{msguniq} option}
|
||||
Sort output by file location.
|
||||
|
||||
@end table
|
||||
@ -108,10 +136,14 @@ Sort output by file location.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{msguniq} option}
|
||||
@opindex --help@r{, @code{msguniq} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{msguniq} option}
|
||||
@opindex --version@r{, @code{msguniq} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
@ -1,3 +1,5 @@
|
||||
@pindex xgettext
|
||||
@cindex @code{xgettext} program, usage
|
||||
@example
|
||||
xgettext [@var{option}] [@var{inputfile}] @dots{}
|
||||
@end example
|
||||
@ -13,11 +15,15 @@ Input files.
|
||||
|
||||
@item -f @var{file}
|
||||
@itemx --files-from=@var{file}
|
||||
@opindex -f@r{, @code{xgettext} option}
|
||||
@opindex --files-from@r{, @code{xgettext} option}
|
||||
Read the names of the input files from @var{file} instead of getting
|
||||
them from the command line.
|
||||
|
||||
@item -D @var{directory}
|
||||
@itemx --directory=@var{directory}
|
||||
@opindex -D@r{, @code{xgettext} option}
|
||||
@opindex --directory@r{, @code{xgettext} option}
|
||||
Add @var{directory} to the list of directories. Source files are
|
||||
searched relative to this list of directories. The resulting @file{.po}
|
||||
file will be written relative to the current directory, though.
|
||||
@ -31,19 +37,26 @@ If @var{inputfile} is @samp{-}, standard input is read.
|
||||
@table @samp
|
||||
@item -d @var{name}
|
||||
@itemx --default-domain=@var{name}
|
||||
@opindex -d@r{, @code{xgettext} option}
|
||||
@opindex --default-domain@r{, @code{xgettext} option}
|
||||
Use @file{@var{name}.po} for output (instead of @file{messages.po}).
|
||||
|
||||
@item -o @var{file}
|
||||
@itemx --output=@var{file}
|
||||
@opindex -o@r{, @code{xgettext} option}
|
||||
@opindex --output@r{, @code{xgettext} option}
|
||||
Write output to specified file (instead of @file{@var{name}.po} or
|
||||
@file{messages.po}).
|
||||
|
||||
@item -p @var{dir}
|
||||
@itemx --output-dir=@var{dir}
|
||||
@opindex -p@r{, @code{xgettext} option}
|
||||
@opindex --output-dir@r{, @code{xgettext} option}
|
||||
Output files will be placed in directory @var{dir}.
|
||||
|
||||
@end table
|
||||
|
||||
@cindex output to stdout, @code{xgettext}
|
||||
If the output @var{file} is @samp{-} or @samp{/dev/stdout}, the output
|
||||
is written to standard output.
|
||||
|
||||
@ -52,12 +65,17 @@ is written to standard output.
|
||||
@table @samp
|
||||
@item -L @var{name}
|
||||
@itemx --language=@var{name}
|
||||
@opindex -L@r{, @code{xgettext} option}
|
||||
@opindex --language@r{, @code{xgettext} option}
|
||||
@cindex supported languages, @code{xgettext}
|
||||
Specifies the language of the input files. The supported languages
|
||||
are @code{C}, @code{C++}, @code{ObjectiveC}, @code{PO}, @code{Java},
|
||||
@code{YCP}.
|
||||
|
||||
@item -C
|
||||
@itemx --c++
|
||||
@opindex -C@r{, @code{xgettext} option}
|
||||
@opindex --c++@r{, @code{xgettext} option}
|
||||
This is a shorthand for @code{--language=C++}.
|
||||
|
||||
@end table
|
||||
@ -70,15 +88,21 @@ extension.
|
||||
@table @samp
|
||||
@item -j
|
||||
@itemx --join-existing
|
||||
@opindex -j@r{, @code{xgettext} option}
|
||||
@opindex --join-existing@r{, @code{xgettext} option}
|
||||
Join messages with existing file.
|
||||
|
||||
@item -x @var{file}
|
||||
@itemx --exclude-file=@var{file}
|
||||
@opindex -x@r{, @code{xgettext} option}
|
||||
@opindex --exclude-file@r{, @code{xgettext} option}
|
||||
Entries from @var{file} are not extracted. @var{file} should be a PO or
|
||||
POT file.
|
||||
|
||||
@item -c [@var{tag}]
|
||||
@itemx --add-comments[=@var{tag}]
|
||||
@opindex -c@r{, @code{xgettext} option}
|
||||
@opindex --add-comments@r{, @code{xgettext} option}
|
||||
Place comment block with @var{tag} (or those preceding keyword lines)
|
||||
in output file.
|
||||
|
||||
@ -89,13 +113,18 @@ in output file.
|
||||
@table @samp
|
||||
@item -a
|
||||
@itemx --extract-all
|
||||
@opindex -a@r{, @code{xgettext} option}
|
||||
@opindex --extract-all@r{, @code{xgettext} option}
|
||||
Extract all strings.
|
||||
|
||||
@item -k @var{keywordspec}
|
||||
@itemx --keyword[=@var{keywordspec}]
|
||||
@opindex -k@r{, @code{xgettext} option}
|
||||
@opindex --keyword@r{, @code{xgettext} option}
|
||||
Additional keyword to be looked for (without @var{keywordspec} means not to
|
||||
use default keywords).
|
||||
|
||||
@cindex adding keywords, @code{xgettext}
|
||||
If @var{keywordspec} is a C identifer @var{id}, @code{xgettext} looks
|
||||
for strings in the first argument of each call to the function or macro
|
||||
@var{id}. If @var{keywordspec} is of the form
|
||||
@ -113,9 +142,14 @@ explicitly disabled, are @code{gettext}, @code{dgettext:2},
|
||||
|
||||
@item -T
|
||||
@itemx --trigraphs
|
||||
@opindex -T@r{, @code{xgettext} option}
|
||||
@opindex --trigraphs@r{, @code{xgettext} option}
|
||||
@cindex C trigraphs
|
||||
Understand ANSI C trigraphs for input.
|
||||
|
||||
@itemx --debug
|
||||
@opindex --debug@r{, @code{xgettext} option}
|
||||
@cindex debugging messages marked as format strings
|
||||
Use the flags @kbd{c-format} and @kbd{possible-c-format} to show who was
|
||||
responsible for marking a message as a format string. The latter form is
|
||||
used if the @code{xgettext} program decided, the format form is used if
|
||||
@ -136,48 +170,65 @@ adjacent strings, and escaped end of lines for continued strings.
|
||||
|
||||
@table @samp
|
||||
@item --force-po
|
||||
@opindex --force-po@r{, @code{xgettext} option}
|
||||
Always write an output file even if no message is defined.
|
||||
|
||||
@item -i
|
||||
@itemx --indent
|
||||
@opindex -i@r{, @code{xgettext} option}
|
||||
@opindex --indent@r{, @code{xgettext} option}
|
||||
Write the .po file using indented style.
|
||||
|
||||
@item --no-location
|
||||
@opindex --no-location@r{, @code{xgettext} option}
|
||||
Do not write @samp{#: @var{filename}:@var{line}} lines.
|
||||
|
||||
@item -n
|
||||
@itemx --add-location
|
||||
@opindex -n@r{, @code{xgettext} option}
|
||||
@opindex --add-location@r{, @code{xgettext} option}
|
||||
Generate @samp{#: @var{filename}:@var{line}} lines (default).
|
||||
|
||||
@item --strict
|
||||
@opindex --strict@r{, @code{xgettext} option}
|
||||
Write out a strict Uniforum conforming PO file. Note that this
|
||||
Uniforum format should be avoided because it doesn't support the
|
||||
GNU extensions.
|
||||
|
||||
@item -w @var{number}
|
||||
@itemx --width=@var{number}
|
||||
@opindex -w@r{, @code{xgettext} option}
|
||||
@opindex --width@r{, @code{xgettext} option}
|
||||
Set the output page width. Long strings in the output files will be
|
||||
split across multiple lines in order to ensure that each line's width
|
||||
(= number of screen columns) is less or equal to the given @var{number}.
|
||||
|
||||
@item -s
|
||||
@itemx --sort-output
|
||||
@opindex -s@r{, @code{xgettext} option}
|
||||
@opindex --sort-output@r{, @code{xgettext} option}
|
||||
@cindex sorting output of @code{xgettext}
|
||||
Generate sorted output. Note that using this option makes it much harder
|
||||
for the translator to understand each message's context.
|
||||
|
||||
@item -F
|
||||
@itemx --sort-by-file
|
||||
@opindex -F@r{, @code{xgettext} option}
|
||||
@opindex --sort-by-file@r{, @code{xgettext} option}
|
||||
Sort output by file location.
|
||||
|
||||
@item --omit-header
|
||||
@opindex --omit-header@r{, @code{xgettext} option}
|
||||
Don't write header with @samp{msgid ""} entry.
|
||||
|
||||
@cindex testing @file{.po} files for equivalence
|
||||
This is useful for testing purposes because it eliminates a source
|
||||
of variance for generated @code{.gmo} files. With @code{--omit-header},
|
||||
two invocations of @code{xgettext} on the same files with the same
|
||||
options at different times are guaranteed to produce the same results.
|
||||
|
||||
@item --copyright-holder=@var{string}
|
||||
@opindex --copyright-holder@r{, @code{xgettext} option}
|
||||
Set the copyright holder in the output. @var{string} should be the
|
||||
copyright holder of the surrounding package. (Note that the msgstr
|
||||
strings, extracted from the package's sources, belong to the copyright
|
||||
@ -192,16 +243,21 @@ The default value for @var{string} is the Free Software Foundation, Inc.,
|
||||
simply because @code{xgettext} was first used in the GNU project.
|
||||
|
||||
@item --foreign-user
|
||||
@opindex --foreign-user@r{, @code{xgettext} option}
|
||||
Omit FSF copyright in output. This option is equivalent to
|
||||
@samp{--copyright-holder=''}. It can be useful for packages outside the GNU
|
||||
project that want their translations to be in the public domain.
|
||||
|
||||
@item -m [@var{string}]
|
||||
@itemx --msgstr-prefix[=@var{string}]
|
||||
@opindex -m@r{, @code{xgettext} option}
|
||||
@opindex --msgstr-prefix@r{, @code{xgettext} option}
|
||||
Use @var{string} (or "" if not specified) as prefix for msgstr entries.
|
||||
|
||||
@item -M [@var{string}]
|
||||
@itemx --msgstr-suffix[=@var{string}]
|
||||
@opindex -M@r{, @code{xgettext} option}
|
||||
@opindex --msgstr-suffix@r{, @code{xgettext} option}
|
||||
Use @var{string} (or "" if not specified) as suffix for msgstr entries.
|
||||
|
||||
@end table
|
||||
@ -211,10 +267,14 @@ Use @var{string} (or "" if not specified) as suffix for msgstr entries.
|
||||
@table @samp
|
||||
@item -h
|
||||
@itemx --help
|
||||
@opindex -h@r{, @code{xgettext} option}
|
||||
@opindex --help@r{, @code{xgettext} option}
|
||||
Display this help and exit.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
@opindex -V@r{, @code{xgettext} option}
|
||||
@opindex --version@r{, @code{xgettext} option}
|
||||
Output version information and exit.
|
||||
|
||||
@end table
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user