Re: section history

["Ulf-D. Ehlert" <ude88@xxxxxx>]

jhardlin (Tuesday, 08. June 2010)
> 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?

> > Adding <revhistory>s again and using them according to the
> > examples in "DocBook: The Definitive Guide" may be better than
> > using our selfmade "section history" comments (we should
> > suppress the output to HTML, IMHO). But isn't one <revhistory>
> > for every XML file an overkill?
> 
> I agree with you. As they are now, "section history" are outdated.
> But I still think that they are interesting. We must only use them
> for creation and new features, not for typo corrections, changes
> in xml structure...(translation is no longer topical).

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"

> <revhistory> is not convenient:
> - it will give a long and tedious list in the xml file

Depends on what we add to the history.

> - it will appear in html and that is not useful

HTML output cat be suppressed with a simple template:

	<xsl:template match="revhistory"/>

Bye,
Ulf


PS: How to get a sample section history: define a shell function, e.g.
	get-random-history() {
		test "$N" -gt 0 2>/dev/null ||
		N=`find src/ -type f -name '*.xml' | wc -l`
		n=`expr $RANDOM \% $N + 1`
		f=`find src/ -type f -name '*.xml' | sed -e "$n"'!d'`
		echo $f
		sed -e '/[Ss]ection [Hh]istory/,/-->/!d' $f
	}
... and type "get-random-history".

Attachment: signature.asc
Description: This is a digitally signed message part.

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