D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
proc
/
thread-self
/
root
/
opt
/
lampp
/
share
/
doc
/
gettext
/
Filename :
gettext_5.html
back
Copy
<HTML> <HEAD> <!-- This HTML file has been created by texi2html 1.52b from gettext.texi on 6 June 2010 --> <META HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8"> <TITLE>GNU gettext utilities - 5 Making the PO Template File</TITLE> </HEAD> <BODY> Go to the <A HREF="gettext_1.html">first</A>, <A HREF="gettext_4.html">previous</A>, <A HREF="gettext_6.html">next</A>, <A HREF="gettext_25.html">last</A> section, <A HREF="gettext_toc.html">table of contents</A>. <P><HR><P> <H1><A NAME="SEC27" HREF="gettext_toc.html#TOC27">5 Making the PO Template File</A></H1> <P> <A NAME="IDX158"></A> </P> <P> After preparing the sources, the programmer creates a PO template file. This section explains how to use <CODE>xgettext</CODE> for this purpose. </P> <P> <CODE>xgettext</CODE> creates a file named <TT>‘<VAR>domainname</VAR>.po’</TT>. You should then rename it to <TT>‘<VAR>domainname</VAR>.pot’</TT>. (Why doesn't <CODE>xgettext</CODE> create it under the name <TT>‘<VAR>domainname</VAR>.pot’</TT> right away? The answer is: for historical reasons. When <CODE>xgettext</CODE> was specified, the distinction between a PO file and PO file template was fuzzy, and the suffix <SAMP>‘.pot’</SAMP> wasn't in use at that time.) </P> <H2><A NAME="SEC28" HREF="gettext_toc.html#TOC28">5.1 Invoking the <CODE>xgettext</CODE> Program</A></H2> <P> <A NAME="IDX159"></A> <A NAME="IDX160"></A> <PRE> xgettext [<VAR>option</VAR>] [<VAR>inputfile</VAR>] ... </PRE> <P> The <CODE>xgettext</CODE> program extracts translatable strings from given input files. </P> <H3><A NAME="SEC29" HREF="gettext_toc.html#TOC29">5.1.1 Input file location</A></H3> <DL COMPACT> <DT><SAMP>‘<VAR>inputfile</VAR> ...’</SAMP> <DD> Input files. <DT><SAMP>‘-f <VAR>file</VAR>’</SAMP> <DD> <DT><SAMP>‘--files-from=<VAR>file</VAR>’</SAMP> <DD> <A NAME="IDX161"></A> <A NAME="IDX162"></A> Read the names of the input files from <VAR>file</VAR> instead of getting them from the command line. <DT><SAMP>‘-D <VAR>directory</VAR>’</SAMP> <DD> <DT><SAMP>‘--directory=<VAR>directory</VAR>’</SAMP> <DD> <A NAME="IDX163"></A> <A NAME="IDX164"></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. </DL> <P> If <VAR>inputfile</VAR> is <SAMP>‘-’</SAMP>, standard input is read. </P> <H3><A NAME="SEC30" HREF="gettext_toc.html#TOC30">5.1.2 Output file location</A></H3> <DL COMPACT> <DT><SAMP>‘-d <VAR>name</VAR>’</SAMP> <DD> <DT><SAMP>‘--default-domain=<VAR>name</VAR>’</SAMP> <DD> <A NAME="IDX165"></A> <A NAME="IDX166"></A> Use <TT>‘<VAR>name</VAR>.po’</TT> for output (instead of <TT>‘messages.po’</TT>). <DT><SAMP>‘-o <VAR>file</VAR>’</SAMP> <DD> <DT><SAMP>‘--output=<VAR>file</VAR>’</SAMP> <DD> <A NAME="IDX167"></A> <A NAME="IDX168"></A> Write output to specified file (instead of <TT>‘<VAR>name</VAR>.po’</TT> or <TT>‘messages.po’</TT>). <DT><SAMP>‘-p <VAR>dir</VAR>’</SAMP> <DD> <DT><SAMP>‘--output-dir=<VAR>dir</VAR>’</SAMP> <DD> <A NAME="IDX169"></A> <A NAME="IDX170"></A> Output files will be placed in directory <VAR>dir</VAR>. </DL> <P> <A NAME="IDX171"></A> If the output <VAR>file</VAR> is <SAMP>‘-’</SAMP> or <SAMP>‘/dev/stdout’</SAMP>, the output is written to standard output. </P> <H3><A NAME="SEC31" HREF="gettext_toc.html#TOC31">5.1.3 Choice of input file language</A></H3> <DL COMPACT> <DT><SAMP>‘-L <VAR>name</VAR>’</SAMP> <DD> <DT><SAMP>‘--language=<VAR>name</VAR>’</SAMP> <DD> <A NAME="IDX172"></A> <A NAME="IDX173"></A> <A NAME="IDX174"></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>Scheme</CODE>, <CODE>Smalltalk</CODE>, <CODE>Java</CODE>, <CODE>JavaProperties</CODE>, <CODE>C#</CODE>, <CODE>awk</CODE>, <CODE>YCP</CODE>, <CODE>Tcl</CODE>, <CODE>Perl</CODE>, <CODE>PHP</CODE>, <CODE>GCC-source</CODE>, <CODE>NXStringTable</CODE>, <CODE>RST</CODE>, <CODE>Glade</CODE>. <DT><SAMP>‘-C’</SAMP> <DD> <DT><SAMP>‘--c++’</SAMP> <DD> <A NAME="IDX175"></A> <A NAME="IDX176"></A> This is a shorthand for <CODE>--language=C++</CODE>. </DL> <P> By default the language is guessed depending on the input file name extension. </P> <H3><A NAME="SEC32" HREF="gettext_toc.html#TOC32">5.1.4 Input file interpretation</A></H3> <DL COMPACT> <DT><SAMP>‘--from-code=<VAR>name</VAR>’</SAMP> <DD> <A NAME="IDX177"></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 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="SEC33" HREF="gettext_toc.html#TOC33">5.1.5 Operation mode</A></H3> <DL COMPACT> <DT><SAMP>‘-j’</SAMP> <DD> <DT><SAMP>‘--join-existing’</SAMP> <DD> <A NAME="IDX178"></A> <A NAME="IDX179"></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="IDX180"></A> <A NAME="IDX181"></A> Entries from <VAR>file</VAR> are not extracted. <VAR>file</VAR> should be a PO or POT file. <DT><SAMP>‘-c[<VAR>tag</VAR>]’</SAMP> <DD> <DT><SAMP>‘--add-comments[=<VAR>tag</VAR>]’</SAMP> <DD> <A NAME="IDX182"></A> <A NAME="IDX183"></A> Place comment blocks starting with <VAR>tag</VAR> and preceding keyword lines in the output file. Without a <VAR>tag</VAR>, the option means to put <EM>all</EM> comment blocks preceding keyword lines in the output file. </DL> <H3><A NAME="SEC34" HREF="gettext_toc.html#TOC34">5.1.6 Language specific options</A></H3> <DL COMPACT> <DT><SAMP>‘-a’</SAMP> <DD> <DT><SAMP>‘--extract-all’</SAMP> <DD> <A NAME="IDX184"></A> <A NAME="IDX185"></A> Extract all strings. This option has an effect with most languages, namely C, C++, ObjectiveC, Shell, Python, Lisp, EmacsLisp, librep, Java, C#, awk, Tcl, Perl, PHP, GCC-source, Glade. <DT><SAMP>‘-k[<VAR>keywordspec</VAR>]’</SAMP> <DD> <DT><SAMP>‘--keyword[=<VAR>keywordspec</VAR>]’</SAMP> <DD> <A NAME="IDX186"></A> <A NAME="IDX187"></A> Specify <VAR>keywordspec</VAR> as an additional keyword to be looked for. Without a <VAR>keywordspec</VAR>, the option means to not use default keywords. <A NAME="IDX188"></A> <A NAME="IDX189"></A> If <VAR>keywordspec</VAR> is a C identifier <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 <SAMP>‘<VAR>id</VAR>:<VAR>argnum</VAR>’</SAMP>, <CODE>xgettext</CODE> looks for strings in the <VAR>argnum</VAR>th argument of the call. If <VAR>keywordspec</VAR> is of the form <SAMP>‘<VAR>id</VAR>:<VAR>argnum1</VAR>,<VAR>argnum2</VAR>’</SAMP>, <CODE>xgettext</CODE> looks for strings in the <VAR>argnum1</VAR>st argument and in the <VAR>argnum2</VAR>nd argument of the call, and treats them as singular/plural variants for a message with plural handling. Also, if <VAR>keywordspec</VAR> is of the form <SAMP>‘<VAR>id</VAR>:<VAR>contextargnum</VAR>c,<VAR>argnum</VAR>’</SAMP> or <SAMP>‘<VAR>id</VAR>:<VAR>argnum</VAR>,<VAR>contextargnum</VAR>c’</SAMP>, <CODE>xgettext</CODE> treats strings in the <VAR>contextargnum</VAR>th argument as a context specifier. And, as a special-purpose support for GNOME, if <VAR>keywordspec</VAR> is of the form <SAMP>‘<VAR>id</VAR>:<VAR>argnum</VAR>g’</SAMP>, <CODE>xgettext</CODE> recognizes the <VAR>argnum</VAR>th argument as a string with context, using the GNOME <CODE>glib</CODE> syntax <SAMP>‘"msgctxt|msgid"’</SAMP>. <BR> Furthermore, if <VAR>keywordspec</VAR> is of the form <SAMP>‘<VAR>id</VAR>:...,<VAR>totalnumargs</VAR>t’</SAMP>, <CODE>xgettext</CODE> recognizes this argument specification only if the number of actual arguments is equal to <VAR>totalnumargs</VAR>. This is useful for disambiguating overloaded function calls in C++. <BR> Finally, if <VAR>keywordspec</VAR> is of the form <SAMP>‘<VAR>id</VAR>:<VAR>argnum</VAR>...,"<VAR>xcomment</VAR>"’</SAMP>, <CODE>xgettext</CODE>, when extracting a message from the specified argument strings, adds an extracted comment <VAR>xcomment</VAR> to the message. Note that when used through a normal shell command line, the double-quotes around the <VAR>xcomment</VAR> need to be escaped. This option has an effect with most languages, namely C, C++, ObjectiveC, Shell, Python, Lisp, EmacsLisp, librep, Java, C#, awk, Tcl, Perl, PHP, GCC-source, Glade. The default keyword specifications, which are always looked for if not explicitly disabled, are language dependent. They are: <UL> <LI> For C, C++, and GCC-source: <CODE>gettext</CODE>, <CODE>dgettext:2</CODE>, <CODE>dcgettext:2</CODE>, <CODE>ngettext:1,2</CODE>, <CODE>dngettext:2,3</CODE>, <CODE>dcngettext:2,3</CODE>, <CODE>gettext_noop</CODE>, and <CODE>pgettext:1c,2</CODE>, <CODE>dpgettext:2c,3</CODE>, <CODE>dcpgettext:2c,3</CODE>, <CODE>npgettext:1c,2,3</CODE>, <CODE>dnpgettext:2c,3,4</CODE>, <CODE>dcnpgettext:2c,3,4</CODE>. <LI> For Objective C: Like for C, and also <CODE>NSLocalizedString</CODE>, <CODE>_</CODE>, <CODE>NSLocalizedStaticString</CODE>, <CODE>__</CODE>. <LI> For Shell scripts: <CODE>gettext</CODE>, <CODE>ngettext:1,2</CODE>, <CODE>eval_gettext</CODE>, <CODE>eval_ngettext:1,2</CODE>. <LI> For Python: <CODE>gettext</CODE>, <CODE>ugettext</CODE>, <CODE>dgettext:2</CODE>, <CODE>ngettext:1,2</CODE>, <CODE>ungettext:1,2</CODE>, <CODE>dngettext:2,3</CODE>, <CODE>_</CODE>. <LI> For Lisp: <CODE>gettext</CODE>, <CODE>ngettext:1,2</CODE>, <CODE>gettext-noop</CODE>. <LI> For EmacsLisp: <CODE>_</CODE>. <LI> For librep: <CODE>_</CODE>. <LI> For Scheme: <CODE>gettext</CODE>, <CODE>ngettext:1,2</CODE>, <CODE>gettext-noop</CODE>. <LI> For Java: <CODE>GettextResource.gettext:2</CODE>, <CODE>GettextResource.ngettext:2,3</CODE>, <CODE>GettextResource.pgettext:2c,3</CODE>, <CODE>GettextResource.npgettext:2c,3,4</CODE>, <CODE>gettext</CODE>, <CODE>ngettext:1,2</CODE>, <CODE>pgettext:1c,2</CODE>, <CODE>npgettext:1c,2,3</CODE>, <CODE>getString</CODE>. <LI> For C#: <CODE>GetString</CODE>, <CODE>GetPluralString:1,2</CODE>, <CODE>GetParticularString:1c,2</CODE>, <CODE>GetParticularPluralString:1c,2,3</CODE>. <LI> For awk: <CODE>dcgettext</CODE>, <CODE>dcngettext:1,2</CODE>. <LI> For Tcl: <CODE>::msgcat::mc</CODE>. <LI> For Perl: <CODE>gettext</CODE>, <CODE>%gettext</CODE>, <CODE>$gettext</CODE>, <CODE>dgettext:2</CODE>, <CODE>dcgettext:2</CODE>, <CODE>ngettext:1,2</CODE>, <CODE>dngettext:2,3</CODE>, <CODE>dcngettext:2,3</CODE>, <CODE>gettext_noop</CODE>. <LI> For PHP: <CODE>_</CODE>, <CODE>gettext</CODE>, <CODE>dgettext:2</CODE>, <CODE>dcgettext:2</CODE>, <CODE>ngettext:1,2</CODE>, <CODE>dngettext:2,3</CODE>, <CODE>dcngettext:2,3</CODE>. <LI> For Glade 1: <CODE>label</CODE>, <CODE>title</CODE>, <CODE>text</CODE>, <CODE>format</CODE>, <CODE>copyright</CODE>, <CODE>comments</CODE>, <CODE>preview_text</CODE>, <CODE>tooltip</CODE>. </UL> To disable the default keyword specifications, the option <SAMP>‘-k’</SAMP> or <SAMP>‘--keyword’</SAMP> or <SAMP>‘--keyword=’</SAMP>, without a <VAR>keywordspec</VAR>, can be used. <DT><SAMP>‘--flag=<VAR>word</VAR>:<VAR>arg</VAR>:<VAR>flag</VAR>’</SAMP> <DD> <A NAME="IDX190"></A> Specifies additional flags for strings occurring as part of the <VAR>arg</VAR>th argument of the function <VAR>word</VAR>. The possible flags are the possible format string indicators, such as <SAMP>‘c-format’</SAMP>, and their negations, such as <SAMP>‘no-c-format’</SAMP>, possibly prefixed with <SAMP>‘pass-’</SAMP>. <BR> <A NAME="IDX191"></A> The meaning of <CODE>--flag=<VAR>function</VAR>:<VAR>arg</VAR>:<VAR>lang</VAR>-format</CODE> is that in language <VAR>lang</VAR>, the specified <VAR>function</VAR> expects as <VAR>arg</VAR>th argument a format string. (For those of you familiar with GCC function attributes, <CODE>--flag=<VAR>function</VAR>:<VAR>arg</VAR>:c-format</CODE> is roughly equivalent to the declaration <SAMP>‘__attribute__ ((__format__ (__printf__, <VAR>arg</VAR>, ...)))’</SAMP> attached to <VAR>function</VAR> in a C source file.) For example, if you use the <SAMP>‘error’</SAMP> function from GNU libc, you can specify its behaviour through <CODE>--flag=error:3:c-format</CODE>. The effect of this specification is that <CODE>xgettext</CODE> will mark as format strings all <CODE>gettext</CODE> invocations that occur as <VAR>arg</VAR>th argument of <VAR>function</VAR>. This is useful when such strings contain no format string directives: together with the checks done by <SAMP>‘msgfmt -c’</SAMP> it will ensure that translators cannot accidentally use format string directives that would lead to a crash at runtime. <BR> <A NAME="IDX192"></A> The meaning of <CODE>--flag=<VAR>function</VAR>:<VAR>arg</VAR>:pass-<VAR>lang</VAR>-format</CODE> is that in language <VAR>lang</VAR>, if the <VAR>function</VAR> call occurs in a position that must yield a format string, then its <VAR>arg</VAR>th argument must yield a format string of the same type as well. (If you know GCC function attributes, the <CODE>--flag=<VAR>function</VAR>:<VAR>arg</VAR>:pass-c-format</CODE> option is roughly equivalent to the declaration <SAMP>‘__attribute__ ((__format_arg__ (<VAR>arg</VAR>)))’</SAMP> attached to <VAR>function</VAR> in a C source file.) For example, if you use the <SAMP>‘_’</SAMP> shortcut for the <CODE>gettext</CODE> function, you should use <CODE>--flag=_:1:pass-c-format</CODE>. The effect of this specification is that <CODE>xgettext</CODE> will propagate a format string requirement for a <CODE>_("string")</CODE> call to its first argument, the literal <CODE>"string"</CODE>, and thus mark it as a format string. This is useful when such strings contain no format string directives: together with the checks done by <SAMP>‘msgfmt -c’</SAMP> it will ensure that translators cannot accidentally use format string directives that would lead to a crash at runtime. <BR> This option has an effect with most languages, namely C, C++, ObjectiveC, Shell, Python, Lisp, EmacsLisp, librep, Scheme, Java, C#, awk, YCP, Tcl, Perl, PHP, GCC-source. <DT><SAMP>‘-T’</SAMP> <DD> <DT><SAMP>‘--trigraphs’</SAMP> <DD> <A NAME="IDX193"></A> <A NAME="IDX194"></A> <A NAME="IDX195"></A> Understand ANSI C trigraphs for input. <BR> This option has an effect only with the languages C, C++, ObjectiveC. <DT><SAMP>‘--qt’</SAMP> <DD> <A NAME="IDX196"></A> <A NAME="IDX197"></A> Recognize Qt format strings. <BR> This option has an effect only with the language C++. <DT><SAMP>‘--kde’</SAMP> <DD> <A NAME="IDX198"></A> <A NAME="IDX199"></A> Recognize KDE 4 format strings. <BR> This option has an effect only with the language C++. <DT><SAMP>‘--boost’</SAMP> <DD> <A NAME="IDX200"></A> <A NAME="IDX201"></A> Recognize Boost format strings. <BR> This option has an effect only with the language C++. <DT><SAMP>‘--debug’</SAMP> <DD> <A NAME="IDX202"></A> <A NAME="IDX203"></A> Use the flags <CODE>c-format</CODE> and <CODE>possible-c-format</CODE> 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 the programmer prescribed it. By default only the <CODE>c-format</CODE> form is used. The translator should not have to care about these details. </DL> <P> This implementation of <CODE>xgettext</CODE> is able to process a few awkward cases, like strings in preprocessor macros, ANSI concatenation of adjacent strings, and escaped end of lines for continued strings. </P> <H3><A NAME="SEC35" HREF="gettext_toc.html#TOC35">5.1.7 Output details</A></H3> <DL COMPACT> <DT><SAMP>‘--color’</SAMP> <DD> <DT><SAMP>‘--color=<VAR>when</VAR>’</SAMP> <DD> <A NAME="IDX204"></A> Specify whether or when to use colors and other text attributes. See section <A HREF="gettext_9.html#SEC150">9.11.1 The <CODE>--color</CODE> option</A> for details. <DT><SAMP>‘--style=<VAR>style_file</VAR>’</SAMP> <DD> <A NAME="IDX205"></A> Specify the CSS style rule file to use for <CODE>--color</CODE>. See section <A HREF="gettext_9.html#SEC152">9.11.3 The <CODE>--style</CODE> option</A> for details. <DT><SAMP>‘--force-po’</SAMP> <DD> <A NAME="IDX206"></A> Always write an output file even if no message is defined. <DT><SAMP>‘-i’</SAMP> <DD> <DT><SAMP>‘--indent’</SAMP> <DD> <A NAME="IDX207"></A> <A NAME="IDX208"></A> Write the .po file using indented style. <DT><SAMP>‘--no-location’</SAMP> <DD> <A NAME="IDX209"></A> Do not write <SAMP>‘#: <VAR>filename</VAR>:<VAR>line</VAR>’</SAMP> lines. Note that using this option makes it harder for technically skilled translators to understand each message's context. <DT><SAMP>‘-n’</SAMP> <DD> <DT><SAMP>‘--add-location’</SAMP> <DD> <A NAME="IDX210"></A> <A NAME="IDX211"></A> Generate <SAMP>‘#: <VAR>filename</VAR>:<VAR>line</VAR>’</SAMP> lines (default). <DT><SAMP>‘--strict’</SAMP> <DD> <A NAME="IDX212"></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. <DT><SAMP>‘--properties-output’</SAMP> <DD> <A NAME="IDX213"></A> Write out a Java ResourceBundle in Java <CODE>.properties</CODE> syntax. Note that this file format doesn't support plural forms and silently drops obsolete messages. <DT><SAMP>‘--stringtable-output’</SAMP> <DD> <A NAME="IDX214"></A> Write out a NeXTstep/GNUstep localized resource file in <CODE>.strings</CODE> syntax. Note that this file format doesn't support plural forms. <DT><SAMP>‘-w <VAR>number</VAR>’</SAMP> <DD> <DT><SAMP>‘--width=<VAR>number</VAR>’</SAMP> <DD> <A NAME="IDX215"></A> <A NAME="IDX216"></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="IDX217"></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="IDX218"></A> <A NAME="IDX219"></A> <A NAME="IDX220"></A> Generate sorted output. Note that using this option makes it much harder for the translator to understand each message's context. <DT><SAMP>‘-F’</SAMP> <DD> <DT><SAMP>‘--sort-by-file’</SAMP> <DD> <A NAME="IDX221"></A> <A NAME="IDX222"></A> Sort output by file location. <DT><SAMP>‘--omit-header’</SAMP> <DD> <A NAME="IDX223"></A> Don't write header with <SAMP>‘msgid ""’</SAMP> entry. <A NAME="IDX224"></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 options at different times are guaranteed to produce the same results. Note that using this option will lead to an error if the resulting file would not entirely be in ASCII. <DT><SAMP>‘--copyright-holder=<VAR>string</VAR>’</SAMP> <DD> <A NAME="IDX225"></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 holder of the package.) Translators are expected to transfer or disclaim the copyright for their translations, so that package maintainers can distribute them without legal risk. If <VAR>string</VAR> is empty, the output files are marked as being in the public domain; in this case, the translators are expected to disclaim their copyright, again so that package maintainers can distribute them without legal risk. The default value for <VAR>string</VAR> is the Free Software Foundation, Inc., simply because <CODE>xgettext</CODE> was first used in the GNU project. <DT><SAMP>‘--foreign-user’</SAMP> <DD> <A NAME="IDX226"></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. <DT><SAMP>‘--package-name=<VAR>package</VAR>’</SAMP> <DD> <A NAME="IDX227"></A> Set the package name in the header of the output. <DT><SAMP>‘--package-version=<VAR>version</VAR>’</SAMP> <DD> <A NAME="IDX228"></A> Set the package version in the header of the output. This option has an effect only if the <SAMP>‘--package-name’</SAMP> option is also used. <DT><SAMP>‘--msgid-bugs-address=<VAR>email@address</VAR>’</SAMP> <DD> <A NAME="IDX229"></A> Set the reporting address for msgid bugs. This is the email address or URL to which the translators shall report bugs in the untranslated strings: <UL> <LI>Strings which are not entire sentences, see the maintainer guidelines in section <A HREF="gettext_4.html#SEC19">4.3 Preparing Translatable Strings</A>. <LI>Strings which use unclear terms or require additional context to be understood. <LI>Strings which make invalid assumptions about notation of date, time or money. <LI>Pluralisation problems. <LI>Incorrect English spelling. <LI>Incorrect formatting. </UL> It can be your email address, or a mailing list address where translators can write to without being subscribed, or the URL of a web page through which the translators can contact you. The default value is empty, which means that translators will be clueless! Don't forget to specify this option. <DT><SAMP>‘-m[<VAR>string</VAR>]’</SAMP> <DD> <DT><SAMP>‘--msgstr-prefix[=<VAR>string</VAR>]’</SAMP> <DD> <A NAME="IDX230"></A> <A NAME="IDX231"></A> Use <VAR>string</VAR> (or "" if not specified) as prefix for msgstr values. <DT><SAMP>‘-M[<VAR>string</VAR>]’</SAMP> <DD> <DT><SAMP>‘--msgstr-suffix[=<VAR>string</VAR>]’</SAMP> <DD> <A NAME="IDX232"></A> <A NAME="IDX233"></A> Use <VAR>string</VAR> (or "" if not specified) as suffix for msgstr values. </DL> <H3><A NAME="SEC36" HREF="gettext_toc.html#TOC36">5.1.8 Informative output</A></H3> <DL COMPACT> <DT><SAMP>‘-h’</SAMP> <DD> <DT><SAMP>‘--help’</SAMP> <DD> <A NAME="IDX234"></A> <A NAME="IDX235"></A> Display this help and exit. <DT><SAMP>‘-V’</SAMP> <DD> <DT><SAMP>‘--version’</SAMP> <DD> <A NAME="IDX236"></A> <A NAME="IDX237"></A> Output version information and exit. </DL> <P><HR><P> Go to the <A HREF="gettext_1.html">first</A>, <A HREF="gettext_4.html">previous</A>, <A HREF="gettext_6.html">next</A>, <A HREF="gettext_25.html">last</A> section, <A HREF="gettext_toc.html">table of contents</A>. </BODY> </HTML>