OS Manuals

/usr/bin/msgfilter

GNU locale utilities

From gettext 1.0-r8 (os), captured 2026-11-05 by running msgfilter --help (exit 0). permalink

Usage: /usr/bin/msgfilter [OPTION] FILTER [FILTER-OPTION]

Applies a filter to all translations of a translation catalog.

Mandatory arguments to long options are mandatory for short options too.

Input file location:
  -i, --input=INPUTFILE       input PO file
  -D, --directory=DIRECTORY   add DIRECTORY to list for input files search
If no input file is given or if it is -, standard input is read.

Output file location:
  -o, --output-file=FILE      write output to specified file
The results are written to standard output if no output file is specified
or if it is -.

The FILTER can be any program that reads a translation from standard input
and writes a modified translation to standard output.

Filter input and output:
  --newline                   add a newline at the end of input and
                                remove a newline from the end of output
Useful FILTER-OPTIONs when the FILTER is 'sed':
  -e, --expression=SCRIPT     add SCRIPT to the commands to be executed
  -f, --file=SCRIPTFILE       add the contents of SCRIPTFILE to the commands
                                to be executed
  -n, --quiet, --silent       suppress automatic printing of pattern space

Input file syntax:
  -P, --properties-input      input file is in Java .properties syntax
      --stringtable-input     input file is in NeXTstep/GNUstep .strings syntax

Output details:
      --color                 use colors and other text attributes always
      --color=WHEN            use colors and other text attributes if WHEN.
                              WHEN may be 'always', 'never', 'auto', or 'html'.
      --style=STYLEFILE       specify CSS style rule file for --color
      --no-escape             do not use C escapes in output (default)
  -E, --escape                use C escapes in output, no extended chars
      --force-po              write PO file even if empty
      --indent                indented output style
      --keep-header           keep header entry unmodified, don't filter it
      --no-location           suppress '#: filename:line' lines
  -n, --add-location          preserve '#: filename:line' lines (default)
      --strict                strict Uniforum output style
  -p, --properties-output     write out a Java .properties file
      --stringtable-output    write out a NeXTstep/GNUstep .strings file
  -w, --width=NUMBER          set output page width
      --no-wrap               do not break long message lines, longer than
                              the output page width, into several lines
  -s, --sort-output           generate sorted output
  -F, --sort-by-file          sort output by file location

Informative output:
  -h, --help                  display this help and exit
  -V, --version               output version information and exit

Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext>
or by email to <bug-gettext@gnu.org>.
Options (26)
OptionDescriptionSource
-i, --input INPUTFILEinput PO filehelp + man
-D, --directory DIRECTORYadd DIRECTORY to list for input files searchhelp + man
-o, --output-file FILEwrite output to specified filehelp + man
--newlineadd a newline at the end of input and remove a newline from the end of outputhelp + man
-e, --expression SCRIPTadd SCRIPT to the commands to be executedhelp + man
-f, --file SCRIPTFILEadd the contents of SCRIPTFILE to the commands to be executedhelp + man
-n, --quiet, --silentsuppress automatic printing of pattern spacehelp + man
-P, --properties-inputinput file is in Java .properties syntaxhelp + man
--stringtable-inputinput file is in NeXTstep/GNUstep .strings syntaxhelp + man
--coloruse colors and other text attributes alwayshelp + man
--style STYLEFILEspecify CSS style rule file for --colorhelp + man
--no-escapedo not use C escapes in output (default)help + man
-E, --escapeuse C escapes in output, no extended charshelp + man
--force-powrite PO file even if emptyhelp + man
--indentindented output stylehelp + man
--keep-headerkeep header entry unmodified, don't filter ithelp + man
--no-locationsuppress '#: filename:line' lineshelp + man
--strictstrict Uniforum output stylehelp + man
-p, --properties-outputwrite out a Java .properties filehelp + man
--stringtable-outputwrite out a NeXTstep/GNUstep .strings filehelp + man
-w, --width NUMBERset output page widthhelp + man
--no-wrapdo not break long message lines, longer than the output page width, into several lineshelp + man
-s, --sort-outputgenerate sorted outputhelp + man
-F, --sort-by-filesort output by file locationhelp + man
-h, --helpdisplay this help and exithelp + man
-V, --versionoutput version information and exithelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.