Created attachment 52291 [details]
A new version as XML-file

What's attached here is actually a tar.gz. It contains an XML file and XSLTs to
transform this into HTML and SVG.

I wonder what we should best do with this. We could integrate it into the user
manual and delegate maintainance of it to the gimp-docs team. We could install
the generated HTML with the GIMP source code and add a menu entry for it to the
Help menu.

I wonder if it is feasible to automatically update the reference when the user
adds or changes keyboard shortcuts.

Under which license is the attached XML file distributed? It seems, it's part
from inkscape?

Anyway, creating such a reference automatically would be indeed very usefull and
maintainable. If the GIMP can export the current set keybindings as an XML file,
it'll be easy to generate DocBook/XML, SVG or an HTML file for the online help.

Let's focus on what we have. And what we have is the documents that Tobias
created here. Now where should they be integrated?

I would like to add the keys to the manual. It's probably confusing if we
provide help content with the GIMP itself. I try to write an XSLT to transform
the keys.xml to DocBook/XML, so we can include it in the manual. Would it be
possible to add a new help id to the current set of ids in GIMP which maps to
the key reference?

I wrote a stylesheet which transformed the gimp-keys.xml to a DocBook/XML
reference. I'm not sure how we going to handle other languages than english, but
it is included in the (english) manual now:

  http://docs.gimp.org/en/rn01.html

Not sure, but wouldn't it be more useful to have one page with all shortcuts?

2005-09-28  Sven Neumann  <sven@gimp.org>

	* docs/Makefile.am
	* docs/keybindings.txt
	* docs/quick_reference.ps
	* docs/quick_reference.tar.gz: removed outdated documentation that
	is now being maintained in the user manual (bug #316423).

I think, one page with all shortcuts would make it easyer to print it out.

I asked a LaTeX guru for help, but he had no time to look into this so far. I'll try to come up with a better solution.

I don't this needs to be on the GIMP 2.4 milestone as it only affects the user manual. Moving off the milestone and changing the summary.

We should provide printable sheets for until the next release of the manual.