mirror of
https://github.com/php-win-ext/gettext.git
synced 2026-03-26 01:52:07 +01:00
390 lines
11 KiB
HTML
390 lines
11 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<!-- This HTML file has been created by texi2html 1.52b
|
|
from gettext.texi on 7 July 2013 -->
|
|
|
|
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8">
|
|
<TITLE>GNU gettext utilities - 7 Updating Existing PO Files</TITLE>
|
|
</HEAD>
|
|
<BODY>
|
|
Go to the <A HREF="gettext_1.html">first</A>, <A HREF="gettext_6.html">previous</A>, <A HREF="gettext_8.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="SEC45" HREF="gettext_toc.html#TOC45">7 Updating Existing PO Files</A></H1>
|
|
|
|
|
|
|
|
<H2><A NAME="SEC46" HREF="gettext_toc.html#TOC46">7.1 Invoking the <CODE>msgmerge</CODE> Program</A></H2>
|
|
|
|
<P>
|
|
<A NAME="IDX282"></A>
|
|
<A NAME="IDX283"></A>
|
|
|
|
<PRE>
|
|
msgmerge [<VAR>option</VAR>] <VAR>def</VAR>.po <VAR>ref</VAR>.pot
|
|
</PRE>
|
|
|
|
<P>
|
|
The <CODE>msgmerge</CODE> program merges two Uniforum style .po files together.
|
|
The <VAR>def</VAR>.po file is an existing PO file with translations which will
|
|
be taken over to the newly created file as long as they still match;
|
|
comments will be preserved, but extracted comments and file positions will
|
|
be discarded. The <VAR>ref</VAR>.pot file is the last created PO file with
|
|
up-to-date source references but old translations, or a PO Template file
|
|
(generally created by <CODE>xgettext</CODE>); any translations or comments
|
|
in the file will be discarded, however dot comments and file positions
|
|
will be preserved. Where an exact match cannot be found, fuzzy matching
|
|
is used to produce better results.
|
|
|
|
</P>
|
|
|
|
|
|
<H3><A NAME="SEC47" HREF="gettext_toc.html#TOC47">7.1.1 Input file location</A></H3>
|
|
|
|
<DL COMPACT>
|
|
|
|
<DT><SAMP>‘<VAR>def</VAR>.po’</SAMP>
|
|
<DD>
|
|
Translations referring to old sources.
|
|
|
|
<DT><SAMP>‘<VAR>ref</VAR>.pot’</SAMP>
|
|
<DD>
|
|
References to the new sources.
|
|
|
|
<DT><SAMP>‘-D <VAR>directory</VAR>’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--directory=<VAR>directory</VAR>’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX284"></A>
|
|
<A NAME="IDX285"></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.
|
|
|
|
<DT><SAMP>‘-C <VAR>file</VAR>’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--compendium=<VAR>file</VAR>’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX286"></A>
|
|
<A NAME="IDX287"></A>
|
|
Specify an additional library of message translations. See section <A HREF="gettext_8.html#SEC72">8.4 Using Translation Compendia</A>.
|
|
This option may be specified more than once.
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
<H3><A NAME="SEC48" HREF="gettext_toc.html#TOC48">7.1.2 Operation mode</A></H3>
|
|
|
|
<DL COMPACT>
|
|
|
|
<DT><SAMP>‘-U’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--update’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX288"></A>
|
|
<A NAME="IDX289"></A>
|
|
Update <VAR>def</VAR>.po. Do nothing if <VAR>def</VAR>.po is already up to date.
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
<H3><A NAME="SEC49" HREF="gettext_toc.html#TOC49">7.1.3 Output file location</A></H3>
|
|
|
|
<DL COMPACT>
|
|
|
|
<DT><SAMP>‘-o <VAR>file</VAR>’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--output-file=<VAR>file</VAR>’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX290"></A>
|
|
<A NAME="IDX291"></A>
|
|
Write output to specified file.
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
<A NAME="IDX292"></A>
|
|
The results are written to standard output if no output file is specified
|
|
or if it is <SAMP>‘-’</SAMP>.
|
|
|
|
</P>
|
|
|
|
|
|
<H3><A NAME="SEC50" HREF="gettext_toc.html#TOC50">7.1.4 Output file location in update mode</A></H3>
|
|
|
|
<P>
|
|
The result is written back to <VAR>def</VAR>.po.
|
|
|
|
</P>
|
|
<DL COMPACT>
|
|
|
|
<DT><SAMP>‘--backup=<VAR>control</VAR>’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX293"></A>
|
|
<A NAME="IDX294"></A>
|
|
Make a backup of <VAR>def</VAR>.po
|
|
|
|
<DT><SAMP>‘--suffix=<VAR>suffix</VAR>’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX295"></A>
|
|
Override the usual backup suffix.
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
<A NAME="IDX296"></A>
|
|
The version control method may be selected via the <CODE>--backup</CODE> option
|
|
or through the <CODE>VERSION_CONTROL</CODE> environment variable. Here are the
|
|
values:
|
|
|
|
</P>
|
|
<DL COMPACT>
|
|
|
|
<DT><SAMP>‘none’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘off’</SAMP>
|
|
<DD>
|
|
Never make backups (even if <CODE>--backup</CODE> is given).
|
|
|
|
<DT><SAMP>‘numbered’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘t’</SAMP>
|
|
<DD>
|
|
Make numbered backups.
|
|
|
|
<DT><SAMP>‘existing’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘nil’</SAMP>
|
|
<DD>
|
|
Make numbered backups if numbered backups for this file already exist,
|
|
otherwise make simple backups.
|
|
|
|
<DT><SAMP>‘simple’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘never’</SAMP>
|
|
<DD>
|
|
Always make simple backups.
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
The backup suffix is <SAMP>‘~’</SAMP>, unless set with <CODE>--suffix</CODE> or the
|
|
<CODE>SIMPLE_BACKUP_SUFFIX</CODE> environment variable.
|
|
|
|
</P>
|
|
|
|
|
|
<H3><A NAME="SEC51" HREF="gettext_toc.html#TOC51">7.1.5 Operation modifiers</A></H3>
|
|
|
|
<DL COMPACT>
|
|
|
|
<DT><SAMP>‘-m’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--multi-domain’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX297"></A>
|
|
<A NAME="IDX298"></A>
|
|
Apply <VAR>ref</VAR>.pot to each of the domains in <VAR>def</VAR>.po.
|
|
|
|
<DT><SAMP>‘-N’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--no-fuzzy-matching’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX299"></A>
|
|
<A NAME="IDX300"></A>
|
|
Do not use fuzzy matching when an exact match is not found. This may speed
|
|
up the operation considerably.
|
|
|
|
<DT><SAMP>‘--previous’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX301"></A>
|
|
Keep the previous msgids of translated messages, marked with <SAMP>‘#|’</SAMP>, when
|
|
adding the fuzzy marker to such messages.
|
|
</DL>
|
|
|
|
|
|
|
|
<H3><A NAME="SEC52" HREF="gettext_toc.html#TOC52">7.1.6 Input file syntax</A></H3>
|
|
|
|
<DL COMPACT>
|
|
|
|
<DT><SAMP>‘-P’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--properties-input’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX302"></A>
|
|
<A NAME="IDX303"></A>
|
|
Assume the input files are Java ResourceBundles in Java <CODE>.properties</CODE>
|
|
syntax, not in PO file syntax.
|
|
|
|
<DT><SAMP>‘--stringtable-input’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX304"></A>
|
|
Assume the input files are NeXTstep/GNUstep localized resource files in
|
|
<CODE>.strings</CODE> syntax, not in PO file syntax.
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
<H3><A NAME="SEC53" HREF="gettext_toc.html#TOC53">7.1.7 Output details</A></H3>
|
|
|
|
<DL COMPACT>
|
|
|
|
<DT><SAMP>‘--lang=<VAR>catalogname</VAR>’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX305"></A>
|
|
Specify the <SAMP>‘Language’</SAMP> field to be used in the header entry. See
|
|
section <A HREF="gettext_6.html#SEC44">6.2 Filling in the Header Entry</A> for the meaning of this field. Note: The
|
|
<SAMP>‘Language-Team’</SAMP> and <SAMP>‘Plural-Forms’</SAMP> fields are left unchanged.
|
|
If this option is not specified, the <SAMP>‘Language’</SAMP> field is inferred, as
|
|
best as possible, from the <SAMP>‘Language-Team’</SAMP> field.
|
|
|
|
<DT><SAMP>‘--color’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--color=<VAR>when</VAR>’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX306"></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="IDX307"></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="IDX308"></A>
|
|
Always write an output file even if it contains no message.
|
|
|
|
<DT><SAMP>‘-i’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--indent’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX309"></A>
|
|
<A NAME="IDX310"></A>
|
|
Write the .po file using indented style.
|
|
|
|
<DT><SAMP>‘--no-location’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX311"></A>
|
|
Do not write <SAMP>‘#: <VAR>filename</VAR>:<VAR>line</VAR>’</SAMP> lines.
|
|
|
|
<DT><SAMP>‘--add-location’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX312"></A>
|
|
Generate <SAMP>‘#: <VAR>filename</VAR>:<VAR>line</VAR>’</SAMP> lines (default).
|
|
|
|
<DT><SAMP>‘--strict’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX313"></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>‘-p’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--properties-output’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX314"></A>
|
|
<A NAME="IDX315"></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="IDX316"></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="IDX317"></A>
|
|
<A NAME="IDX318"></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="IDX319"></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="IDX320"></A>
|
|
<A NAME="IDX321"></A>
|
|
<A NAME="IDX322"></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="IDX323"></A>
|
|
<A NAME="IDX324"></A>
|
|
Sort output by file location.
|
|
|
|
</DL>
|
|
|
|
|
|
|
|
<H3><A NAME="SEC54" HREF="gettext_toc.html#TOC54">7.1.8 Informative output</A></H3>
|
|
|
|
<DL COMPACT>
|
|
|
|
<DT><SAMP>‘-h’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--help’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX325"></A>
|
|
<A NAME="IDX326"></A>
|
|
Display this help and exit.
|
|
|
|
<DT><SAMP>‘-V’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--version’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX327"></A>
|
|
<A NAME="IDX328"></A>
|
|
Output version information and exit.
|
|
|
|
<DT><SAMP>‘-v’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--verbose’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX329"></A>
|
|
<A NAME="IDX330"></A>
|
|
Increase verbosity level.
|
|
|
|
<DT><SAMP>‘-q’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--quiet’</SAMP>
|
|
<DD>
|
|
<DT><SAMP>‘--silent’</SAMP>
|
|
<DD>
|
|
<A NAME="IDX331"></A>
|
|
<A NAME="IDX332"></A>
|
|
<A NAME="IDX333"></A>
|
|
Suppress progress indicators.
|
|
|
|
</DL>
|
|
|
|
<P><HR><P>
|
|
Go to the <A HREF="gettext_1.html">first</A>, <A HREF="gettext_6.html">previous</A>, <A HREF="gettext_8.html">next</A>, <A HREF="gettext_25.html">last</A> section, <A HREF="gettext_toc.html">table of contents</A>.
|
|
</BODY>
|
|
</HTML>
|