>> At the end of every po file :
>> #. Put one translator per line, in the form of NAME <EMAIL>, YEAR1,
>> YEAR2 #: src/concepts/basic-setup.xml:0(None)
>> msgid "translator-credits"
>> msgstr ""
>> "Daniel Egger\n"
>> "Roman Joost\n"
>> "Axel Wernicke\n"
>> "Ulf-D. Ehlert"
> 
> Hmm, is this a really useful information?

Not "useful", but responsible.


> So which "events" are worth to be noted down, and which are not?
> Let's have a look at some sample section history entries:
> 
>       2007-06-16 Added Spanish translation by AntI
>       2006-01-18 en;fr reviewed by j.h
>       2005/11/11 split of from layer-mask.xml by axel.wernicke
>       2008-12-29 j.h: rev. v2.6
>       2007-10-17 ude: moved here from menus/layer-white-balance.xml
>       2006-08-08: created by scb; example by j.h
>       2005-12-07 replaced <simplesect> by <sect3> by lexa
>       2008-01-31 j.h: created
>       2008-12-29 j.h: link to File-references to be fixed
>       2007-10-17 j.h: updated to v2.4 (comment)
>       2006-09-19 lexa: minor change (link enabled)
>       2006-07-03 changed the note en;fr by j.h
>       2006-06-17 added a para en;fr for default image size by j.h
>       2007-05-09 ude: removed filters-artistic-cubism.png
>       2007-05-28 Fixed Auto Follow Active Image by j.h
>       2007-04-21 lexa: fixed bug #420007
>       2010-04-18 ude: changed help-id: old -> new
>       2007-09-05 ude: renamed to "Lens Flare"
> 

We should keep information for creation, modifications in description,
update to new release (because when checking xml files for a new
release, we must see immediately whether a file has been updated without
reading it). So, in your list, we should keep:

>       2007-04-21 lexa: fixed bug #420007
>       2007-05-28 Fixed Auto Follow Active Image by j.h
>       2006-06-17 added a para en;fr for default image size by j.h
>       2006-07-03 changed the note by j.h
>       2008-01-31 j.h: created
>       2008-12-29 j.h: link to File-references to be fixed
>       2007-10-17 j.h: updated to v2.4 (comment)
>       2006-08-08: created by scb; example by j.h
>       2008-12-29 j.h: rev. v2.6

(Sorry, I am mentioned all along because I used "section history"
already in that way.).
So, we have a date and we can refer to the log for details easily.


> HTML output cat be suppressed with a simple template:
> 
>       <xsl:template match="revhistory"/>
> 

If <revhistory> is not used for html, you will have useless tags in xml
files. What is better, (or worse), "section history" or <revhistory>?

Bye,

Julien


_______________________________________________
Gimp-docs mailing list
Gimp-docs@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs

Reply via email to