[Gimp-docs] meaning of strings in po files

[Ulf-D. Ehlert]

julien (Freitag, 2. Januar 2009, 08:36):
> > 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.

Yes, it's just the information (for documenters or translators) who 
committed when any changes.

> 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.

IMHO a nice idea. :-) However,
(a) at the top the reader should find the most important information 
(summary, screenshot, previews, etc.), so this new para should go the 
bottom of the (HTML) file;
(b) <subscript> is definitely the wrong way to add a para using a tiny 
font; the correct method is:  hmm, I have no idea... ;-)
(passing an attribute to HTML?)

Ulf

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part.
Url : /lists/gimp-docs/attachments/20090104/89132927/attachment.bin