gnu/dist/gettext/gettext-tools/doc/msginit.texi

   1 @pindex msginit
   2 @cindex @code{msginit} program, usage
   3 @example
   4 msginit [@var{option}]
   5 @end example
   6
   7 @cindex create new PO file
   8 @cindex initialize new PO file
   9 The @code{msginit} program creates a new PO file, initializing the meta
  10 information 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}
  19 Input POT file.
  20
  21 @end table
  22
  23 If no @var{inputfile} is given, the current directory is searched for the
  24 POT 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}
  33 Write output to specified PO file.
  34
  35 @end table
  36
  37 If no output file is given, it depends on the @samp{--locale} option or the
  38 user's locale setting.  If it is @samp{-}, the results are written to
  39 standard 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}
  48 Assume the input file is a Java ResourceBundle in Java @code{.properties}
  49 syntax, not in PO file syntax.
  50
  51 @item --stringtable-input
  52 @opindex --stringtable-input@r{, @code{msginit} option}
  53 Assume 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}
  65 Set target locale.  @var{ll} should be a language code, and @var{CC} should
  66 be a country code.  The command @samp{locale -a} can be used to output a list
  67 of all installed locales.  The default is the user's locale setting.
  68
  69 @item --no-translator
  70 @opindex --no-translator@r{, @code{msginit} option}
  71 Declares that the PO file will not have a human translator and is instead
  72 automatically generated.
  73
  74 @item -p
  75 @itemx --properties-output
  76 @opindex -p@r{, @code{msginit} option}
  77 @opindex --properties-output@r{, @code{msginit} option}
  78 Write out a Java ResourceBundle in Java @code{.properties} syntax.  Note
  79 that this file format doesn't support plural forms and silently drops
  80 obsolete messages.
  81
  82 @item --stringtable-output
  83 @opindex --stringtable-output@r{, @code{msginit} option}
  84 Write out a NeXTstep/GNUstep localized resource file in @code{.strings} syntax.
  85 Note 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}
  91 Set the output page width.  Long strings in the output files will be
  92 split 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}
  97 Do not break long message lines.  Message lines whose width exceeds the
  98 output page width will not be split into several lines.  Only file reference
  99 lines 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}
 110 Display 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}
 116 Output version information and exit.
 117
 118 @end table