Mercurial > repos > rliterman > csp2

annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/man/man1/msggrep.1 @ 68:5028fdace37b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 16:23:26 -0400
parents
children
rev   line source
jpayne@68 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6.
jpayne@68 2 .TH MSGGREP "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands"
jpayne@68 3 .SH NAME
jpayne@68 4 msggrep \- pattern matching on message catalog
jpayne@68 5 .SH SYNOPSIS
jpayne@68 6 .B msggrep
jpayne@68 7 [\fI\,OPTION\/\fR] [\fI\,INPUTFILE\/\fR]
jpayne@68 8 .SH DESCRIPTION
jpayne@68 9 .\" Add any additional description here
jpayne@68 10 .PP
jpayne@68 11 Extracts all messages of a translation catalog that match a given pattern
jpayne@68 12 or belong to some given source files.
jpayne@68 13 .PP
jpayne@68 14 Mandatory arguments to long options are mandatory for short options too.
jpayne@68 15 .SS "Input file location:"
jpayne@68 16 .TP
jpayne@68 17 INPUTFILE
jpayne@68 18 input PO file
jpayne@68 19 .TP
jpayne@68 20 \fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
jpayne@68 21 add DIRECTORY to list for input files search
jpayne@68 22 .PP
jpayne@68 23 If no input file is given or if it is \-, standard input is read.
jpayne@68 24 .SS "Output file location:"
jpayne@68 25 .TP
jpayne@68 26 \fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
jpayne@68 27 write output to specified file
jpayne@68 28 .PP
jpayne@68 29 The results are written to standard output if no output file is specified
jpayne@68 30 or if it is \-.
jpayne@68 31 .SS "Message selection:"
jpayne@68 32 .IP
jpayne@68 33 [\-N SOURCEFILE]... [\-M DOMAINNAME]...
jpayne@68 34 [\-J MSGCTXT\-PATTERN] [\-K MSGID\-PATTERN] [\-T MSGSTR\-PATTERN]
jpayne@68 35 [\-C COMMENT\-PATTERN] [\-X EXTRACTED\-COMMENT\-PATTERN]
jpayne@68 36 .PP
jpayne@68 37 A message is selected if it comes from one of the specified source files,
jpayne@68 38 or if it comes from one of the specified domains,
jpayne@68 39 or if \fB\-J\fR is given and its context (msgctxt) matches MSGCTXT\-PATTERN,
jpayne@68 40 or if \fB\-K\fR is given and its key (msgid or msgid_plural) matches MSGID\-PATTERN,
jpayne@68 41 or if \fB\-T\fR is given and its translation (msgstr) matches MSGSTR\-PATTERN,
jpayne@68 42 or if \fB\-C\fR is given and the translator's comment matches COMMENT\-PATTERN,
jpayne@68 43 or if \fB\-X\fR is given and the extracted comment matches EXTRACTED\-COMMENT\-PATTERN.
jpayne@68 44 .PP
jpayne@68 45 When more than one selection criterion is specified, the set of selected
jpayne@68 46 messages is the union of the selected messages of each criterion.
jpayne@68 47 .PP
jpayne@68 48 MSGCTXT\-PATTERN or MSGID\-PATTERN or MSGSTR\-PATTERN or COMMENT\-PATTERN or
jpayne@68 49 EXTRACTED\-COMMENT\-PATTERN syntax:
jpayne@68 50 .IP
jpayne@68 51 [\-E | \fB\-F]\fR [\-e PATTERN | \fB\-f\fR FILE]...
jpayne@68 52 .PP
jpayne@68 53 PATTERNs are basic regular expressions by default, or extended regular
jpayne@68 54 expressions if \fB\-E\fR is given, or fixed strings if \fB\-F\fR is given.
jpayne@68 55 .TP
jpayne@68 56 \fB\-N\fR, \fB\-\-location\fR=\fI\,SOURCEFILE\/\fR
jpayne@68 57 select messages extracted from SOURCEFILE
jpayne@68 58 .TP
jpayne@68 59 \fB\-M\fR, \fB\-\-domain\fR=\fI\,DOMAINNAME\/\fR
jpayne@68 60 select messages belonging to domain DOMAINNAME
jpayne@68 61 .TP
jpayne@68 62 \fB\-J\fR, \fB\-\-msgctxt\fR
jpayne@68 63 start of patterns for the msgctxt
jpayne@68 64 .TP
jpayne@68 65 \fB\-K\fR, \fB\-\-msgid\fR
jpayne@68 66 start of patterns for the msgid
jpayne@68 67 .TP
jpayne@68 68 \fB\-T\fR, \fB\-\-msgstr\fR
jpayne@68 69 start of patterns for the msgstr
jpayne@68 70 .TP
jpayne@68 71 \fB\-C\fR, \fB\-\-comment\fR
jpayne@68 72 start of patterns for the translator's comment
jpayne@68 73 .TP
jpayne@68 74 \fB\-X\fR, \fB\-\-extracted\-comment\fR
jpayne@68 75 start of patterns for the extracted comment
jpayne@68 76 .TP
jpayne@68 77 \fB\-E\fR, \fB\-\-extended\-regexp\fR
jpayne@68 78 PATTERN is an extended regular expression
jpayne@68 79 .TP
jpayne@68 80 \fB\-F\fR, \fB\-\-fixed\-strings\fR
jpayne@68 81 PATTERN is a set of newline\-separated strings
jpayne@68 82 .TP
jpayne@68 83 \fB\-e\fR, \fB\-\-regexp\fR=\fI\,PATTERN\/\fR
jpayne@68 84 use PATTERN as a regular expression
jpayne@68 85 .TP
jpayne@68 86 \fB\-f\fR, \fB\-\-file\fR=\fI\,FILE\/\fR
jpayne@68 87 obtain PATTERN from FILE
jpayne@68 88 .TP
jpayne@68 89 \fB\-i\fR, \fB\-\-ignore\-case\fR
jpayne@68 90 ignore case distinctions
jpayne@68 91 .TP
jpayne@68 92 \fB\-v\fR, \fB\-\-invert\-match\fR
jpayne@68 93 output only the messages that do not match any
jpayne@68 94 selection criterion
jpayne@68 95 .SS "Input file syntax:"
jpayne@68 96 .TP
jpayne@68 97 \fB\-P\fR, \fB\-\-properties\-input\fR
jpayne@68 98 input file is in Java .properties syntax
jpayne@68 99 .TP
jpayne@68 100 \fB\-\-stringtable\-input\fR
jpayne@68 101 input file is in NeXTstep/GNUstep .strings syntax
jpayne@68 102 .SS "Output details:"
jpayne@68 103 .TP
jpayne@68 104 \fB\-\-color\fR
jpayne@68 105 use colors and other text attributes always
jpayne@68 106 .TP
jpayne@68 107 \fB\-\-color\fR=\fI\,WHEN\/\fR
jpayne@68 108 use colors and other text attributes if WHEN.
jpayne@68 109 WHEN may be 'always', 'never', 'auto', or 'html'.
jpayne@68 110 .TP
jpayne@68 111 \fB\-\-style\fR=\fI\,STYLEFILE\/\fR
jpayne@68 112 specify CSS style rule file for \fB\-\-color\fR
jpayne@68 113 .TP
jpayne@68 114 \fB\-\-no\-escape\fR
jpayne@68 115 do not use C escapes in output (default)
jpayne@68 116 .TP
jpayne@68 117 \fB\-\-escape\fR
jpayne@68 118 use C escapes in output, no extended chars
jpayne@68 119 .TP
jpayne@68 120 \fB\-\-force\-po\fR
jpayne@68 121 write PO file even if empty
jpayne@68 122 .TP
jpayne@68 123 \fB\-\-indent\fR
jpayne@68 124 indented output style
jpayne@68 125 .TP
jpayne@68 126 \fB\-\-no\-location\fR
jpayne@68 127 suppress '#: filename:line' lines
jpayne@68 128 .TP
jpayne@68 129 \fB\-n\fR, \fB\-\-add\-location\fR
jpayne@68 130 preserve '#: filename:line' lines (default)
jpayne@68 131 .TP
jpayne@68 132 \fB\-\-strict\fR
jpayne@68 133 strict Uniforum output style
jpayne@68 134 .TP
jpayne@68 135 \fB\-p\fR, \fB\-\-properties\-output\fR
jpayne@68 136 write out a Java .properties file
jpayne@68 137 .TP
jpayne@68 138 \fB\-\-stringtable\-output\fR
jpayne@68 139 write out a NeXTstep/GNUstep .strings file
jpayne@68 140 .TP
jpayne@68 141 \fB\-w\fR, \fB\-\-width\fR=\fI\,NUMBER\/\fR
jpayne@68 142 set output page width
jpayne@68 143 .TP
jpayne@68 144 \fB\-\-no\-wrap\fR
jpayne@68 145 do not break long message lines, longer than
jpayne@68 146 the output page width, into several lines
jpayne@68 147 .TP
jpayne@68 148 \fB\-\-sort\-output\fR
jpayne@68 149 generate sorted output
jpayne@68 150 .TP
jpayne@68 151 \fB\-\-sort\-by\-file\fR
jpayne@68 152 sort output by file location
jpayne@68 153 .SS "Informative output:"
jpayne@68 154 .TP
jpayne@68 155 \fB\-h\fR, \fB\-\-help\fR
jpayne@68 156 display this help and exit
jpayne@68 157 .TP
jpayne@68 158 \fB\-V\fR, \fB\-\-version\fR
jpayne@68 159 output version information and exit
jpayne@68 160 .SH AUTHOR
jpayne@68 161 Written by Bruno Haible.
jpayne@68 162 .SH "REPORTING BUGS"
jpayne@68 163 Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext>
jpayne@68 164 or by email to <bug\-gettext@gnu.org>.
jpayne@68 165 .SH COPYRIGHT
jpayne@68 166 Copyright \(co 2001\-2023 Free Software Foundation, Inc.
jpayne@68 167 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
jpayne@68 168 .br
jpayne@68 169 This is free software: you are free to change and redistribute it.
jpayne@68 170 There is NO WARRANTY, to the extent permitted by law.
jpayne@68 171 .SH "SEE ALSO"
jpayne@68 172 The full documentation for
jpayne@68 173 .B msggrep
jpayne@68 174 is maintained as a Texinfo manual. If the
jpayne@68 175 .B info
jpayne@68 176 and
jpayne@68 177 .B msggrep
jpayne@68 178 programs are properly installed at your site, the command
jpayne@68 179 .IP
jpayne@68 180 .B info msggrep
jpayne@68 181 .PP
jpayne@68 182 should give you access to the complete manual.