diff options
author | Bruno Haible <bruno@clisp.org> | 2003-01-08 14:04:10 +0000 |
---|---|---|
committer | Bruno Haible <bruno@clisp.org> | 2009-06-23 12:08:53 +0200 |
commit | 4c5ed5d978b18eb84f2abf4299970022cea84d00 (patch) | |
tree | a316775e7bc82c14d9cf3a2ba9727e8342cff481 /doc/gettext_4.html | |
parent | a64dc96e9b4af3f9355569a26bfa8836ace5cda2 (diff) | |
download | external_gettext-4c5ed5d978b18eb84f2abf4299970022cea84d00.zip external_gettext-4c5ed5d978b18eb84f2abf4299970022cea84d00.tar.gz external_gettext-4c5ed5d978b18eb84f2abf4299970022cea84d00.tar.bz2 |
Regenerated.
Diffstat (limited to 'doc/gettext_4.html')
-rw-r--r-- | doc/gettext_4.html | 84 |
1 files changed, 52 insertions, 32 deletions
diff --git a/doc/gettext_4.html b/doc/gettext_4.html index 00b3baa..026c851 100644 --- a/doc/gettext_4.html +++ b/doc/gettext_4.html @@ -1,7 +1,7 @@ <HTML> <HEAD> <!-- This HTML file has been created by texi2html 1.52a - from gettext.texi on 24 July 2002 --> + from gettext.texi on 5 November 2002 --> <TITLE>GNU gettext utilities - 4 Making the PO Template File</TITLE> </HEAD> @@ -136,8 +136,8 @@ is written to standard output. <A NAME="IDX165"></A> Specifies the language of the input files. The supported languages are <CODE>C</CODE>, <CODE>C++</CODE>, <CODE>ObjectiveC</CODE>, <CODE>PO</CODE>, <CODE>Python</CODE>, -<CODE>Lisp</CODE>, <CODE>EmacsLisp</CODE>, <CODE>librep</CODE>, <CODE>Java</CODE>, <CODE>awk</CODE>, -<CODE>YCP</CODE>, <CODE>Tcl</CODE>, <CODE>RST</CODE>, <CODE>Glade</CODE>. +<CODE>Lisp</CODE>, <CODE>EmacsLisp</CODE>, <CODE>librep</CODE>, <CODE>Smalltalk</CODE>, <CODE>Java</CODE>, +<CODE>awk</CODE>, <CODE>YCP</CODE>, <CODE>Tcl</CODE>, <CODE>PHP</CODE>, <CODE>RST</CODE>, <CODE>Glade</CODE>. <DT><SAMP>`-C´</SAMP> <DD> @@ -156,7 +156,27 @@ extension. </P> -<H3><A NAME="SEC25" HREF="gettext_toc.html#TOC25">4.1.4 Operation mode</A></H3> +<H3><A NAME="SEC25" HREF="gettext_toc.html#TOC25">4.1.4 Input file interpretation</A></H3> + +<DL COMPACT> + +<DT><SAMP>`--from-code=<VAR>name</VAR>´</SAMP> +<DD> +<A NAME="IDX168"></A> +Specifies the encoding of the input files. This option is needed only +if some untranslated message strings or their corresponding comments +contain non-ASCII characters. Note that Python, Tcl, and Glade input +files are always assumed to be in UTF-8, regardless of this option. + +</DL> + +<P> +By default the input files are assumed to be in ASCII. + +</P> + + +<H3><A NAME="SEC26" HREF="gettext_toc.html#TOC26">4.1.5 Operation mode</A></H3> <DL COMPACT> @@ -164,16 +184,16 @@ extension. <DD> <DT><SAMP>`--join-existing´</SAMP> <DD> -<A NAME="IDX168"></A> <A NAME="IDX169"></A> +<A NAME="IDX170"></A> Join messages with existing file. <DT><SAMP>`-x <VAR>file</VAR>´</SAMP> <DD> <DT><SAMP>`--exclude-file=<VAR>file</VAR>´</SAMP> <DD> -<A NAME="IDX170"></A> <A NAME="IDX171"></A> +<A NAME="IDX172"></A> Entries from <VAR>file</VAR> are not extracted. <VAR>file</VAR> should be a PO or POT file. @@ -181,8 +201,8 @@ POT file. <DD> <DT><SAMP>`--add-comments[=<VAR>tag</VAR>]´</SAMP> <DD> -<A NAME="IDX172"></A> <A NAME="IDX173"></A> +<A NAME="IDX174"></A> Place comment block with <VAR>tag</VAR> (or those preceding keyword lines) in output file. @@ -190,7 +210,7 @@ in output file. -<H3><A NAME="SEC26" HREF="gettext_toc.html#TOC26">4.1.5 Language=C/C++ specific options</A></H3> +<H3><A NAME="SEC27" HREF="gettext_toc.html#TOC27">4.1.6 Language=C/C++ specific options</A></H3> <DL COMPACT> @@ -198,20 +218,20 @@ in output file. <DD> <DT><SAMP>`--extract-all´</SAMP> <DD> -<A NAME="IDX174"></A> <A NAME="IDX175"></A> +<A NAME="IDX176"></A> Extract all strings. <DT><SAMP>`-k <VAR>keywordspec</VAR>´</SAMP> <DD> <DT><SAMP>`--keyword[=<VAR>keywordspec</VAR>]´</SAMP> <DD> -<A NAME="IDX176"></A> <A NAME="IDX177"></A> +<A NAME="IDX178"></A> Additional keyword to be looked for (without <VAR>keywordspec</VAR> means not to use default keywords). -<A NAME="IDX178"></A> +<A NAME="IDX179"></A> If <VAR>keywordspec</VAR> is a C identifer <VAR>id</VAR>, <CODE>xgettext</CODE> looks for strings in the first argument of each call to the function or macro <VAR>id</VAR>. If <VAR>keywordspec</VAR> is of the form @@ -231,15 +251,15 @@ explicitly disabled, are <CODE>gettext</CODE>, <CODE>dgettext:2</CODE>, <DD> <DT><SAMP>`--trigraphs´</SAMP> <DD> -<A NAME="IDX179"></A> <A NAME="IDX180"></A> <A NAME="IDX181"></A> +<A NAME="IDX182"></A> Understand ANSI C trigraphs for input. <DT><SAMP>`--debug´</SAMP> <DD> -<A NAME="IDX182"></A> <A NAME="IDX183"></A> +<A NAME="IDX184"></A> Use the flags <KBD>c-format</KBD> and <KBD>possible-c-format</KBD> to show who was responsible for marking a message as a format string. The latter form is used if the <CODE>xgettext</CODE> program decided, the format form is used if @@ -258,39 +278,39 @@ adjacent strings, and escaped end of lines for continued strings. </P> -<H3><A NAME="SEC27" HREF="gettext_toc.html#TOC27">4.1.6 Output details</A></H3> +<H3><A NAME="SEC28" HREF="gettext_toc.html#TOC28">4.1.7 Output details</A></H3> <DL COMPACT> <DT><SAMP>`--force-po´</SAMP> <DD> -<A NAME="IDX184"></A> +<A NAME="IDX185"></A> Always write an output file even if no message is defined. <DT><SAMP>`-i´</SAMP> <DD> <DT><SAMP>`--indent´</SAMP> <DD> -<A NAME="IDX185"></A> <A NAME="IDX186"></A> +<A NAME="IDX187"></A> Write the .po file using indented style. <DT><SAMP>`--no-location´</SAMP> <DD> -<A NAME="IDX187"></A> +<A NAME="IDX188"></A> Do not write <SAMP>`#: <VAR>filename</VAR>:<VAR>line</VAR>´</SAMP> lines. <DT><SAMP>`-n´</SAMP> <DD> <DT><SAMP>`--add-location´</SAMP> <DD> -<A NAME="IDX188"></A> <A NAME="IDX189"></A> +<A NAME="IDX190"></A> Generate <SAMP>`#: <VAR>filename</VAR>:<VAR>line</VAR>´</SAMP> lines (default). <DT><SAMP>`--strict´</SAMP> <DD> -<A NAME="IDX190"></A> +<A NAME="IDX191"></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. @@ -299,15 +319,15 @@ GNU extensions. <DD> <DT><SAMP>`--width=<VAR>number</VAR>´</SAMP> <DD> -<A NAME="IDX191"></A> <A NAME="IDX192"></A> +<A NAME="IDX193"></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="IDX193"></A> +<A NAME="IDX194"></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. @@ -316,9 +336,9 @@ lines which are wider than the output page width will be split. <DD> <DT><SAMP>`--sort-output´</SAMP> <DD> -<A NAME="IDX194"></A> <A NAME="IDX195"></A> <A NAME="IDX196"></A> +<A NAME="IDX197"></A> Generate sorted output. Note that using this option makes it much harder for the translator to understand each message's context. @@ -326,16 +346,16 @@ for the translator to understand each message's context. <DD> <DT><SAMP>`--sort-by-file´</SAMP> <DD> -<A NAME="IDX197"></A> <A NAME="IDX198"></A> +<A NAME="IDX199"></A> Sort output by file location. <DT><SAMP>`--omit-header´</SAMP> <DD> -<A NAME="IDX199"></A> +<A NAME="IDX200"></A> Don't write header with <SAMP>`msgid ""´</SAMP> entry. -<A NAME="IDX200"></A> +<A NAME="IDX201"></A> This is useful for testing purposes because it eliminates a source of variance for generated <CODE>.gmo</CODE> files. With <CODE>--omit-header</CODE>, two invocations of <CODE>xgettext</CODE> on the same files with the same @@ -343,7 +363,7 @@ options at different times are guaranteed to produce the same results. <DT><SAMP>`--copyright-holder=<VAR>string</VAR>´</SAMP> <DD> -<A NAME="IDX201"></A> +<A NAME="IDX202"></A> Set the copyright holder in the output. <VAR>string</VAR> should be the copyright holder of the surrounding package. (Note that the msgstr strings, extracted from the package's sources, belong to the copyright @@ -359,7 +379,7 @@ simply because <CODE>xgettext</CODE> was first used in the GNU project. <DT><SAMP>`--foreign-user´</SAMP> <DD> -<A NAME="IDX202"></A> +<A NAME="IDX203"></A> Omit FSF copyright in output. This option is equivalent to <SAMP>`--copyright-holder="´</SAMP>. It can be useful for packages outside the GNU project that want their translations to be in the public domain. @@ -368,23 +388,23 @@ project that want their translations to be in the public domain. <DD> <DT><SAMP>`--msgstr-prefix[=<VAR>string</VAR>]´</SAMP> <DD> -<A NAME="IDX203"></A> <A NAME="IDX204"></A> +<A NAME="IDX205"></A> Use <VAR>string</VAR> (or "" if not specified) as prefix for msgstr entries. <DT><SAMP>`-M [<VAR>string</VAR>]´</SAMP> <DD> <DT><SAMP>`--msgstr-suffix[=<VAR>string</VAR>]´</SAMP> <DD> -<A NAME="IDX205"></A> <A NAME="IDX206"></A> +<A NAME="IDX207"></A> Use <VAR>string</VAR> (or "" if not specified) as suffix for msgstr entries. </DL> -<H3><A NAME="SEC28" HREF="gettext_toc.html#TOC28">4.1.7 Informative output</A></H3> +<H3><A NAME="SEC29" HREF="gettext_toc.html#TOC29">4.1.8 Informative output</A></H3> <DL COMPACT> @@ -392,16 +412,16 @@ Use <VAR>string</VAR> (or "" if not specified) as suffix for msgstr entries. <DD> <DT><SAMP>`--help´</SAMP> <DD> -<A NAME="IDX207"></A> <A NAME="IDX208"></A> +<A NAME="IDX209"></A> Display this help and exit. <DT><SAMP>`-V´</SAMP> <DD> <DT><SAMP>`--version´</SAMP> <DD> -<A NAME="IDX209"></A> <A NAME="IDX210"></A> +<A NAME="IDX211"></A> Output version information and exit. </DL> |