diff options
| author | Bruno Haible <bruno@clisp.org> | 2002-04-24 18:04:31 +0000 |
|---|---|---|
| committer | Bruno Haible <bruno@clisp.org> | 2009-06-23 12:07:54 +0200 |
| commit | b685a652d386d1c27a52e31008f0e1da6e73aaad (patch) | |
| tree | 7d0927b50da571eb4c6f5ebfa2a5eff43d651ed8 /doc/gettext_8.html | |
| parent | 964b78f07f33a9ef1dee03efad369664f8f3788e (diff) | |
| download | external_gettext-b685a652d386d1c27a52e31008f0e1da6e73aaad.zip external_gettext-b685a652d386d1c27a52e31008f0e1da6e73aaad.tar.gz external_gettext-b685a652d386d1c27a52e31008f0e1da6e73aaad.tar.bz2 | |
Regenerated for 0.11.1.
Diffstat (limited to 'doc/gettext_8.html')
| -rw-r--r-- | doc/gettext_8.html | 221 |
1 files changed, 114 insertions, 107 deletions
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 @@ <HTML> <HEAD> <!-- This HTML file has been created by texi2html 1.52a - from gettext.texi on 7 March 2002 --> + from gettext.texi on 24 April 2002 --> <TITLE>GNU gettext utilities - 8 Producing Binary MO Files</TITLE> </HEAD> @@ -10,29 +10,29 @@ Go to the <A HREF="gettext_1.html">first</A>, <A HREF="gettext_7.html">previous< <P><HR><P> -<H1><A NAME="SEC117" HREF="gettext_toc.html#TOC117">8 Producing Binary MO Files</A></H1> +<H1><A NAME="SEC118" HREF="gettext_toc.html#TOC118">8 Producing Binary MO Files</A></H1> -<H2><A NAME="SEC118" HREF="gettext_toc.html#TOC118">8.1 Invoking the <CODE>msgfmt</CODE> Program</A></H2> +<H2><A NAME="SEC119" HREF="gettext_toc.html#TOC119">8.1 Invoking the <CODE>msgfmt</CODE> Program</A></H2> <P> -<A NAME="IDX703"></A> -<A NAME="IDX704"></A> +<A NAME="IDX724"></A> +<A NAME="IDX725"></A> <PRE> msgfmt [<VAR>option</VAR>] <VAR>filename</VAR>.po ... </PRE> <P> -<A NAME="IDX705"></A> +<A NAME="IDX726"></A> The <CODE>msgfmt</CODE> programs generates a binary message catalog from a textual translation description. </P> -<H3><A NAME="SEC119" HREF="gettext_toc.html#TOC119">8.1.1 Input file location</A></H3> +<H3><A NAME="SEC120" HREF="gettext_toc.html#TOC120">8.1.1 Input file location</A></H3> <DL COMPACT> @@ -42,8 +42,8 @@ translation description. <DD> <DT><SAMP>`--directory=<VAR>directory</VAR>´</SAMP> <DD> -<A NAME="IDX706"></A> -<A NAME="IDX707"></A> +<A NAME="IDX727"></A> +<A NAME="IDX728"></A> Add <VAR>directory</VAR> to the list of directories. Source files are searched relative to this list of directories. The resulting <TT>`.po´</TT> file will be written relative to the current directory, though. @@ -56,7 +56,7 @@ If an input file is <SAMP>`-´</SAMP>, standard input is read. </P> -<H3><A NAME="SEC120" HREF="gettext_toc.html#TOC120">8.1.2 Operation mode</A></H3> +<H3><A NAME="SEC121" HREF="gettext_toc.html#TOC121">8.1.2 Operation mode</A></H3> <DL COMPACT> @@ -64,27 +64,27 @@ If an input file is <SAMP>`-´</SAMP>, standard input is read. <DD> <DT><SAMP>`--java´</SAMP> <DD> -<A NAME="IDX708"></A> -<A NAME="IDX709"></A> -<A NAME="IDX710"></A> +<A NAME="IDX729"></A> +<A NAME="IDX730"></A> +<A NAME="IDX731"></A> Java mode: generate a Java <CODE>ResourceBundle</CODE> class. <DT><SAMP>`--java2´</SAMP> <DD> -<A NAME="IDX711"></A> +<A NAME="IDX732"></A> Like --java, and assume Java2 (JDK 1.2 or higher). <DT><SAMP>`--tcl´</SAMP> <DD> -<A NAME="IDX712"></A> -<A NAME="IDX713"></A> +<A NAME="IDX733"></A> +<A NAME="IDX734"></A> Tcl mode: generate a tcl/msgcat <TT>`.msg´</TT> file. </DL> -<H3><A NAME="SEC121" HREF="gettext_toc.html#TOC121">8.1.3 Output file location</A></H3> +<H3><A NAME="SEC122" HREF="gettext_toc.html#TOC122">8.1.3 Output file location</A></H3> <DL COMPACT> @@ -92,13 +92,13 @@ Tcl mode: generate a tcl/msgcat <TT>`.msg´</TT> file. <DD> <DT><SAMP>`--output-file=<VAR>file</VAR>´</SAMP> <DD> -<A NAME="IDX714"></A> -<A NAME="IDX715"></A> +<A NAME="IDX735"></A> +<A NAME="IDX736"></A> Write output to specified file. <DT><SAMP>`--strict´</SAMP> <DD> -<A NAME="IDX716"></A> +<A NAME="IDX737"></A> 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 <VAR>file</VAR> is <SAMP>`-´</SAMP>, output is written to st </P> -<H3><A NAME="SEC122" HREF="gettext_toc.html#TOC122">8.1.4 Output file location in Java mode</A></H3> +<H3><A NAME="SEC123" HREF="gettext_toc.html#TOC123">8.1.4 Output file location in Java mode</A></H3> <DL COMPACT> @@ -125,22 +125,22 @@ If the output <VAR>file</VAR> is <SAMP>`-´</SAMP>, output is written to st <DD> <DT><SAMP>`--resource=<VAR>resource</VAR>´</SAMP> <DD> -<A NAME="IDX717"></A> -<A NAME="IDX718"></A> +<A NAME="IDX738"></A> +<A NAME="IDX739"></A> Specify the resource name. <DT><SAMP>`-l <VAR>locale</VAR>´</SAMP> <DD> <DT><SAMP>`--locale=<VAR>locale</VAR>´</SAMP> <DD> -<A NAME="IDX719"></A> -<A NAME="IDX720"></A> +<A NAME="IDX740"></A> +<A NAME="IDX741"></A> Specify the locale name, either a language specification of the form <VAR>ll</VAR> or a combined language and country specification of the form <VAR>ll_CC</VAR>. <DT><SAMP>`-d <VAR>directory</VAR>´</SAMP> <DD> -<A NAME="IDX721"></A> +<A NAME="IDX742"></A> Specify the base directory of classes directory hierarchy. </DL> @@ -153,7 +153,7 @@ is written under the specified directory. </P> -<H3><A NAME="SEC123" HREF="gettext_toc.html#TOC123">8.1.5 Output file location in Tcl mode</A></H3> +<H3><A NAME="SEC124" HREF="gettext_toc.html#TOC124">8.1.5 Output file location in Tcl mode</A></H3> <DL COMPACT> @@ -161,14 +161,14 @@ is written under the specified directory. <DD> <DT><SAMP>`--locale=<VAR>locale</VAR>´</SAMP> <DD> -<A NAME="IDX722"></A> -<A NAME="IDX723"></A> +<A NAME="IDX743"></A> +<A NAME="IDX744"></A> Specify the locale name, either a language specification of the form <VAR>ll</VAR> or a combined language and country specification of the form <VAR>ll_CC</VAR>. <DT><SAMP>`-d <VAR>directory</VAR>´</SAMP> <DD> -<A NAME="IDX724"></A> +<A NAME="IDX745"></A> Specify the base directory of <TT>`.msg´</TT> message catalogs. </DL> @@ -180,7 +180,7 @@ written in the specified directory. </P> -<H3><A NAME="SEC124" HREF="gettext_toc.html#TOC124">8.1.6 Input file interpretation</A></H3> +<H3><A NAME="SEC125" HREF="gettext_toc.html#TOC125">8.1.6 Input file interpretation</A></H3> <DL COMPACT> @@ -188,15 +188,15 @@ written in the specified directory. <DD> <DT><SAMP>`--check´</SAMP> <DD> -<A NAME="IDX725"></A> -<A NAME="IDX726"></A> +<A NAME="IDX746"></A> +<A NAME="IDX747"></A> Perform all the checks implied by <CODE>--check-format</CODE>, <CODE>--check-header</CODE>, <CODE>--check-domain</CODE>. <DT><SAMP>`--check-format´</SAMP> <DD> -<A NAME="IDX727"></A> -<A NAME="IDX728"></A> +<A NAME="IDX748"></A> +<A NAME="IDX749"></A> Check language dependent format strings. If the string represents a format string used in a @@ -215,19 +215,19 @@ used in a <CODE>printf</CODE>-like function and so <CODE>msgfmt</CODE> might rep errors where there are none. To solve this problem the programmer can dictate the decision to the -<CODE>xgettext</CODE> program (see section <A HREF="gettext_3.html#SEC17">3.4 Special Comments preceding Keywords</A>). The translator should not +<CODE>xgettext</CODE> program (see section <A HREF="gettext_3.html#SEC18">3.5 Special Comments preceding Keywords</A>). The translator should not consider removing the flag from the <KBD>#,</KBD> line. This "fix" would be reversed again as soon as <CODE>msgmerge</CODE> is called the next time. <DT><SAMP>`--check-header´</SAMP> <DD> -<A NAME="IDX729"></A> -Verify presence and contents of the header entry. See section <A HREF="gettext_5.html#SEC34">5.2 Filling in the Header Entry</A>, +<A NAME="IDX750"></A> +Verify presence and contents of the header entry. See section <A HREF="gettext_5.html#SEC35">5.2 Filling in the Header Entry</A>, for a description of the various fields in the header entry. <DT><SAMP>`--check-domain´</SAMP> <DD> -<A NAME="IDX730"></A> +<A NAME="IDX751"></A> Check for conflicts between domain directives and the <CODE>--output-file</CODE> option @@ -235,18 +235,18 @@ option <DD> <DT><SAMP>`--check-compatibility´</SAMP> <DD> -<A NAME="IDX731"></A> -<A NAME="IDX732"></A> -<A NAME="IDX733"></A> +<A NAME="IDX752"></A> +<A NAME="IDX753"></A> +<A NAME="IDX754"></A> Check that GNU msgfmt behaves like X/Open msgfmt. This will give an error when attempting to use the GNU extensions. <DT><SAMP>`--check-accelerators[=<VAR>char</VAR>]´</SAMP> <DD> -<A NAME="IDX734"></A> -<A NAME="IDX735"></A> -<A NAME="IDX736"></A> -<A NAME="IDX737"></A> +<A NAME="IDX755"></A> +<A NAME="IDX756"></A> +<A NAME="IDX757"></A> +<A NAME="IDX758"></A> 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>`&´</SAMP> character. @@ -261,9 +261,9 @@ instead of <SAMP>`&´</SAMP>. <DD> <DT><SAMP>`--use-fuzzy´</SAMP> <DD> -<A NAME="IDX738"></A> -<A NAME="IDX739"></A> -<A NAME="IDX740"></A> +<A NAME="IDX759"></A> +<A NAME="IDX760"></A> +<A NAME="IDX761"></A> 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. -<H3><A NAME="SEC125" HREF="gettext_toc.html#TOC125">8.1.7 Output details</A></H3> +<H3><A NAME="SEC126" HREF="gettext_toc.html#TOC126">8.1.7 Output details</A></H3> <DL COMPACT> @@ -280,13 +280,13 @@ a human translator. <DD> <DT><SAMP>`--alignment=<VAR>number</VAR>´</SAMP> <DD> -<A NAME="IDX741"></A> -<A NAME="IDX742"></A> +<A NAME="IDX762"></A> +<A NAME="IDX763"></A> Align strings to <VAR>number</VAR> bytes (default: 1). <DT><SAMP>`--no-hash´</SAMP> <DD> -<A NAME="IDX743"></A> +<A NAME="IDX764"></A> 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). -<H3><A NAME="SEC126" HREF="gettext_toc.html#TOC126">8.1.8 Informative output</A></H3> +<H3><A NAME="SEC127" HREF="gettext_toc.html#TOC127">8.1.8 Informative output</A></H3> <DL COMPACT> @@ -302,54 +302,54 @@ at run time (binary search instead of hash table lookup). <DD> <DT><SAMP>`--help´</SAMP> <DD> -<A NAME="IDX744"></A> -<A NAME="IDX745"></A> +<A NAME="IDX765"></A> +<A NAME="IDX766"></A> Display this help and exit. <DT><SAMP>`-V´</SAMP> <DD> <DT><SAMP>`--version´</SAMP> <DD> -<A NAME="IDX746"></A> -<A NAME="IDX747"></A> +<A NAME="IDX767"></A> +<A NAME="IDX768"></A> Output version information and exit. <DT><SAMP>`--statistics´</SAMP> <DD> -<A NAME="IDX748"></A> +<A NAME="IDX769"></A> Print statistics about translations. <DT><SAMP>`-v´</SAMP> <DD> <DT><SAMP>`--verbose´</SAMP> <DD> -<A NAME="IDX749"></A> -<A NAME="IDX750"></A> +<A NAME="IDX770"></A> +<A NAME="IDX771"></A> Increase verbosity level. </DL> -<H2><A NAME="SEC127" HREF="gettext_toc.html#TOC127">8.2 Invoking the <CODE>msgunfmt</CODE> Program</A></H2> +<H2><A NAME="SEC128" HREF="gettext_toc.html#TOC128">8.2 Invoking the <CODE>msgunfmt</CODE> Program</A></H2> <P> -<A NAME="IDX751"></A> -<A NAME="IDX752"></A> +<A NAME="IDX772"></A> +<A NAME="IDX773"></A> <PRE> msgunfmt [<VAR>option</VAR>] [<VAR>file</VAR>]... </PRE> <P> -<A NAME="IDX753"></A> +<A NAME="IDX774"></A> The <CODE>msgunfmt</CODE> program converts a binary message catalog to a Uniforum style .po file. </P> -<H3><A NAME="SEC128" HREF="gettext_toc.html#TOC128">8.2.1 Operation mode</A></H3> +<H3><A NAME="SEC129" HREF="gettext_toc.html#TOC129">8.2.1 Operation mode</A></H3> <DL COMPACT> @@ -357,22 +357,22 @@ Uniforum style .po file. <DD> <DT><SAMP>`--java´</SAMP> <DD> -<A NAME="IDX754"></A> -<A NAME="IDX755"></A> -<A NAME="IDX756"></A> +<A NAME="IDX775"></A> +<A NAME="IDX776"></A> +<A NAME="IDX777"></A> Java mode: input is a Java <CODE>ResourceBundle</CODE> class. <DT><SAMP>`--tcl´</SAMP> <DD> -<A NAME="IDX757"></A> -<A NAME="IDX758"></A> +<A NAME="IDX778"></A> +<A NAME="IDX779"></A> Tcl mode: input is a tcl/msgcat <TT>`.msg´</TT> file. </DL> -<H3><A NAME="SEC129" HREF="gettext_toc.html#TOC129">8.2.2 Input file location</A></H3> +<H3><A NAME="SEC130" HREF="gettext_toc.html#TOC130">8.2.2 Input file location</A></H3> <DL COMPACT> @@ -388,7 +388,7 @@ If no input <VAR>file</VAR> is given or if it is <SAMP>`-´</SAMP>, standar </P> -<H3><A NAME="SEC130" HREF="gettext_toc.html#TOC130">8.2.3 Input file location in Java mode</A></H3> +<H3><A NAME="SEC131" HREF="gettext_toc.html#TOC131">8.2.3 Input file location in Java mode</A></H3> <DL COMPACT> @@ -396,16 +396,16 @@ If no input <VAR>file</VAR> is given or if it is <SAMP>`-´</SAMP>, standar <DD> <DT><SAMP>`--resource=<VAR>resource</VAR>´</SAMP> <DD> -<A NAME="IDX759"></A> -<A NAME="IDX760"></A> +<A NAME="IDX780"></A> +<A NAME="IDX781"></A> Specify the resource name. <DT><SAMP>`-l <VAR>locale</VAR>´</SAMP> <DD> <DT><SAMP>`--locale=<VAR>locale</VAR>´</SAMP> <DD> -<A NAME="IDX761"></A> -<A NAME="IDX762"></A> +<A NAME="IDX782"></A> +<A NAME="IDX783"></A> Specify the locale name, either a language specification of the form <VAR>ll</VAR> or a combined language and country specification of the form <VAR>ll_CC</VAR>. @@ -418,7 +418,7 @@ separated with an underscore. The class is located using the <CODE>CLASSPATH</C </P> -<H3><A NAME="SEC131" HREF="gettext_toc.html#TOC131">8.2.4 Input file location in Tcl mode</A></H3> +<H3><A NAME="SEC132" HREF="gettext_toc.html#TOC132">8.2.4 Input file location in Tcl mode</A></H3> <DL COMPACT> @@ -426,14 +426,14 @@ separated with an underscore. The class is located using the <CODE>CLASSPATH</C <DD> <DT><SAMP>`--locale=<VAR>locale</VAR>´</SAMP> <DD> -<A NAME="IDX763"></A> -<A NAME="IDX764"></A> +<A NAME="IDX784"></A> +<A NAME="IDX785"></A> Specify the locale name, either a language specification of the form <VAR>ll</VAR> or a combined language and country specification of the form <VAR>ll_CC</VAR>. <DT><SAMP>`-d <VAR>directory</VAR>´</SAMP> <DD> -<A NAME="IDX765"></A> +<A NAME="IDX786"></A> Specify the base directory of <TT>`.msg´</TT> message catalogs. </DL> @@ -445,7 +445,7 @@ located in the specified directory. </P> -<H3><A NAME="SEC132" HREF="gettext_toc.html#TOC132">8.2.5 Output file location</A></H3> +<H3><A NAME="SEC133" HREF="gettext_toc.html#TOC133">8.2.5 Output file location</A></H3> <DL COMPACT> @@ -453,8 +453,8 @@ located in the specified directory. <DD> <DT><SAMP>`--output-file=<VAR>file</VAR>´</SAMP> <DD> -<A NAME="IDX766"></A> -<A NAME="IDX767"></A> +<A NAME="IDX787"></A> +<A NAME="IDX788"></A> Write output to specified file. </DL> @@ -466,26 +466,26 @@ or if it is <SAMP>`-´</SAMP>. </P> -<H3><A NAME="SEC133" HREF="gettext_toc.html#TOC133">8.2.6 Output details</A></H3> +<H3><A NAME="SEC134" HREF="gettext_toc.html#TOC134">8.2.6 Output details</A></H3> <DL COMPACT> <DT><SAMP>`--force-po´</SAMP> <DD> -<A NAME="IDX768"></A> +<A NAME="IDX789"></A> Always write an output file even if it contains no message. <DT><SAMP>`-i´</SAMP> <DD> <DT><SAMP>`--indent´</SAMP> <DD> -<A NAME="IDX769"></A> -<A NAME="IDX770"></A> +<A NAME="IDX790"></A> +<A NAME="IDX791"></A> Write the .po file using indented style. <DT><SAMP>`--strict´</SAMP> <DD> -<A NAME="IDX771"></A> +<A NAME="IDX792"></A> 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. <DD> <DT><SAMP>`--width=<VAR>number</VAR>´</SAMP> <DD> -<A NAME="IDX772"></A> -<A NAME="IDX773"></A> +<A NAME="IDX793"></A> +<A NAME="IDX794"></A> 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</VAR>. +<DT><SAMP>`--no-wrap´</SAMP> +<DD> +<A NAME="IDX795"></A> +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. + <DT><SAMP>`-s´</SAMP> <DD> <DT><SAMP>`--sort-output´</SAMP> <DD> -<A NAME="IDX774"></A> -<A NAME="IDX775"></A> -<A NAME="IDX776"></A> +<A NAME="IDX796"></A> +<A NAME="IDX797"></A> +<A NAME="IDX798"></A> 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. -<H3><A NAME="SEC134" HREF="gettext_toc.html#TOC134">8.2.7 Informative output</A></H3> +<H3><A NAME="SEC135" HREF="gettext_toc.html#TOC135">8.2.7 Informative output</A></H3> <DL COMPACT> @@ -522,34 +529,34 @@ for the translator to understand each message's context. <DD> <DT><SAMP>`--help´</SAMP> <DD> -<A NAME="IDX777"></A> -<A NAME="IDX778"></A> +<A NAME="IDX799"></A> +<A NAME="IDX800"></A> Display this help and exit. <DT><SAMP>`-V´</SAMP> <DD> <DT><SAMP>`--version´</SAMP> <DD> -<A NAME="IDX779"></A> -<A NAME="IDX780"></A> +<A NAME="IDX801"></A> +<A NAME="IDX802"></A> Output version information and exit. <DT><SAMP>`-v´</SAMP> <DD> <DT><SAMP>`--verbose´</SAMP> <DD> -<A NAME="IDX781"></A> -<A NAME="IDX782"></A> +<A NAME="IDX803"></A> +<A NAME="IDX804"></A> Increase verbosity level. </DL> -<H2><A NAME="SEC135" HREF="gettext_toc.html#TOC135">8.3 The Format of GNU MO Files</A></H2> +<H2><A NAME="SEC136" HREF="gettext_toc.html#TOC136">8.3 The Format of GNU MO Files</A></H2> <P> -<A NAME="IDX783"></A> -<A NAME="IDX784"></A> +<A NAME="IDX805"></A> +<A NAME="IDX806"></A> </P> <P> @@ -558,7 +565,7 @@ which appears below. </P> <P> -<A NAME="IDX785"></A> +<A NAME="IDX807"></A> 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. </P> <P> -<A NAME="IDX786"></A> +<A NAME="IDX808"></A> The size <VAR>S</VAR> 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. </P> <P> -<A NAME="IDX787"></A> +<A NAME="IDX809"></A> Plural forms are stored by letting the plural of the original string follow the singular of the original string, separated through a <KBD>NUL</KBD> byte. The length which appears in the string descriptor |