OS Manuals

/usr/bin/msggrep

GNU locale utilities

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

Usage: /usr/bin/msggrep [OPTION] [INPUTFILE]

Extracts all messages of a translation catalog that match a given pattern
or belong to some given source files.

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

Input file location:
  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 -.

Message selection:
  [-N SOURCEFILE]... [-M DOMAINNAME]...
  [-J MSGCTXT-PATTERN] [-K MSGID-PATTERN] [-T MSGSTR-PATTERN]
  [-C COMMENT-PATTERN] [-X EXTRACTED-COMMENT-PATTERN]
  [-W WORKFLOW-FLAG] [-S STICKY-FLAG]
A message is selected if it comes from one of the specified source files,
or if it comes from one of the specified domains,
or if -J is given and its context (msgctxt) matches MSGCTXT-PATTERN,
or if -K is given and its key (msgid or msgid_plural) matches MSGID-PATTERN,
or if -T is given and its translation (msgstr) matches MSGSTR-PATTERN,
or if -C is given and the translator's comment matches COMMENT-PATTERN,
or if -X is given and the extracted comment matches EXTRACTED-COMMENT-PATTERN,
or if -W is given and its flags contain WORKFLOW-FLAG,
or if -S is given and its flags contain STICKY-FLAG.

When more than one selection criterion is specified, the set of selected
messages is the union of the selected messages of each criterion.

MSGCTXT-PATTERN or MSGID-PATTERN or MSGSTR-PATTERN or COMMENT-PATTERN or
EXTRACTED-COMMENT-PATTERN syntax:
  [-E | -F] [-e PATTERN | -f FILE]...
PATTERNs are basic regular expressions by default, or extended regular
expressions if -E is given, or fixed strings if -F is given.

  -N, --location=SOURCEFILE   select messages extracted from SOURCEFILE
  -M, --domain=DOMAINNAME     select messages belonging to domain DOMAINNAME
  -J, --msgctxt               start of patterns for the msgctxt
  -K, --msgid                 start of patterns for the msgid
  -T, --msgstr                start of patterns for the msgstr
  -C, --comment               start of patterns for the translator's comment
  -X, --extracted-comment     start of patterns for the extracted comment
  -E, --extended-regexp       PATTERN is an extended regular expression
  -F, --fixed-strings         PATTERN is a set of newline-separated strings
  -e, --regexp=PATTERN        use PATTERN as a regular expression
  -f, --file=FILE             obtain PATTERN from FILE
  -i, --ignore-case           ignore case distinctions
  -W, --workflow-flag=FLAG    select messages with FLAG
  -S, --sticky-flag=FLAG      select messages with FLAG
  -v, --invert-match          output only the messages that do not match any
                              selection criterion

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)
      --escape                use C escapes in output, no extended chars
      --force-po              write PO file even if empty
      --indent                indented output style
      --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
      --sort-output           generate sorted output
      --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 (36)
OptionDescriptionSource
-D, --directory DIRECTORYadd DIRECTORY to list for input files searchhelp + man
-o, --output-file FILEwrite output to specified filehelp + man
-N, --location SOURCEFILEselect messages extracted from SOURCEFILEhelp + man
-M, --domain DOMAINNAMEselect messages belonging to domain DOMAINNAMEhelp + man
-J, --msgctxtstart of patterns for the msgctxthelp + man
-K, --msgidstart of patterns for the msgidhelp + man
-T, --msgstrstart of patterns for the msgstrhelp + man
-C, --commentstart of patterns for the translator's commenthelp + man
-X, --extracted-commentstart of patterns for the extracted commenthelp + man
-E, --extended-regexpPATTERN is an extended regular expressionhelp + man
-F, --fixed-stringsPATTERN is a set of newline-separated stringshelp + man
-e, --regexp PATTERNuse PATTERN as a regular expressionhelp + man
-f, --file FILEobtain PATTERN from FILEhelp + man
-i, --ignore-caseignore case distinctionshelp + man
-W, --workflow-flag FLAGselect messages with FLAGhelp + man
-S, --sticky-flag FLAGselect messages with FLAGhelp + man
-v, --invert-matchoutput only the messages that do not match any selection criterionhelp + 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
--escapeuse C escapes in output, no extended charshelp + man
--force-powrite PO file even if emptyhelp + man
--indentindented output stylehelp + man
--no-locationsuppress '#: filename:line' lineshelp + man
-n, --add-locationpreserve '#: filename:line' lines (default)help + 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
--sort-outputgenerate sorted outputhelp + man
--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.