
  Header section of PO files
  =-=-=-=-=-=-=-=-=-=-=-=-=-

In order to help translation coordination, PO files generated by
debiandoc-gettextize do contain an header section.  It is the first
entry, with an empty msgid.

The line
  "Content-Type: text/plain; charset=CHARSET\n"
is mandatory, and CHARSET must be replaced by the charset used in
this file.  Otherwise msgfmt will refuse to do its job.
All other lines are optional, but you are encouraged to keep them
and add accurate informations.

Updating those informations seem to be rather painful, but it is not,
because debiandoc-gettextize is called only once, when generating the
first PO file.  After that, PO file is updated by running debiandoc2pot
and msgmerge, which preserves header section of PO files.
One then only has to change Project-Id-Version, PO-Revision-Date and
Last-Translator fields, all other fields are already filled up.

This can be automatically done by your text editor, e.g. I got this
macro for vim on Internet:
  imap <buffer> <C-G> <ESC>mG:r!date +'\%Y-\%m-\%d \%H:\%M\%z'<CR>"gd$dd`G"gpa
  nmap <buffer> _CT mCHmH1G/^"PO-Revision-Date:<CR>f:wct\<C-G><ESC>
     \j0f:llct\Denis Barbier <barbier@linuxfr.org><ESC>'Hz<CR>`C
  augroup local_rc 
    au!
    au BufWritePre,FileWritePre *fr.po   :norm _CT
  augroup END
to automatically set PO-Revision-Date and Last-Translator when writing
file (please do not forget to remove my name and mail if you pick these
macros :))

