@pindex msgattrib
@cindex @code{msgattrib} program, usage
@example
msgattrib [@var{option}] [@var{inputfile}]
@end example

@cindex filter messages according to attributes
@cindex attribute manipulation
The @code{msgattrib} program filters the messages of a translation catalog
according to their attributes, and manipulates the attributes.

@subsection Input file location

@table @samp
@item @var{inputfile}
Input PO file.

@item -D @var{directory}
@itemx --directory=@var{directory}
@opindex -D@r{, @code{msgattrib} option}
@opindex --directory@r{, @code{msgattrib} option}
Add @var{directory} to the list of directories.  Source files are
searched relative to this list of directories.  The resulting @file{.po}
file will be written relative to the current directory, though.

@end table

If no @var{inputfile} is given or if it is @samp{-}, standard input is read.

@subsection Output file location

@table @samp
@item -o @var{file}
@itemx --output-file=@var{file}
@opindex -o@r{, @code{msgattrib} option}
@opindex --output-file@r{, @code{msgattrib} option}
Write output to specified file.

@end table

The results are written to standard output if no output file is specified
or if it is @samp{-}.

@subsection Message selection

@table @samp
@item --translated
@opindex --translated@r{, @code{msgattrib} option}
Keep translated messages, remove untranslated messages.

@item --untranslated
@opindex --untranslated@r{, @code{msgattrib} option}
Keep untranslated messages, remove translated messages.

@item --no-fuzzy
@opindex --no-fuzzy@r{, @code{msgattrib} option}
Remove `fuzzy' marked messages.

@item --only-fuzzy
@opindex --only-fuzzy@r{, @code{msgattrib} option}
Keep `fuzzy' marked messages, remove all other messsages.

@item --no-obsolete
@opindex --no-obsolete@r{, @code{msgattrib} option}
Remove obsolete #~ messages.

@item --only-obsolete
@opindex --only-obsolete@r{, @code{msgattrib} option}
Keep obsolete #~ messages, remove all other messages.

@end table

@subsection Attribute manipulation

@cindex modify message attrributes
Attributes are modified after the message selection/removal has been
performed.

@table @samp
@item --set-fuzzy
@opindex --set-fuzzy@r{, @code{msgattrib} option}
Set all messages `fuzzy'.

@item --clear-fuzzy
@opindex --clear-fuzzy@r{, @code{msgattrib} option}
Set all messages non-`fuzzy'.

@item --set-obsolete
@opindex --set-obsolete@r{, @code{msgattrib} option}
Set all messages obsolete.

@item --clear-obsolete
@opindex --clear-obsolete@r{, @code{msgattrib} option}
Set all messages non-obsolete.

@item --fuzzy
@opindex --fuzzy@r{, @code{msgattrib} option}
Synonym for @samp{--only-fuzzy --clear-fuzzy}: It keeps only the fuzzy
messages and removes their `fuzzy' mark.

@item --obsolete
@opindex --obsolete@r{, @code{msgattrib} option}
Synonym for @samp{--only-obsolete --clear-obsolete}: It keeps only the
obsolete messages and makes them non-obsolete.

@end table

@subsection Output details

@c --no-escape and --escape omitted on purpose.  They are not useful.

@table @samp
@item --force-po
@opindex --force-po@r{, @code{msgattrib} option}
Always write an output file even if it contains no message.

@item -i
@itemx --indent
@opindex -i@r{, @code{msgattrib} option}
@opindex --indent@r{, @code{msgattrib} option}
Write the .po file using indented style.

@item --no-location
@opindex --no-location@r{, @code{msgattrib} option}
Do not write @samp{#: @var{filename}:@var{line}} lines.

@item -n
@itemx --add-location
@opindex -n@r{, @code{msgattrib} option}
@opindex --add-location@r{, @code{msgattrib} option}
Generate @samp{#: @var{filename}:@var{line}} lines (default).

@item --strict
@opindex --strict@r{, @code{msgattrib} option}
Write out a strict Uniforum conforming PO file.  Note that this
Uniforum format should be avoided because it doesn't support the
GNU extensions.

@item -w @var{number}
@itemx --width=@var{number}
@opindex -w@r{, @code{msgattrib} option}
@opindex --width@r{, @code{msgattrib} option}
Set the output page width.  Long strings in the output files will be
split across multiple lines in order to ensure that each line's width
(= number of screen columns) is less or equal to the given @var{number}.

@item -s
@itemx --sort-output
@opindex -s@r{, @code{msgattrib} option}
@opindex --sort-output@r{, @code{msgattrib} option}
Generate sorted output.  Note that using this option makes it much harder
for the translator to understand each message's context.

@item -F
@itemx --sort-by-file
@opindex -F@r{, @code{msgattrib} option}
@opindex --sort-by-file@r{, @code{msgattrib} option}
Sort output by file location.

@end table

@subsection Informative output

@table @samp
@item -h
@itemx --help
@opindex -h@r{, @code{msgattrib} option}
@opindex --help@r{, @code{msgattrib} option}
Display this help and exit.

@item -V
@itemx --version
@opindex -V@r{, @code{msgattrib} option}
@opindex --version@r{, @code{msgattrib} option}
Output version information and exit.

@end table