gettext-tools/man/msgattrib.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.24.
   2 .TH MSGATTRIB "1" "December 2015" "GNU gettext-tools 0.19.7" GNU
   3 .SH NAME
   4 msgattrib \- attribute matching and manipulation on message catalog
   5 .SH SYNOPSIS
   6 .B msgattrib
   7 [\fIOPTION\fR] [\fIINPUTFILE\fR]
   8 .SH DESCRIPTION
   9 .\" Add any additional description here
  10 .PP
  11 Filters the messages of a translation catalog according to their attributes,
  12 and manipulates the attributes.
  13 .PP
  14 Mandatory arguments to long options are mandatory for short options too.
  15 .SS "Input file location:"
  16 .TP
  17 INPUTFILE
  18 input PO file
  19 .TP
  20 \fB\-D\fR, \fB\-\-directory\fR=\fIDIRECTORY\fR
  21 add DIRECTORY to list for input files search
  22 .PP
  23 If no input file is given or if it is -, standard input is read.
  24 .SS "Output file location:"
  25 .TP
  26 \fB\-o\fR, \fB\-\-output\-file\fR=\fIFILE\fR
  27 write output to specified file
  28 .PP
  29 The results are written to standard output if no output file is specified
  30 or if it is -.
  31 .SS "Message selection:"
  32 .TP
  33 \fB\-\-translated\fR
  34 keep translated, remove untranslated messages
  35 .TP
  36 \fB\-\-untranslated\fR
  37 keep untranslated, remove translated messages
  38 .TP
  39 \fB\-\-no\-fuzzy\fR
  40 remove 'fuzzy' marked messages
  41 .TP
  42 \fB\-\-only\-fuzzy\fR
  43 keep 'fuzzy' marked messages
  44 .TP
  45 \fB\-\-no\-obsolete\fR
  46 remove obsolete #~ messages
  47 .TP
  48 \fB\-\-only\-obsolete\fR
  49 keep obsolete #~ messages
  50 .SS "Attribute manipulation:"
  51 .TP
  52 \fB\-\-set\-fuzzy\fR
  53 set all messages 'fuzzy'
  54 .TP
  55 \fB\-\-clear\-fuzzy\fR
  56 set all messages non-'fuzzy'
  57 .TP
  58 \fB\-\-set\-obsolete\fR
  59 set all messages obsolete
  60 .TP
  61 \fB\-\-clear\-obsolete\fR
  62 set all messages non-obsolete
  63 .TP
  64 \fB\-\-previous\fR
  65 when setting 'fuzzy', keep previous msgids
  66 of translated messages.
  67 .TP
  68 \fB\-\-clear\-previous\fR
  69 remove the "previous msgid" from all messages
  70 .TP
  71 \fB\-\-empty\fR
  72 when removing 'fuzzy', also set msgstr empty
  73 .TP
  74 \fB\-\-only\-file\fR=\fIFILE\fR.po
  75 manipulate only entries listed in FILE.po
  76 .TP
  77 \fB\-\-ignore\-file\fR=\fIFILE\fR.po
  78 manipulate only entries not listed in FILE.po
  79 .TP
  80 \fB\-\-fuzzy\fR
  81 synonym for \fB\-\-only\-fuzzy\fR \fB\-\-clear\-fuzzy\fR
  82 .TP
  83 \fB\-\-obsolete\fR
  84 synonym for \fB\-\-only\-obsolete\fR \fB\-\-clear\-obsolete\fR
  85 .SS "Input file syntax:"
  86 .TP
  87 \fB\-P\fR, \fB\-\-properties\-input\fR
  88 input file is in Java .properties syntax
  89 .TP
  90 \fB\-\-stringtable\-input\fR
  91 input file is in NeXTstep/GNUstep .strings syntax
  92 .SS "Output details:"
  93 .TP
  94 \fB\-\-color\fR
  95 use colors and other text attributes always
  96 .TP
  97 \fB\-\-color\fR=\fIWHEN\fR
  98 use colors and other text attributes if WHEN.
  99 WHEN may be 'always', 'never', 'auto', or 'html'.
 100 .TP
 101 \fB\-\-style\fR=\fISTYLEFILE\fR
 102 specify CSS style rule file for \fB\-\-color\fR
 103 .TP
 104 \fB\-e\fR, \fB\-\-no\-escape\fR
 105 do not use C escapes in output (default)
 106 .TP
 107 \fB\-E\fR, \fB\-\-escape\fR
 108 use C escapes in output, no extended chars
 109 .TP
 110 \fB\-\-force\-po\fR
 111 write PO file even if empty
 112 .TP
 113 \fB\-i\fR, \fB\-\-indent\fR
 114 write the .po file using indented style
 115 .TP
 116 \fB\-\-no\-location\fR
 117 do not write '#: filename:line' lines
 118 .TP
 119 \fB\-n\fR, \fB\-\-add\-location\fR
 120 generate '#: filename:line' lines (default)
 121 .TP
 122 \fB\-\-strict\fR
 123 write out strict Uniforum conforming .po file
 124 .TP
 125 \fB\-p\fR, \fB\-\-properties\-output\fR
 126 write out a Java .properties file
 127 .TP
 128 \fB\-\-stringtable\-output\fR
 129 write out a NeXTstep/GNUstep .strings file
 130 .TP
 131 \fB\-w\fR, \fB\-\-width\fR=\fINUMBER\fR
 132 set output page width
 133 .TP
 134 \fB\-\-no\-wrap\fR
 135 do not break long message lines, longer than
 136 the output page width, into several lines
 137 .TP
 138 \fB\-s\fR, \fB\-\-sort\-output\fR
 139 generate sorted output
 140 .TP
 141 \fB\-F\fR, \fB\-\-sort\-by\-file\fR
 142 sort output by file location
 143 .SS "Informative output:"
 144 .TP
 145 \fB\-h\fR, \fB\-\-help\fR
 146 display this help and exit
 147 .TP
 148 \fB\-V\fR, \fB\-\-version\fR
 149 output version information and exit
 150 .SH AUTHOR
 151 Written by Bruno Haible.
 152 .SH "REPORTING BUGS"
 153 Report bugs to <bug-gnu-gettext@gnu.org>.
 154 .SH COPYRIGHT
 155 Copyright \(co 2001-2010 Free Software Foundation, Inc.
 156 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 157 .br
 158 This is free software: you are free to change and redistribute it.
 159 There is NO WARRANTY, to the extent permitted by law.
 160 .SH "SEE ALSO"
 161 The full documentation for
 162 .B msgattrib
 163 is maintained as a Texinfo manual.  If the
 164 .B info
 165 and
 166 .B msgattrib
 167 programs are properly installed at your site, the command
 168 .IP
 169 .B info msgattrib
 170 .PP
 171 should give you access to the complete manual.