Move doc/msginit.texi to gettext-tools/doc/msginit.texi.

1 files changed, 88 insertions, 0 deletions

diff --git a/gettext-tools/doc/msginit.texi b/gettext-tools/doc/msginit.texi
new file mode 100644
index 0000000..96aa34a
--- /dev/null
+++ b/gettext-tools/doc/msginit.texi
@@ -0,0 +1,88 @@
+@pindex msginit
+@cindex @code{msginit} program, usage
+@example
+msginit [@var{option}]
+@end example
+
+@cindex create new PO file
+@cindex initialize new PO file
+The @code{msginit} program creates a new PO file, initializing the meta
+information with values from the user's environment.
+
+@subsection Input file location
+
+@table @samp
+@item -i @var{inputfile}
+@itemx --input=@var{inputfile}
+@opindex -i@r{, @code{msginit} option}
+@opindex --input@r{, @code{msginit} option}
+Input POT file.
+
+@end table
+
+If no @var{inputfile} is given, the current directory is searched for the
+POT file.  If it is @samp{-}, standard input is read.
+
+@subsection Output file location
+
+@table @samp
+@item -o @var{file}
+@itemx --output-file=@var{file}
+@opindex -o@r{, @code{msginit} option}
+@opindex --output-file@r{, @code{msginit} option}
+Write output to specified PO file.
+
+@end table
+
+If no output file is given, it depends on the @samp{--locale} option or the
+user's locale setting.  If it is @samp{-}, the results are written to
+standard output.
+
+@subsection Output details
+
+@table @samp
+@item -l @var{ll_CC}
+@itemx --locale=@var{ll_CC}
+@opindex -l@r{, @code{msginit} option}
+@opindex --locale@r{, @code{msginit} option}
+Set target locale.  @var{ll} should be a language code, and @var{CC} should
+be a country code.  The command @samp{locale -a} can be used to output a list
+of all installed locales.  The default is the user's locale setting.
+
+@item --no-translator
+@opindex --no-translator@r{, @code{msginit} option}
+Declares that the PO file will not have a human translator and is instead
+automatically generated.
+
+@item -w @var{number}
+@itemx --width=@var{number}
+@opindex -w@r{, @code{msginit} option}
+@opindex --width@r{, @code{msginit} option}
+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}.
+
+@item --no-wrap
+@opindex --no-wrap@r{, @code{msginit} option}
+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.
+
+@end table
+
+@subsection Informative output
+
+@table @samp
+@item -h
+@itemx --help
+@opindex -h@r{, @code{msginit} option}
+@opindex --help@r{, @code{msginit} option}
+Display this help and exit.
+
+@item -V
+@itemx --version
+@opindex -V@r{, @code{msginit} option}
+@opindex --version@r{, @code{msginit} option}
+Output version information and exit.
+
+@end table