1MSGATTRIB(1) User Commands MSGATTRIB(1)
2
6 msgattrib - attribute matching and manipulation on message catalog
7
9 msgattrib [OPTION] [INPUTFILE]
10
12 Filters the messages of a translation catalog according to their at‐
13 tributes, and manipulates the attributes.
14 Mandatory arguments to long options are mandatory for short options
16 too.
17 Input file location:
19 INPUTFILE
20 input PO file
21 -D, --directory=DIRECTORY
23 add DIRECTORY to list for input files search
24 If no input file is given or if it is -, standard input is read.
26 Output file location:
28 -o, --output-file=FILE
29 write output to specified file
30 The results are written to standard output if no output file is speci‐
32 fied or if it is -.
33 Message selection:
35 --translated
36 keep translated, remove untranslated messages
37 --untranslated
39 keep untranslated, remove translated messages
40 --no-fuzzy
42 remove 'fuzzy' marked messages
43 --only-fuzzy
45 keep 'fuzzy' marked messages
46 --no-obsolete
48 remove obsolete #~ messages
49 --only-obsolete
51 keep obsolete #~ messages
52 Attribute manipulation:
54 --set-fuzzy
55 set all messages 'fuzzy'
56 --clear-fuzzy
58 set all messages non-'fuzzy'
59 --set-obsolete
61 set all messages obsolete
62 --clear-obsolete
64 set all messages non-obsolete
65 --previous
67 when setting 'fuzzy', keep previous msgids of translated mes‐
68 sages.
69 --clear-previous
71 remove the "previous msgid" from all messages
72 --empty
74 when removing 'fuzzy', also set msgstr empty
75 --only-file=FILE.po
77 manipulate only entries listed in FILE.po
78 --ignore-file=FILE.po
80 manipulate only entries not listed in FILE.po
81 --fuzzy
83 synonym for --only-fuzzy --clear-fuzzy
84 --obsolete
86 synonym for --only-obsolete --clear-obsolete
87 Input file syntax:
89 -P, --properties-input
90 input file is in Java .properties syntax
91 --stringtable-input
93 input file is in NeXTstep/GNUstep .strings syntax
94 Output details:
96 --color
97 use colors and other text attributes always
98 --color=WHEN
100 use colors and other text attributes if WHEN. WHEN may be 'al‐
101 ways', 'never', 'auto', or 'html'.
102 --style=STYLEFILE
104 specify CSS style rule file for --color
105 -e, --no-escape
107 do not use C escapes in output (default)
108 -E, --escape
110 use C escapes in output, no extended chars
111 --force-po
113 write PO file even if empty
114 -i, --indent
116 write the .po file using indented style
117 --no-location
119 do not write '#: filename:line' lines
120 -n, --add-location
122 generate '#: filename:line' lines (default)
123 --strict
125 write out strict Uniforum conforming .po file
126 -p, --properties-output
128 write out a Java .properties file
129 --stringtable-output
131 write out a NeXTstep/GNUstep .strings file
132 -w, --width=NUMBER
134 set output page width
135 --no-wrap
137 do not break long message lines, longer than the output page
138 width, into several lines
139 -s, --sort-output
141 generate sorted output
142 -F, --sort-by-file
144 sort output by file location
145 Informative output:
147 -h, --help
148 display this help and exit
149 -V, --version
151 output version information and exit
152
154 Written by Bruno Haible.
155
157 Report bugs in the bug tracker at <https://savan‐
158 nah.gnu.org/projects/gettext> or by email to <bug-gettext@gnu.org>.
159
161 Copyright © 2001-2023 Free Software Foundation, Inc. License GPLv3+:
162 GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
163 This is free software: you are free to change and redistribute it.
164 There is NO WARRANTY, to the extent permitted by law.
165
167 The full documentation for msgattrib is maintained as a Texinfo manual.
168 If the info and msgattrib programs are properly installed at your site,
169 the command
170 info msgattrib
172 should give you access to the complete manual.
174GNU gettext-tools 0.22 June 2023 MSGATTRIB(1)