From b685a652d386d1c27a52e31008f0e1da6e73aaad Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Wed, 24 Apr 2002 18:04:31 +0000 Subject: Regenerated for 0.11.1. --- doc/gettext_8.html | 221 +++++++++++++++++++++++++++-------------------------- 1 file changed, 114 insertions(+), 107 deletions(-) (limited to 'doc/gettext_8.html') diff --git a/doc/gettext_8.html b/doc/gettext_8.html index 5bc1047..5e369c4 100644 --- a/doc/gettext_8.html +++ b/doc/gettext_8.html @@ -1,7 +1,7 @@ + from gettext.texi on 24 April 2002 --> GNU gettext utilities - 8 Producing Binary MO Files @@ -10,29 +10,29 @@ Go to the first, previous<

-

8 Producing Binary MO Files

+

8 Producing Binary MO Files

-

8.1 Invoking the msgfmt Program

+

8.1 Invoking the msgfmt Program

- - + + 

 msgfmt [option] filename.po ...

- + The msgfmt programs generates a binary message catalog from a textual translation description.

-

8.1.1 Input file location

+

8.1.1 Input file location

@@ -42,8 +42,8 @@ translation description.
`--directory=directory´
- - + + Add directory to the list of directories. Source files are searched relative to this list of directories. The resulting `.po´ file will be written relative to the current directory, though. @@ -56,7 +56,7 @@ If an input file is `-´, standard input is read.

-

8.1.2 Operation mode

+

8.1.2 Operation mode

@@ -64,27 +64,27 @@ If an input file is `-´, standard input is read.
`--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.
-

8.1.3 Output file location

+

8.1.3 Output file location

@@ -92,13 +92,13 @@ Tcl mode: generate a tcl/msgcat `.msg´ file.
`--output-file=file´
- - + + Write output to specified file.
`--strict´
- + 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 @@ -117,7 +117,7 @@ If the output file is `-´, output is written to st

-

8.1.4 Output file location in Java mode

+

8.1.4 Output file location in Java mode

@@ -125,22 +125,22 @@ If the output file is `-´, output is written to st
`--resource=resource´
- - + + Specify the resource name.
`-l locale´
`--locale=locale´
- - + + Specify the locale name, either a language specification of the form ll or a combined language and country specification of the form ll_CC.
`-d directory´
- + Specify the base directory of classes directory hierarchy.
@@ -153,7 +153,7 @@ is written under the specified directory.

-

8.1.5 Output file location in Tcl mode

+

8.1.5 Output file location in Tcl mode

@@ -161,14 +161,14 @@ is written under the specified directory.
`--locale=locale´
- - + + Specify the locale name, either a language specification of the form ll or a combined language and country specification of the form ll_CC.
`-d directory´
- + Specify the base directory of `.msg´ message catalogs.
@@ -180,7 +180,7 @@ written in the specified directory.

-

8.1.6 Input file interpretation

+

8.1.6 Input file interpretation

@@ -188,15 +188,15 @@ written in the specified directory.
`--check´
- - + + Perform all the checks implied by --check-format, --check-header, --check-domain.
`--check-format´
- - + + Check language dependent format strings. If the string represents a format string used in a @@ -215,19 +215,19 @@ used in a printf-like function and so msgfmt might rep errors where there are none. To solve this problem the programmer can dictate the decision to the -xgettext program (see section 3.4 Special Comments preceding Keywords). The translator should not +xgettext program (see section 3.5 Special Comments preceding Keywords). The translator should not consider removing the flag from the #, line. This "fix" would be reversed again as soon as msgmerge is called the next time.
`--check-header´
- -Verify presence and contents of the header entry. See section 5.2 Filling in the Header Entry, + +Verify presence and contents of the header entry. See section 5.2 Filling in the Header Entry, for a description of the various fields in the header entry.
`--check-domain´
- + Check for conflicts between domain directives and the --output-file option @@ -235,18 +235,18 @@ option
`--check-compatibility´
- - - + + + Check that GNU msgfmt behaves like X/Open msgfmt. This will give an error when attempting to use the GNU extensions.
`--check-accelerators[=char]´
- - - - + + + + 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 `&´ character. @@ -261,9 +261,9 @@ instead of `&´.
`--use-fuzzy´
- - - + + + 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. @@ -272,7 +272,7 @@ a human translator. -

8.1.7 Output details

+

8.1.7 Output details

@@ -280,13 +280,13 @@ a human translator.
`--alignment=number´
- - + + Align strings to number bytes (default: 1).
`--no-hash´
- + 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). @@ -294,7 +294,7 @@ at run time (binary search instead of hash table lookup). -

8.1.8 Informative output

+

8.1.8 Informative output

@@ -302,54 +302,54 @@ at run time (binary search instead of hash table lookup).
`--help´
- - + + Display this help and exit.
`-V´
`--version´
- - + + Output version information and exit.
`--statistics´
- + Print statistics about translations.
`-v´
`--verbose´
- - + + Increase verbosity level.
-

8.2 Invoking the msgunfmt Program

+

8.2 Invoking the msgunfmt Program

- - + + 

 msgunfmt [option] [file]...

- + The msgunfmt program converts a binary message catalog to a Uniforum style .po file.

-

8.2.1 Operation mode

+

8.2.1 Operation mode

@@ -357,22 +357,22 @@ Uniforum style .po file.
`--java´
- - - + + + Java mode: input is a Java ResourceBundle class.
`--tcl´
- - + + Tcl mode: input is a tcl/msgcat `.msg´ file.
-

8.2.2 Input file location

+

8.2.2 Input file location

@@ -388,7 +388,7 @@ If no input file is given or if it is `-´, standar

-

8.2.3 Input file location in Java mode

+

8.2.3 Input file location in Java mode

@@ -396,16 +396,16 @@ If no input file is given or if it is `-´, standar
`--resource=resource´
- - + + Specify the resource name.
`-l locale´
`--locale=locale´
- - + + Specify the locale name, either a language specification of the form ll or a combined language and country specification of the form ll_CC. @@ -418,7 +418,7 @@ separated with an underscore. The class is located using the CLASSPATH -

8.2.4 Input file location in Tcl mode

+

8.2.4 Input file location in Tcl mode

@@ -426,14 +426,14 @@ separated with an underscore. The class is located using the CLASSPATH
`--locale=locale´
- - + + Specify the locale name, either a language specification of the form ll or a combined language and country specification of the form ll_CC.
`-d directory´
- + Specify the base directory of `.msg´ message catalogs.
@@ -445,7 +445,7 @@ located in the specified directory.

-

8.2.5 Output file location

+

8.2.5 Output file location

@@ -453,8 +453,8 @@ located in the specified directory.
`--output-file=file´
- - + + Write output to specified file.
@@ -466,26 +466,26 @@ or if it is `-´.

-

8.2.6 Output details

+

8.2.6 Output details

`--force-po´
- + Always write an output file even if it contains no message.
`-i´
`--indent´
- - + + Write the .po file using indented style.
`--strict´
- + Write out a strict Uniforum conforming PO file. Note that this Uniforum format should be avoided because it doesn't support the GNU extensions. @@ -494,19 +494,26 @@ GNU extensions.
`--width=number´
- - + + 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 number. +
`--no-wrap´ +
+ +Do not break long message lines. Message lines whose width exceeds the +output page width will not be split into several lines. Only file reference +lines which are wider than the output page width will be split. +
`-s´
`--sort-output´
- - - + + + Generate sorted output. Note that using this option makes it much harder for the translator to understand each message's context. @@ -514,7 +521,7 @@ for the translator to understand each message's context. -

8.2.7 Informative output

+

8.2.7 Informative output

@@ -522,34 +529,34 @@ for the translator to understand each message's context.
`--help´
- - + + Display this help and exit.
`-V´
`--version´
- - + + Output version information and exit.
`-v´
`--verbose´
- - + + Increase verbosity level.
-

8.3 The Format of GNU MO Files

+

8.3 The Format of GNU MO Files

- - + +

@@ -558,7 +565,7 @@ which appears below.

- + The first two words serve the identification of the file. The magic number will always signal GNU MO files. The number is stored in the byte order of the generating machine, so the magic number really is @@ -606,7 +613,7 @@ translated tables, making the system information very easy to find.

- + The size S of the hash table can be zero. In this case, the hash table itself is not contained in the MO file. Some people might prefer this because a precomputed hashing table takes disk space, and @@ -627,7 +634,7 @@ machines, a correct alignment will speed things up.

- + Plural forms are stored by letting the plural of the original string follow the singular of the original string, separated through a NUL byte. The length which appears in the string descriptor -- cgit v1.1