[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: cua-mode and the tutorial

From: Lennart Borgman
Subject: Re: cua-mode and the tutorial
Date: Tue, 22 Aug 2006 16:30:50 +0200
User-agent: Thunderbird (Windows/20060719)

Kim F. Storm wrote:
The first instruction is to type C-v ... and it doesn't work
as described!
Do you mean that it does not work when cua-mode is enabled? Well, it is a problem. One solution would be to remove CUA mode from the tutorial buffer as you suggests. However I feel uncomfortable with that solution. It puts a burden on the user, "please learn this now, but later on you are going to use that".

A possible solution is perhaps to tell replace C-v in the tutorial with the actual key to use. However that requires rewriting the text since there are also sentences like "do it by holding down the CONTROL key while typing v". (And there are many languages to rewrite.) Maybe that sentence could be removed?

However, in general, your changes have a big problem.
The new informational (yellow) area may take so much
space on the frame that the instructions:

    >>  Now type C-v (View next screen) to move to the next screen.
        (go ahead, do it by holding down the CONTROL key while typing v).
        From now on, you should do this again whenever you finish
        reading the screen.

is partially or even completely hidden, so the whole point of the
tutorial is lost (you have to know how to scroll before you can
learn how to scroll ...).
That is a good point. However most users will still be able to scroll with the arrow keys and the mouse.

It would be much better if you just placed a few yellow lines
near the top with the following wording:

 Some of the standard key bindings described in this tutorial
 have been modified, so Emacs may behave differently from
 what you learn here.  Click here for more details: [Details]
Having less information there is maybe a solution, yes. And using help buffer for details. However I do believe that the tutorial should try to tell the actual key bindings that the user will use. Is not that much easier for those that use CUA mode for example?

And then restore all key bindings (if possible) to their default
inside the tutorial.
This was my original thought, but now I think it is important to let users of CUA mode and Viper mode learn about basic key bindings differences. I think a lot of users will have CUA mode enabled.

This way, you can also structure your code so there is:
- one function which simply checks if any keys are changed
- one function which setup the standard key bindings
- one function to show the details (in a *Help* buffer).
I have restructured the code in the version I sent in the last message. Sorry for the confusion.

I welcome ideas. It is not very easy to make this working well. I can see we have slightly different opinions about what the tutorial should do, teach actual bindings or default bindings or maybe both. I tried the last.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]