Imported Upstream version 0.51.0
[platform/upstream/intltool.git] / doc / intltool-extract.8
1 .TH INTLTOOL-EXTRACT 8 "2003-08-02" "intltool"
2
3 .SH NAME
4 intltool-extract \- generate header files which can be read by gettext
5
6 .SH SYNOPSIS
7 .B intltool-extract
8 .I "[options]..." SOURCE_FILE
9
10
11 .SH DESCRIPTION
12 .B intltool-extract
13 extracts strings in the specified XML/INI type \fISOURCE_FILE\fR and writes
14 them into a C header file. Then \fBxgettext\fR(1) can merge these strings
15 inside header file into po template.
16
17 .B intltool-extract
18 is usually not executed manually, but called from \fBintltool-update\fR(8)
19 instead.
20
21 .SH OPTIONS
22 .IP "\fB\-l\fR" 4
23 .PD 0
24 .IP "\fB\-\-local\fR" 4
25 .PD
26 Creates a subdirectory under current working directory (named "\fBtmp/\fR")
27 and writes files there. This option can't be used with \fB\-\-update\fR option.
28 .IP "\fB\-\-update\fR" 4
29 .PD
30 Writes header file into the same directory the source file is in. New file
31 name is the source file name appending ".h" extension. This option can't be
32 used with
33 .BR \-l / \-\-local
34 option. Besides, this option is the default option if neither \fB\-\-local\fR
35 nor \fB\-\-update\fR is specified.
36 .IP "\fB\-\-type\fR=\fITYPE\fR" 4
37 .PD
38 Specify the type of source file. Currently supported types are:
39 .br
40 "gettext/glade" (.glade, .glade2)
41 .br
42 "gettext/gsettings" (.gschema.xml)
43 .br
44 "gettext/ini" (Generic INI file)
45 .br
46 "gettext/keys" (.keys)
47 .br
48 "gettext/rfc822deb" (RFC 822 format file)
49 .br
50 "gettext/quoted" (all strings within "")
51 .br
52 "gettext/schemas" (.schemas)
53 .br
54 "gettext/scheme" (.scm)
55 .br
56 "gettext/xml" (Generic XML file)
57 .br
58 "gettext/qtdesigner" (Qt Designer .ui files)
59 .IP "\fB\-v\fR" 4
60 .PD 0
61 .IP "\fB\-\-version\fR" 4
62 .PD
63 Show version information.
64 .IP "\fB\-h\fR" 4
65 .PD 0
66 .IP "\fB\--help\fR" 4
67 .PD
68 Show usage and basic help information.
69 .IP "\fB\-q\fR" 4
70 .PD 0
71 .IP "\fB\-\-quiet\fR" 4
72 .PD
73 Be quiet while running.
74
75 .SH REPORTING BUGS
76 Report bugs to http://bugs.launchpad.net/intltool
77
78 .SH AUTHOR
79 Darin Adler <darin@bentspoon.com>
80 .br
81 Kenneth Christiansen <kenneth@gnu.org>
82 .br
83 Maciej Stachowiak <mjs@eazel.com>
84
85
86 .SH SEE ALSO
87 .BR intltoolize (8),
88 .BR intltool-prepare (8),
89 .BR intltool-merge (8),
90 .BR intltool-update (8),
91 .BR xgettext (1)