[Gimp-docs] meaning of strings in po files

[julien]

Hi,

> I still think we should remove the <revhistory> entries, maybe adding a
> <!-- $Id$ --> instead, which will be expanded by SVN to
> <!-- $Id: foo.xml 2666 2009-02-30 21:30:00Z author $ -->

What is interesting for users is "Has the information in this file
changed or been updated?".

We must distinguish:
- "semantic" changes, bringing new information
	. update to v2.6
	. correction of errors

- "formal" changes, not bringing new information
	. typos corrections
	. rewriting the text for better understanding without adding any new
information.
	. changes in xml structure

It seems that your $id$ proposition doesn't distinguish this.

I propose to add two new <para> at the top of files, showing "semantic"
changes, that will appear in the html:
<sect2>
  <para>subcript>File updated to v2.6 on ... by ...</subscript></para>
  <para>subcript>File improved on ... by ...</subscript></para>
and perhaps also:
  <para>subcript>File translated to ... on ... by ...</subscript></para>

<subscript> because this information must be unobstrusive in the HTML file.
An interest is that these <para> can be translated in all languages,
avoiding english in localised html.

"Formal" changes remain in the commented "Section history"

Julien