msggrep - jpayne@68: pattern matching on message catalog
jpayne@68: jpayne@68:msggrep jpayne@68: [OPTION] [INPUTFILE]
jpayne@68: jpayne@68:Extracts all jpayne@68: messages of a translation catalog that match a given pattern jpayne@68: or belong to some given source files.
jpayne@68: jpayne@68:Mandatory jpayne@68: arguments to long options are mandatory for short options jpayne@68: too.
jpayne@68: jpayne@68:Input file
jpayne@68: location:
jpayne@68: INPUTFILE
input PO file
jpayne@68: jpayne@68:-D, jpayne@68: --directory=DIRECTORY
jpayne@68: jpayne@68:add DIRECTORY to list for input jpayne@68: files search
jpayne@68: jpayne@68:If no input jpayne@68: file is given or if it is -, standard input is jpayne@68: read.
jpayne@68: jpayne@68:Output file
jpayne@68: location:
jpayne@68: -o,
jpayne@68: --output-file=FILE
write output to specified jpayne@68: file
jpayne@68: jpayne@68:The results are jpayne@68: written to standard output if no output file is specified or jpayne@68: if it is -.
jpayne@68: jpayne@68:Message jpayne@68: selection:
jpayne@68: jpayne@68:[-N SOURCEFILE]... jpayne@68: [-M DOMAINNAME]... [-J MSGCTXT-PATTERN] jpayne@68: [-K MSGID-PATTERN] [-T jpayne@68: MSGSTR-PATTERN] [-C COMMENT-PATTERN] jpayne@68: [-X EXTRACTED-COMMENT-PATTERN]
jpayne@68: jpayne@68:A message is jpayne@68: selected if it comes from one of the specified source files, jpayne@68: or if it comes from one of the specified domains, or if jpayne@68: -J is given and its context (msgctxt) matches jpayne@68: MSGCTXT-PATTERN, or if -K is given and jpayne@68: its key (msgid or msgid_plural) matches MSGID-PATTERN, jpayne@68: or if -T is given and its translation (msgstr) jpayne@68: matches MSGSTR-PATTERN, or if -C is given jpayne@68: and the translator’s comment matches jpayne@68: COMMENT-PATTERN, or if -X is given and jpayne@68: the extracted comment matches jpayne@68: EXTRACTED-COMMENT-PATTERN.
jpayne@68: jpayne@68:When more than jpayne@68: one selection criterion is specified, the set of selected jpayne@68: messages is the union of the selected messages of each jpayne@68: criterion.
jpayne@68: jpayne@68: jpayne@68:MSGCTXT-PATTERN jpayne@68: or MSGID-PATTERN or MSGSTR-PATTERN or jpayne@68: COMMENT-PATTERN or jpayne@68: EXTRACTED-COMMENT-PATTERN syntax:
jpayne@68: jpayne@68:[-E | jpayne@68: -F] [-e PATTERN | -f jpayne@68: FILE]...
jpayne@68: jpayne@68:PATTERNs are
jpayne@68: basic regular expressions by default, or extended regular
jpayne@68: expressions if -E is given, or fixed strings if
jpayne@68: -F is given.
jpayne@68: -N,
jpayne@68: --location=SOURCEFILE
select messages extracted from jpayne@68: SOURCEFILE
jpayne@68: jpayne@68:-M, jpayne@68: --domain=DOMAINNAME
jpayne@68: jpayne@68:select messages belonging to jpayne@68: domain DOMAINNAME
jpayne@68: jpayne@68:-J, jpayne@68: --msgctxt
jpayne@68: jpayne@68:start of patterns for the jpayne@68: msgctxt
jpayne@68: jpayne@68:-K, jpayne@68: --msgid
jpayne@68: jpayne@68:start of patterns for the jpayne@68: msgid
jpayne@68: jpayne@68:-T, jpayne@68: --msgstr
jpayne@68: jpayne@68:start of patterns for the jpayne@68: msgstr
jpayne@68: jpayne@68:-C, jpayne@68: --comment
jpayne@68: jpayne@68:start of patterns for the jpayne@68: translator’s comment
jpayne@68: jpayne@68:-X, jpayne@68: --extracted-comment
jpayne@68: jpayne@68:start of patterns for the jpayne@68: extracted comment
jpayne@68: jpayne@68:-E, jpayne@68: --extended-regexp
jpayne@68: jpayne@68:PATTERN is an extended regular jpayne@68: expression
jpayne@68: jpayne@68:-F, jpayne@68: --fixed-strings
jpayne@68: jpayne@68:PATTERN is a set of jpayne@68: newline-separated strings
jpayne@68: jpayne@68:-e, jpayne@68: --regexp=PATTERN
jpayne@68: jpayne@68:use PATTERN as a regular jpayne@68: expression
jpayne@68: jpayne@68:-f, jpayne@68: --file=FILE
jpayne@68: jpayne@68:obtain PATTERN from FILE
jpayne@68: jpayne@68:-i, jpayne@68: --ignore-case
jpayne@68: jpayne@68:ignore case distinctions
jpayne@68: jpayne@68:-v, jpayne@68: --invert-match
jpayne@68: jpayne@68:output only the messages that jpayne@68: do not match any selection criterion
jpayne@68: jpayne@68:Input file
jpayne@68: syntax:
jpayne@68: -P,
jpayne@68: --properties-input
input file is in Java jpayne@68: .properties syntax
jpayne@68: jpayne@68: jpayne@68:--stringtable-input
jpayne@68: jpayne@68:input file is in jpayne@68: NeXTstep/GNUstep .strings syntax
jpayne@68: jpayne@68:Output
jpayne@68: details:
jpayne@68: --color
use colors and other text jpayne@68: attributes always
jpayne@68: jpayne@68: jpayne@68:--color=WHEN
jpayne@68: jpayne@68:use colors and other text jpayne@68: attributes if WHEN. WHEN may be ’always’, jpayne@68: ’never’, ’auto’, or jpayne@68: ’html’.
jpayne@68: jpayne@68: jpayne@68:--style=STYLEFILE
jpayne@68: jpayne@68:specify CSS style rule file for jpayne@68: --color
jpayne@68: jpayne@68: jpayne@68:--no-escape
jpayne@68: jpayne@68:do not use C escapes in output jpayne@68: (default)
jpayne@68: jpayne@68: jpayne@68:--escape
jpayne@68: jpayne@68:use C escapes in output, no jpayne@68: extended chars
jpayne@68: jpayne@68: jpayne@68:--force-po
jpayne@68: jpayne@68:write PO file even if empty
jpayne@68: jpayne@68: jpayne@68:--indent
jpayne@68: jpayne@68:indented output style
jpayne@68: jpayne@68: jpayne@68:--no-location
jpayne@68: jpayne@68:suppress ’#: jpayne@68: filename:line’ lines
jpayne@68: jpayne@68:-n, jpayne@68: --add-location
jpayne@68: jpayne@68:preserve ’#: jpayne@68: filename:line’ lines (default)
jpayne@68: jpayne@68: jpayne@68:--strict
jpayne@68: jpayne@68:strict Uniforum output jpayne@68: style
jpayne@68: jpayne@68:-p, jpayne@68: --properties-output
jpayne@68: jpayne@68:write out a Java .properties jpayne@68: file
jpayne@68: jpayne@68: jpayne@68:--stringtable-output
jpayne@68: jpayne@68:write out a NeXTstep/GNUstep jpayne@68: .strings file
jpayne@68: jpayne@68:-w, jpayne@68: --width=NUMBER
jpayne@68: jpayne@68:set output page width
jpayne@68: jpayne@68: jpayne@68:--no-wrap
jpayne@68: jpayne@68:do not break long message jpayne@68: lines, longer than the output page width, into several jpayne@68: lines
jpayne@68: jpayne@68: jpayne@68:--sort-output
jpayne@68: jpayne@68:generate sorted output
jpayne@68: jpayne@68: jpayne@68:--sort-by-file
jpayne@68: jpayne@68:sort output by file jpayne@68: location
jpayne@68: jpayne@68:Informative
jpayne@68: output:
jpayne@68: -h, --help
display this help and exit
jpayne@68: jpayne@68:-V, jpayne@68: --version
jpayne@68: jpayne@68:output version information and jpayne@68: exit
jpayne@68: jpayne@68:Written by jpayne@68: Bruno Haible.
jpayne@68: jpayne@68:Report bugs in jpayne@68: the bug tracker at jpayne@68: <https://savannah.gnu.org/projects/gettext> or by jpayne@68: email to <bug-gettext@gnu.org>.
jpayne@68: jpayne@68:Copyright
jpayne@68: © 2001-2023 Free Software Foundation, Inc.
jpayne@68: License GPLv3+: GNU GPL version 3 or later
jpayne@68: <https://gnu.org/licenses/gpl.html>
jpayne@68: This is free software: you are free to change and
jpayne@68: redistribute it. There is NO WARRANTY, to the extent
jpayne@68: permitted by law.
The full jpayne@68: documentation for msggrep is maintained as a Texinfo jpayne@68: manual. If the info and msggrep programs are jpayne@68: properly installed at your site, the command
jpayne@68: jpayne@68:info jpayne@68: msggrep
jpayne@68: jpayne@68:should give you jpayne@68: access to the complete manual.
jpayne@68: