pospell(1)							   User Manuals 							pospell(1)

NAME

       pospell - Run a program on the translation strings of a .po-file

SYNOPSIS

       pospell [-l language ] [-fsv] -n pofile -p program [-- [ arguments...  ]]

DESCRIPTION

       pospell copies the translations from the pofile to a temporary file (called the spellfile) and then calls program with its arguments.  pro-
       gram is supposed to somehow change the spellfile.  It is typically a spell checker. Afterwards the possibly changed translations in  spell-
       file is copied back into the pofile.

       If pofile is specified as - then pospell will act as a filter, i.e. standard input and standard output will be used.

       %f in the arguments will be expanded to the name of the spellfile, or - if the -f option is used. Use %% for a real % character.

       All  comment  lines in the pofile are replaced with lines with "#" as the only character in the spellfile.  The msgid strings with original
       text in the pofile are replaced with lines with ">" and "]" as the only characters in the spellfile.  The msgstr strings with file  headers
       (i.e. strings without corresponding msgid strings) are replaced with lines with ")" and "]" as the only characters in the spellfile.  Don't
       change or remove these lines from the spellfile - they are used when the spellfile and the pofile are merged  together  after  running  the
       program.

       The  normal  msgstr  strings  are  copied  to  the spellfile with some changes: 1) The word msgstr and everything else before the string is
       replaced by a "+" character.  2) Strings with C escape sequences followed by a letter like "one	two"  are  split  to  parts  like  "one	"
       "two".  3) Leading whitespace in continuation lines is removed.	The changes of kind 1) and 2) are undone when the spellfile is copied back
       into the pofile, but removed whitespace will not be restored.

OPTIONS

       -f     The called program is a filter so don't make a temporary file, but pipe the spellfile to its standard input and read  it	back  from
	      its standard output.

       -l language
	      Only translations with the indicated language code are copied to the spellfile.

       -s     Quit with an error message if unrecognized items are found in the pofile or spellfile.

       -v     Print the version and exit.

FILES

       pospell uses one or two temporary files with names given by the mkstemp(3) or the tmpnam(3) function.

BUGS

       If some system call gives an unexpected error pospell will stop immediately with an error message leaving its temporary files.

AUTHOR

       Byrial Jensen <byrial@image.dk>

SEE ALSO

       The GNU gettext utilities.

       newsbody(1).

Unix								    APRIL 2000								pospell(1)