David Bullock wrote:
> Hussein Shafie wrote:
> 
>> [*] Have you tried Ctrl-Enter? Very handy too.
>>  
>>
> Indeed, it's good, and I use it.  But I had to work very hard to print
> out the 'cheat sheet' pasted to my monitor, and it's not very well
> organised.

XXE has tons of documentation. The online help is just the reference of
the static menus and buttons, that is, one of the *least* useful
documents in the whole documentation set.

For example, if you use XXE to author DocBook documents, you'll find the
reference of the few key bindings which are specific to DocBook (e.g.
Ctrl-Enter) here:
http://www.xmlmind.com/xmleditor/_distrib/doc/docbook/docbook_bindings.html
(This document is also part of the online help.)

If you also author XHTML pages, you'll find the reference of the few key
bindings which are specific to XHTML (e.g. Shift-Enter) here:
http://www.xmlmind.com/xmleditor/_distrib/doc/xhtml/xhtml_bindings.html
(This document is also part of the online help.)

For a quick (and, I agree, somewhat obscure) reference of keybindings
which is always up to date, use Help|Mouse and Key Bindings.

XXE being a generic, customizable, extensible, XML editor, we don't see
how to come up with something better (yet).

Not to say that what we did is good. For example, IMHO, Sun's JavaHelp
online help browser is unusable, mainly because Java cannot decently
render HTML.

So, why improve the online help when the standard online help browser is
unusable? The real online help is found here:
http://www.xmlmind.com/xmleditor/documentation.shtml (a copy is included
in the distribution).



> Also, the concept of the 'implicit element selection' isn't something
> that has surfaced to my level of consciousness as a  user of the
> editor.  Yet it would surely help (at least, it would help me) to know
> about it.
> 
> All this to say that some conceptual documentation, perhaps a simple
> tutorial, and a printable key-binding reference would go a long way
> towards bringing out XXE's jewels before a wider and more appreciative
> public.

It is almost impossible to use XXE efficiently[*] without having read
http://www.xmlmind.com/xmleditor/_distrib/doc/user/tutorial_basics.html

This tutorial explains all the concepts, including the 'implicit element
selection' (which is a *fundamental* one).





> Even if you took a leaf out of IntelliJ's book (a Java IDE I'm sure you
> probably use) 

No, but I have already played with this advanced IDE.



> and had a 'tip of the day' on startup, along with a
> per-user measure of how often certain shortcuts/features had been used
> which guided what tips were shown (no point pestering them with tips
> they already use regularly).

IntelliJ developers are ``extreme GUI programmers''. We, at XMLmind, are
clearly not as good at creating GUIs as they are.


---
[*] If you can use XXE efficiently without having read its tutorial,
then you probably have a very high IQ ;-)


Reply via email to