summaryrefslogtreecommitdiff
path: root/doc/intltool-merge.8
blob: c87cb9f711226470a7049fd74955c49a8247cb3b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
.TH INTLTOOL-MERGE 8 "2003-08-02" "intltool"

.SH NAME
intltool-merge \- merge translated strings into various types of file

.SH SYNOPSIS
.B "intltool-merge"
.I "[option]..." PO_DIRECTORY FILENAME OUTPUT_FILE


.SH DESCRIPTION
.PP
Merge translated strings in po files in \fIPO_DIRECTORY\fR with the original
application file \fIFILENAME\fR, and output the file \fIOUTPUT_FILE\fR
containing both original and localized strings.
.PP
If \fIFILENAME\fR is an XML file, \fIOUTPUT_FILE\fR will contain repeated
xml nodes, where each node contains one of the localized strings with
"xml:lang" attribute.


.SH OPTIONS
.\" -------------------------------------------------------
.SS "Mode of operation"
.\" -------------------------------------------------------
.IP "\fB\-b\fR" 4
.PD 0
.IP "\fB\-\-ba-style\fR" 4
.PD
Merge files in bonobo-activation style, which is used for bonobo servers.
.IP "\fB\-d\fR" 4
.PD 0
.IP "\fB\-\-desktop-style\fR" 4
.PD
Merge files in desktop style, which is similar to the Windows .ini file format.
.IP "\fB\-k\fR" 4
.PD 0
.IP "\fB\-\-keys-style\fR" 4
.PD
Merge files in keys style, which is used for metadata.
.IP "\fB\-o\fR" 4
.PD 0
.IP "\fB\-\-oaf-style\fR" 4
.PD
(OBSOLETE) Same as
.BR \-b / \-\-ba-style "."
.IP "\fB\-r\fR" 4
.PD 0
.IP "\fB\-\-rfc822deb-style\fR" 4
.PD
Merge files in RFC 822 style, which is usually used in Debian configuration files.
.IP "\fB\-\-quoted-style\fR" 4
.PD
Merge files in quoted string style, which just translates any strings within "".
.IP "\fB\-x\fR" 4
.PD 0
.IP "\fB\-\-xml-style\fR" 4
.PD
Merge files in standard XML style, both as attributes and as raw pcdata.

.\" -------------------------------------------------------
.SS "Other options"
.\" -------------------------------------------------------
.IP "\fB\-u\fR" 4
.PD 0
.IP "\fB\-\-utf8\fR" 4
.PD
Convert all strings to UTF-8 before merging.
.IP "\fB\-p\fR" 4
.PD 0
.IP "\fB\-\-pass-through\fR" 4
.PD
Use strings as is in .po files without conversion (STRONGLY unrecommended
with \-x).
.IP "\fB\-c\fR" 4
.PD 0
.IP "\fB\-\-cache\fR" 4
.PD
(TBD)
.IP "\fB\-q\fR" 4
.PD 0
.IP "\fB\-\-quiet\fR" 4
.PD
Be quiet while running.
.IP "\fB\-v\fR" 4
.PD 0
.IP "\fB\-\-version\fR" 4
.PD
Show version information.
.IP "\fB\-h\fR" 4
.PD 0
.IP "\fB\-\-help\fR" 4
.PD
Show usage and basic help information.


.SH FILES
.IP "\fBpo/.intltool-merge-cache\fR"
Cache file generated by \fBintltool-merge\fR, that contains all strings
in all po files separated by \\01.


.SH REPORTING BUGS
Report bugs to http://bugs.launchpad.net/intltool


.SH AUTHOR
Darin Adler <darin@bentspoon.com>
.br
Kenneth Christiansen <kenneth@gnu.org>
.br
Maciej Stachowiak <mjs@eazel.com>


.SH SEE ALSO
.BR iconv (1),
.BR intltoolize (8),
.BR intltool-prepare (8),
.BR intltool-extract (8),
.BR intltool-update (8)