1@pindex msginit
2@cindex @code{msginit} program, usage
3@example
4msginit [@var{option}]
5@end example
6
7@cindex create new PO file
8@cindex initialize new PO file
9The @code{msginit} program creates a new PO file, initializing the meta
10information with values from the user's environment.
11
12@subsection Input file location
13
14@table @samp
15@item -i @var{inputfile}
16@itemx --input=@var{inputfile}
17@opindex -i@r{, @code{msginit} option}
18@opindex --input@r{, @code{msginit} option}
19Input POT file.
20
21@end table
22
23If no @var{inputfile} is given, the current directory is searched for the
24POT file.  If it is @samp{-}, standard input is read.
25
26@subsection Output file location
27
28@table @samp
29@item -o @var{file}
30@itemx --output-file=@var{file}
31@opindex -o@r{, @code{msginit} option}
32@opindex --output-file@r{, @code{msginit} option}
33Write output to specified PO file.
34
35@end table
36
37If no output file is given, it depends on the @samp{--locale} option or the
38user's locale setting.  If it is @samp{-}, the results are written to
39standard output.
40
41@subsection Input file syntax
42
43@table @samp
44@item -P
45@itemx --properties-input
46@opindex -P@r{, @code{msginit} option}
47@opindex --properties-input@r{, @code{msginit} option}
48Assume the input file is a Java ResourceBundle in Java @code{.properties}
49syntax, not in PO file syntax.
50
51@item --stringtable-input
52@opindex --stringtable-input@r{, @code{msginit} option}
53Assume the input file is a NeXTstep/GNUstep localized resource file in
54@code{.strings} syntax, not in PO file syntax.
55
56@end table
57
58@subsection Output details
59
60@table @samp
61@item -l @var{ll_CC}
62@itemx --locale=@var{ll_CC}
63@opindex -l@r{, @code{msginit} option}
64@opindex --locale@r{, @code{msginit} option}
65Set target locale.  @var{ll} should be a language code, and @var{CC} should
66be a country code.  The command @samp{locale -a} can be used to output a list
67of all installed locales.  The default is the user's locale setting.
68
69@item --no-translator
70@opindex --no-translator@r{, @code{msginit} option}
71Declares that the PO file will not have a human translator and is instead
72automatically generated.
73
74@item -p
75@itemx --properties-output
76@opindex -p@r{, @code{msginit} option}
77@opindex --properties-output@r{, @code{msginit} option}
78Write out a Java ResourceBundle in Java @code{.properties} syntax.  Note
79that this file format doesn't support plural forms and silently drops
80obsolete messages.
81
82@item --stringtable-output
83@opindex --stringtable-output@r{, @code{msginit} option}
84Write out a NeXTstep/GNUstep localized resource file in @code{.strings} syntax.
85Note that this file format doesn't support plural forms.
86
87@item -w @var{number}
88@itemx --width=@var{number}
89@opindex -w@r{, @code{msginit} option}
90@opindex --width@r{, @code{msginit} option}
91Set the output page width.  Long strings in the output files will be
92split across multiple lines in order to ensure that each line's width
93(= number of screen columns) is less or equal to the given @var{number}.
94
95@item --no-wrap
96@opindex --no-wrap@r{, @code{msginit} option}
97Do not break long message lines.  Message lines whose width exceeds the
98output page width will not be split into several lines.  Only file reference
99lines which are wider than the output page width will be split.
100
101@end table
102
103@subsection Informative output
104
105@table @samp
106@item -h
107@itemx --help
108@opindex -h@r{, @code{msginit} option}
109@opindex --help@r{, @code{msginit} option}
110Display this help and exit.
111
112@item -V
113@itemx --version
114@opindex -V@r{, @code{msginit} option}
115@opindex --version@r{, @code{msginit} option}
116Output version information and exit.
117
118@end table
119