gettext-tools/man/msgfilter.1.html

   1 <!-- Creator     : groff version 1.22.3 -->
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   3 "http://www.w3.org/TR/html4/loose.dtd">
   4 <html>
   5 <head>
   6 <meta name="generator" content="groff -Thtml, see www.gnu.org">
   7 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
   8 <meta name="Content-Style" content="text/css">
   9 <style type="text/css">
  10        p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
  11        pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
  12        table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
  13        h1      { text-align: center }
  14 </style>
  15 <title>MSGFILTER</title>
  16
  17 </head>
  18 <body>
  19
  20 <h1 align="center">MSGFILTER</h1>
  21
  22 <a href="#NAME">NAME</a><br>
  23 <a href="#SYNOPSIS">SYNOPSIS</a><br>
  24 <a href="#DESCRIPTION">DESCRIPTION</a><br>
  25 <a href="#AUTHOR">AUTHOR</a><br>
  26 <a href="#REPORTING BUGS">REPORTING BUGS</a><br>
  27 <a href="#COPYRIGHT">COPYRIGHT</a><br>
  28 <a href="#SEE ALSO">SEE ALSO</a><br>
  29
  30 <hr>
  31
  32
  33 <h2>NAME
  34 <a name="NAME"></a>
  35 </h2>
  36
  37
  38 <p style="margin-left:11%; margin-top: 1em">msgfilter
  39 &minus; edit translations of message catalog</p>
  40
  41 <h2>SYNOPSIS
  42 <a name="SYNOPSIS"></a>
  43 </h2>
  44
  45
  46
  47 <p style="margin-left:11%; margin-top: 1em"><b>msgfilter</b>
  48 [<i>OPTION</i>] <i>FILTER</i> [<i>FILTER-OPTION</i>]</p>
  49
  50 <h2>DESCRIPTION
  51 <a name="DESCRIPTION"></a>
  52 </h2>
  53
  54
  55 <p style="margin-left:11%; margin-top: 1em">Applies a
  56 filter to all translations of a translation catalog.</p>
  57
  58 <p style="margin-left:11%; margin-top: 1em">Mandatory
  59 arguments to long options are mandatory for short options
  60 too.</p>
  61
  62 <p style="margin-left:11%; margin-top: 1em"><b>Input file
  63 location: <br>
  64 &minus;i</b>,
  65 <b>&minus;&minus;input</b>=<i>INPUTFILE</i></p>
  66
  67 <p style="margin-left:22%;">input PO file</p>
  68
  69 <p style="margin-left:11%;"><b>&minus;D</b>,
  70 <b>&minus;&minus;directory</b>=<i>DIRECTORY</i></p>
  71
  72 <p style="margin-left:22%;">add DIRECTORY to list for input
  73 files search</p>
  74
  75 <p style="margin-left:11%; margin-top: 1em">If no input
  76 file is given or if it is -, standard input is read.</p>
  77
  78 <p style="margin-left:11%; margin-top: 1em"><b>Output file
  79 location: <br>
  80 &minus;o</b>,
  81 <b>&minus;&minus;output&minus;file</b>=<i>FILE</i></p>
  82
  83 <p style="margin-left:22%;">write output to specified
  84 file</p>
  85
  86 <p style="margin-left:11%; margin-top: 1em">The results are
  87 written to standard output if no output file is specified or
  88 if it is -.</p>
  89
  90 <p style="margin-left:11%; margin-top: 1em">The FILTER can
  91 be any program that reads a translation from standard input
  92 and writes a modified translation to standard output.</p>
  93
  94 <p style="margin-left:11%; margin-top: 1em"><b>Filter input
  95 and output: <br>
  96 &minus;&minus;newline</b></p>
  97
  98 <p style="margin-left:22%;">add a newline at the end of
  99 input and remove a newline from the end of output</p>
 100
 101 <p style="margin-left:11%; margin-top: 1em"><b>Useful
 102 FILTER-OPTIONs when the FILTER is &rsquo;sed&rsquo;: <br>
 103 &minus;e</b>,
 104 <b>&minus;&minus;expression</b>=<i>SCRIPT</i></p>
 105
 106 <p style="margin-left:22%;">add SCRIPT to the commands to
 107 be executed</p>
 108
 109 <p style="margin-left:11%;"><b>&minus;f</b>,
 110 <b>&minus;&minus;file</b>=<i>SCRIPTFILE</i></p>
 111
 112 <p style="margin-left:22%;">add the contents of SCRIPTFILE
 113 to the commands to be executed</p>
 114
 115 <p style="margin-left:11%;"><b>&minus;n</b>,
 116 <b>&minus;&minus;quiet</b>, <b>&minus;&minus;silent</b></p>
 117
 118 <p style="margin-left:22%;">suppress automatic printing of
 119 pattern space</p>
 120
 121 <p style="margin-left:11%; margin-top: 1em"><b>Input file
 122 syntax: <br>
 123 &minus;P</b>,
 124 <b>&minus;&minus;properties&minus;input</b></p>
 125
 126 <p style="margin-left:22%;">input file is in Java
 127 .properties syntax</p>
 128
 129
 130 <p style="margin-left:11%;"><b>&minus;&minus;stringtable&minus;input</b></p>
 131
 132 <p style="margin-left:22%;">input file is in
 133 NeXTstep/GNUstep .strings syntax</p>
 134
 135 <p style="margin-left:11%; margin-top: 1em"><b>Output
 136 details: <br>
 137 &minus;&minus;color</b></p>
 138
 139 <p style="margin-left:22%;">use colors and other text
 140 attributes always</p>
 141
 142
 143 <p style="margin-left:11%;"><b>&minus;&minus;color</b>=<i>WHEN</i></p>
 144
 145 <p style="margin-left:22%;">use colors and other text
 146 attributes if WHEN. WHEN may be &rsquo;always&rsquo;,
 147 &rsquo;never&rsquo;, &rsquo;auto&rsquo;, or
 148 &rsquo;html&rsquo;.</p>
 149
 150
 151 <p style="margin-left:11%;"><b>&minus;&minus;style</b>=<i>STYLEFILE</i></p>
 152
 153 <p style="margin-left:22%;">specify CSS style rule file for
 154 <b>&minus;&minus;color</b></p>
 155
 156
 157 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;escape</b></p>
 158
 159 <p style="margin-left:22%;">do not use C escapes in output
 160 (default)</p>
 161
 162 <p style="margin-left:11%;"><b>&minus;E</b>,
 163 <b>&minus;&minus;escape</b></p>
 164
 165 <p style="margin-left:22%;">use C escapes in output, no
 166 extended chars</p>
 167
 168
 169 <p style="margin-left:11%;"><b>&minus;&minus;force&minus;po</b></p>
 170
 171 <p style="margin-left:22%;">write PO file even if empty</p>
 172
 173
 174 <p style="margin-left:11%;"><b>&minus;&minus;indent</b></p>
 175
 176 <p style="margin-left:22%;">indented output style</p>
 177
 178
 179 <p style="margin-left:11%;"><b>&minus;&minus;keep&minus;header</b></p>
 180
 181 <p style="margin-left:22%;">keep header entry unmodified,
 182 don&rsquo;t filter it</p>
 183
 184
 185 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;location</b></p>
 186
 187 <p style="margin-left:22%;">suppress &rsquo;#:
 188 filename:line&rsquo; lines</p>
 189
 190 <p style="margin-left:11%;"><b>&minus;n</b>,
 191 <b>&minus;&minus;add&minus;location</b></p>
 192
 193 <p style="margin-left:22%;">preserve &rsquo;#:
 194 filename:line&rsquo; lines (default)</p>
 195
 196
 197 <p style="margin-left:11%;"><b>&minus;&minus;strict</b></p>
 198
 199 <p style="margin-left:22%;">strict Uniforum output
 200 style</p>
 201
 202 <p style="margin-left:11%;"><b>&minus;p</b>,
 203 <b>&minus;&minus;properties&minus;output</b></p>
 204
 205 <p style="margin-left:22%;">write out a Java .properties
 206 file</p>
 207
 208
 209 <p style="margin-left:11%;"><b>&minus;&minus;stringtable&minus;output</b></p>
 210
 211 <p style="margin-left:22%;">write out a NeXTstep/GNUstep
 212 .strings file</p>
 213
 214 <p style="margin-left:11%;"><b>&minus;w</b>,
 215 <b>&minus;&minus;width</b>=<i>NUMBER</i></p>
 216
 217 <p style="margin-left:22%;">set output page width</p>
 218
 219
 220 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;wrap</b></p>
 221
 222 <p style="margin-left:22%;">do not break long message
 223 lines, longer than the output page width, into several
 224 lines</p>
 225
 226 <p style="margin-left:11%;"><b>&minus;s</b>,
 227 <b>&minus;&minus;sort&minus;output</b></p>
 228
 229 <p style="margin-left:22%;">generate sorted output</p>
 230
 231 <p style="margin-left:11%;"><b>&minus;F</b>,
 232 <b>&minus;&minus;sort&minus;by&minus;file</b></p>
 233
 234 <p style="margin-left:22%;">sort output by file
 235 location</p>
 236
 237 <p style="margin-left:11%; margin-top: 1em"><b>Informative
 238 output: <br>
 239 &minus;h</b>, <b>&minus;&minus;help</b></p>
 240
 241 <p style="margin-left:22%;">display this help and exit</p>
 242
 243 <p style="margin-left:11%;"><b>&minus;V</b>,
 244 <b>&minus;&minus;version</b></p>
 245
 246 <p style="margin-left:22%;">output version information and
 247 exit</p>
 248
 249 <h2>AUTHOR
 250 <a name="AUTHOR"></a>
 251 </h2>
 252
 253
 254 <p style="margin-left:11%; margin-top: 1em">Written by
 255 Bruno Haible.</p>
 256
 257 <h2>REPORTING BUGS
 258 <a name="REPORTING BUGS"></a>
 259 </h2>
 260
 261
 262 <p style="margin-left:11%; margin-top: 1em">Report bugs to
 263 &lt;bug-gnu-gettext@gnu.org&gt;.</p>
 264
 265 <h2>COPYRIGHT
 266 <a name="COPYRIGHT"></a>
 267 </h2>
 268
 269
 270 <p style="margin-left:11%; margin-top: 1em">Copyright
 271 &copy; 2001-2010 Free Software Foundation, Inc. License
 272 GPLv3+: GNU GPL version 3 or later
 273 &lt;http://gnu.org/licenses/gpl.html&gt; <br>
 274 This is free software: you are free to change and
 275 redistribute it. There is NO WARRANTY, to the extent
 276 permitted by law.</p>
 277
 278 <h2>SEE ALSO
 279 <a name="SEE ALSO"></a>
 280 </h2>
 281
 282
 283 <p style="margin-left:11%; margin-top: 1em">The full
 284 documentation for <b>msgfilter</b> is maintained as a
 285 Texinfo manual. If the <b>info</b> and <b>msgfilter</b>
 286 programs are properly installed at your site, the
 287 command</p>
 288
 289 <p style="margin-left:22%; margin-top: 1em"><b>info
 290 msgfilter</b></p>
 291
 292 <p style="margin-left:11%; margin-top: 1em">should give you
 293 access to the complete manual.</p>
 294 <hr>
 295 </body>
 296 </html>