1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.24.
2 .TH MSGFILTER "1" "June 2010" "GNU gettext-tools 0.18.1" GNU
4 msgfilter \- edit translations of message catalog
7 [\fIOPTION\fR] \fIFILTER \fR[\fIFILTER-OPTION\fR]
9 .\" Add any additional description here
11 Applies a filter to all translations of a translation catalog.
13 Mandatory arguments to long options are mandatory for short options too.
14 .SS "Input file location:"
16 \fB\-i\fR, \fB\-\-input\fR=\fIINPUTFILE\fR
19 \fB\-D\fR, \fB\-\-directory\fR=\fIDIRECTORY\fR
20 add DIRECTORY to list for input files search
22 If no input file is given or if it is -, standard input is read.
23 .SS "Output file location:"
25 \fB\-o\fR, \fB\-\-output\-file\fR=\fIFILE\fR
26 write output to specified file
28 The results are written to standard output if no output file is specified
31 The FILTER can be any program that reads a translation from standard input
32 and writes a modified translation to standard output.
33 .SS "Useful FILTER-OPTIONs when the FILTER is 'sed':"
35 \fB\-e\fR, \fB\-\-expression\fR=\fISCRIPT\fR
36 add SCRIPT to the commands to be executed
38 \fB\-f\fR, \fB\-\-file\fR=\fISCRIPTFILE\fR
39 add the contents of SCRIPTFILE to the commands
42 \fB\-n\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
43 suppress automatic printing of pattern space
44 .SS "Input file syntax:"
46 \fB\-P\fR, \fB\-\-properties\-input\fR
47 input file is in Java .properties syntax
49 \fB\-\-stringtable\-input\fR
50 input file is in NeXTstep/GNUstep .strings syntax
54 use colors and other text attributes always
56 \fB\-\-color\fR=\fIWHEN\fR
57 use colors and other text attributes if WHEN.
58 WHEN may be 'always', 'never', 'auto', or 'html'.
60 \fB\-\-style\fR=\fISTYLEFILE\fR
61 specify CSS style rule file for \fB\-\-color\fR
64 do not use C escapes in output (default)
66 \fB\-E\fR, \fB\-\-escape\fR
67 use C escapes in output, no extended chars
70 write PO file even if empty
75 \fB\-\-keep\-header\fR
76 keep header entry unmodified, don't filter it
78 \fB\-\-no\-location\fR
79 suppress '#: filename:line' lines
81 \fB\-\-add\-location\fR
82 preserve '#: filename:line' lines (default)
85 strict Uniforum output style
87 \fB\-p\fR, \fB\-\-properties\-output\fR
88 write out a Java .properties file
90 \fB\-\-stringtable\-output\fR
91 write out a NeXTstep/GNUstep .strings file
93 \fB\-w\fR, \fB\-\-width\fR=\fINUMBER\fR
97 do not break long message lines, longer than
98 the output page width, into several lines
100 \fB\-s\fR, \fB\-\-sort\-output\fR
101 generate sorted output
103 \fB\-F\fR, \fB\-\-sort\-by\-file\fR
104 sort output by file location
105 .SS "Informative output:"
107 \fB\-h\fR, \fB\-\-help\fR
108 display this help and exit
110 \fB\-V\fR, \fB\-\-version\fR
111 output version information and exit
113 Written by Bruno Haible.
115 Report bugs to <bug-gnu-gettext@gnu.org>.
117 Copyright \(co 2001-2010 Free Software Foundation, Inc.
118 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
120 This is free software: you are free to change and redistribute it.
121 There is NO WARRANTY, to the extent permitted by law.
123 The full documentation for
125 is maintained as a Texinfo manual. If the
129 programs are properly installed at your site, the command
133 should give you access to the complete manual.