doc/intltool-merge.8

   1 .TH INTLTOOL-MERGE 8 "2003-08-02" "intltool"
   2
   3 .SH NAME
   4 intltool-merge \- merge translated strings into various types of file
   5
   6 .SH SYNOPSIS
   7 .B "intltool-merge"
   8 .I "[option]..." PO_DIRECTORY FILENAME OUTPUT_FILE
   9
  10
  11 .SH DESCRIPTION
  12 .PP
  13 Merge translated strings in po files in \fIPO_DIRECTORY\fR with the original
  14 application file \fIFILENAME\fR, and output the file \fIOUTPUT_FILE\fR
  15 containing both original and localized strings.
  16 .PP
  17 If \fIFILENAME\fR is an XML file, \fIOUTPUT_FILE\fR will contain repeated
  18 xml nodes, where each node contains one of the localized strings with
  19 "xml:lang" attribute.
  20
  21
  22 .SH OPTIONS
  23 .\" -------------------------------------------------------
  24 .SS "Mode of operation"
  25 .\" -------------------------------------------------------
  26 .IP "\fB\-b\fR" 4
  27 .PD 0
  28 .IP "\fB\-\-ba-style\fR" 4
  29 .PD
  30 Merge files in bonobo-activation style, which is used for bonobo servers.
  31 .IP "\fB\-d\fR" 4
  32 .PD 0
  33 .IP "\fB\-\-desktop-style\fR" 4
  34 .PD
  35 Merge files in desktop style, which is similar to the Windows .ini file format.
  36 .IP "\fB\-k\fR" 4
  37 .PD 0
  38 .IP "\fB\-\-keys-style\fR" 4
  39 .PD
  40 Merge files in keys style, which is used for metadata.
  41 .IP "\fB\-o\fR" 4
  42 .PD 0
  43 .IP "\fB\-\-oaf-style\fR" 4
  44 .PD
  45 (OBSOLETE) Same as
  46 .BR \-b / \-\-ba-style "."
  47 .IP "\fB\-r\fR" 4
  48 .PD 0
  49 .IP "\fB\-\-rfc822deb-style\fR" 4
  50 .PD
  51 Merge files in RFC 822 style, which is usually used in Debian configuration files.
  52 .IP "\fB\-\-quoted-style\fR" 4
  53 .PD
  54 Merge files in quoted string style, which just translates any strings within "".
  55 .IP "\fB\-x\fR" 4
  56 .PD 0
  57 .IP "\fB\-\-xml-style\fR" 4
  58 .PD
  59 Merge files in standard XML style, both as attributes and as raw pcdata.
  60
  61 .\" -------------------------------------------------------
  62 .SS "Other options"
  63 .\" -------------------------------------------------------
  64 .IP "\fB\-u\fR" 4
  65 .PD 0
  66 .IP "\fB\-\-utf8\fR" 4
  67 .PD
  68 Convert all strings to UTF-8 before merging.
  69 .IP "\fB\-p\fR" 4
  70 .PD 0
  71 .IP "\fB\-\-pass-through\fR" 4
  72 .PD
  73 Use strings as is in .po files without conversion (STRONGLY unrecommended
  74 with \-x).
  75 .IP "\fB\-c\fR" 4
  76 .PD 0
  77 .IP "\fB\-\-cache\fR" 4
  78 .PD
  79 (TBD)
  80 .IP "\fB\-q\fR" 4
  81 .PD 0
  82 .IP "\fB\-\-quiet\fR" 4
  83 .PD
  84 Be quiet while running.
  85 .IP "\fB\-v\fR" 4
  86 .PD 0
  87 .IP "\fB\-\-version\fR" 4
  88 .PD
  89 Show version information.
  90 .IP "\fB\-h\fR" 4
  91 .PD 0
  92 .IP "\fB\-\-help\fR" 4
  93 .PD
  94 Show usage and basic help information.
  95
  96
  97 .SH FILES
  98 .IP "\fBpo/.intltool-merge-cache\fR"
  99 Cache file generated by \fBintltool-merge\fR, that contains all strings
 100 in all po files separated by \\01.
 101
 102
 103 .SH REPORTING BUGS
 104 Report bugs to http://bugs.launchpad.net/intltool
 105
 106
 107 .SH AUTHOR
 108 Darin Adler <darin@bentspoon.com>
 109 .br
 110 Kenneth Christiansen <kenneth@gnu.org>
 111 .br
 112 Maciej Stachowiak <mjs@eazel.com>
 113
 114
 115 .SH SEE ALSO
 116 .BR iconv (1),
 117 .BR intltoolize (8),
 118 .BR intltool-prepare (8),
 119 .BR intltool-extract (8),
 120 .BR intltool-update (8)