Imported Upstream version 0.18.3.2
[platform/upstream/gettext.git] / gettext-tools / man / msgattrib.1
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.24.
2 .TH MSGATTRIB "1" "January 2014" "GNU gettext-tools 0.18.3" 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\-\-only\-file\fR=\fIFILE\fR.po
72 manipulate only entries listed in FILE.po
73 .TP
74 \fB\-\-ignore\-file\fR=\fIFILE\fR.po
75 manipulate only entries not listed in FILE.po
76 .TP
77 \fB\-\-fuzzy\fR
78 synonym for \fB\-\-only\-fuzzy\fR \fB\-\-clear\-fuzzy\fR
79 .TP
80 \fB\-\-obsolete\fR
81 synonym for \fB\-\-only\-obsolete\fR \fB\-\-clear\-obsolete\fR
82 .SS "Input file syntax:"
83 .TP
84 \fB\-P\fR, \fB\-\-properties\-input\fR
85 input file is in Java .properties syntax
86 .TP
87 \fB\-\-stringtable\-input\fR
88 input file is in NeXTstep/GNUstep .strings syntax
89 .SS "Output details:"
90 .TP
91 \fB\-\-color\fR
92 use colors and other text attributes always
93 .TP
94 \fB\-\-color\fR=\fIWHEN\fR
95 use colors and other text attributes if WHEN.
96 WHEN may be 'always', 'never', 'auto', or 'html'.
97 .TP
98 \fB\-\-style\fR=\fISTYLEFILE\fR
99 specify CSS style rule file for \fB\-\-color\fR
100 .TP
101 \fB\-e\fR, \fB\-\-no\-escape\fR
102 do not use C escapes in output (default)
103 .TP
104 \fB\-E\fR, \fB\-\-escape\fR
105 use C escapes in output, no extended chars
106 .TP
107 \fB\-\-force\-po\fR
108 write PO file even if empty
109 .TP
110 \fB\-i\fR, \fB\-\-indent\fR
111 write the .po file using indented style
112 .TP
113 \fB\-\-no\-location\fR
114 do not write '#: filename:line' lines
115 .TP
116 \fB\-n\fR, \fB\-\-add\-location\fR
117 generate '#: filename:line' lines (default)
118 .TP
119 \fB\-\-strict\fR
120 write out strict Uniforum conforming .po file
121 .TP
122 \fB\-p\fR, \fB\-\-properties\-output\fR
123 write out a Java .properties file
124 .TP
125 \fB\-\-stringtable\-output\fR
126 write out a NeXTstep/GNUstep .strings file
127 .TP
128 \fB\-w\fR, \fB\-\-width\fR=\fINUMBER\fR
129 set output page width
130 .TP
131 \fB\-\-no\-wrap\fR
132 do not break long message lines, longer than
133 the output page width, into several lines
134 .TP
135 \fB\-s\fR, \fB\-\-sort\-output\fR
136 generate sorted output
137 .TP
138 \fB\-F\fR, \fB\-\-sort\-by\-file\fR
139 sort output by file location
140 .SS "Informative output:"
141 .TP
142 \fB\-h\fR, \fB\-\-help\fR
143 display this help and exit
144 .TP
145 \fB\-V\fR, \fB\-\-version\fR
146 output version information and exit
147 .SH AUTHOR
148 Written by Bruno Haible.
149 .SH "REPORTING BUGS"
150 Report bugs to <bug-gnu-gettext@gnu.org>.
151 .SH COPYRIGHT
152 Copyright \(co 2001-2010 Free Software Foundation, Inc.
153 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
154 .br
155 This is free software: you are free to change and redistribute it.
156 There is NO WARRANTY, to the extent permitted by law.
157 .SH "SEE ALSO"
158 The full documentation for
159 .B msgattrib
160 is maintained as a Texinfo manual.  If the
161 .B info
162 and
163 .B msgattrib
164 programs are properly installed at your site, the command
165 .IP
166 .B info msgattrib
167 .PP
168 should give you access to the complete manual.