gettext: msgcat Invocation

1 
1 9.1 Invoking the ‘msgcat’ Program
1 =================================
1 
1      msgcat [OPTION] [INPUTFILE]...
1 
1    The ‘msgcat’ program concatenates and merges the specified PO files.
1 It finds messages which are common to two or more of the specified PO
1 files.  By using the ‘--more-than’ option, greater commonality may be
1 requested before messages are printed.  Conversely, the ‘--less-than’
1 option may be used to specify less commonality before messages are
1 printed (i.e. ‘--less-than=2’ will only print the unique messages).
1 Translations, comments, extracted comments, and file positions will be
1 cumulated, except that if ‘--use-first’ is specified, they will be taken
1 from the first PO file to define them.
1 
1 9.1.1 Input file location
1 -------------------------
1 
1 ‘INPUTFILE …’
1      Input files.
1 
1 ‘-f FILE’
1 ‘--files-from=FILE’
1      Read the names of the input files from FILE instead of getting them
1      from the command line.
1 
1 ‘-D DIRECTORY’
1 ‘--directory=DIRECTORY’
1      Add DIRECTORY to the list of directories.  Source files are
1      searched relative to this list of directories.  The resulting ‘.po’
1      file will be written relative to the current directory, though.
1 
1    If INPUTFILE is ‘-’, standard input is read.
1 
1 9.1.2 Output file location
1 --------------------------
1 
1 ‘-o FILE’
1 ‘--output-file=FILE’
1      Write output to specified file.
1 
1    The results are written to standard output if no output file is
1 specified or if it is ‘-’.
1 
1 9.1.3 Message selection
1 -----------------------
1 
1 ‘-< NUMBER’
1 ‘--less-than=NUMBER’
1      Print messages with less than NUMBER definitions, defaults to
1      infinite if not set.
1 
1 ‘-> NUMBER’
1 ‘--more-than=NUMBER’
1      Print messages with more than NUMBER definitions, defaults to 0 if
1      not set.
1 
1 ‘-u’
1 ‘--unique’
1      Shorthand for ‘--less-than=2’.  Requests that only unique messages
1      be printed.
1 
1 9.1.4 Input file syntax
1 -----------------------
1 
1 ‘-P’
1 ‘--properties-input’
1      Assume the input files are Java ResourceBundles in Java
1      ‘.properties’ syntax, not in PO file syntax.
1 
1 ‘--stringtable-input’
1      Assume the input files are NeXTstep/GNUstep localized resource
1      files in ‘.strings’ syntax, not in PO file syntax.
1 
1 9.1.5 Output details
1 --------------------
1 
1 ‘-t’
1 ‘--to-code=NAME’
1      Specify encoding for output.
1 
1 ‘--use-first’
1      Use first available translation for each message.  Don’t merge
1      several translations into one.
1 
1 ‘--lang=CATALOGNAME’
1      Specify the ‘Language’ field to be used in the header entry.  See
1      ⇒Header Entry for the meaning of this field.  Note: The
1      ‘Language-Team’ and ‘Plural-Forms’ fields are left unchanged.
1 
1 ‘--color’
1 ‘--color=WHEN’
1      Specify whether or when to use colors and other text attributes.
1      See ⇒The --color option for details.
1 
1 ‘--style=STYLE_FILE’
11      Specify the CSS style rule file to use for ‘--color’.  See ⇒
      The --style option for details.
1 
1 ‘--force-po’
1      Always write an output file even if it contains no message.
1 
1 ‘-i’
1 ‘--indent’
1      Write the .po file using indented style.
1 
1 ‘--no-location’
1      Do not write ‘#: FILENAME:LINE’ lines.
1 
1 ‘-n’
1 ‘--add-location=TYPE’
1      Generate ‘#: FILENAME:LINE’ lines (default).
1 
1      The optional TYPE can be either ‘full’, ‘file’, or ‘never’.  If it
1      is not given or ‘full’, it generates the lines with both file name
1      and line number.  If it is ‘file’, the line number part is omitted.
1      If it is ‘never’, it completely suppresses the lines (same as
1      ‘--no-location’).
1 
1 ‘--strict’
1      Write out a strict Uniforum conforming PO file.  Note that this
1      Uniforum format should be avoided because it doesn’t support the
1      GNU extensions.
1 
1 ‘-p’
1 ‘--properties-output’
1      Write out a Java ResourceBundle in Java ‘.properties’ syntax.  Note
1      that this file format doesn’t support plural forms and silently
1      drops obsolete messages.
1 
1 ‘--stringtable-output’
1      Write out a NeXTstep/GNUstep localized resource file in ‘.strings’
1      syntax.  Note that this file format doesn’t support plural forms.
1 
1 ‘-w NUMBER’
1 ‘--width=NUMBER’
1      Set the output page width.  Long strings in the output files will
1      be split across multiple lines in order to ensure that each line’s
1      width (= number of screen columns) is less or equal to the given
1      NUMBER.
1 
1 ‘--no-wrap’
1      Do not break long message lines.  Message lines whose width exceeds
1      the output page width will not be split into several lines.  Only
1      file reference lines which are wider than the output page width
1      will be split.
1 
1 ‘-s’
1 ‘--sort-output’
1      Generate sorted output.  Note that using this option makes it much
1      harder for the translator to understand each message’s context.
1 
1 ‘-F’
1 ‘--sort-by-file’
1      Sort output by file location.
1 
1 9.1.6 Informative output
1 ------------------------
1 
1 ‘-h’
1 ‘--help’
1      Display this help and exit.
1 
1 ‘-V’
1 ‘--version’
1      Output version information and exit.
1