bug-texinfo
[Top][All Lists]
Advanced

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

Re: simpler help texts, default key for delete-window


From: Benno Schulenberg
Subject: Re: simpler help texts, default key for delete-window
Date: Thu, 28 Feb 2008 22:49:27 +0100
User-agent: KMail/1.9.7

Karl Berry wrote:
>     An alternative might be to bind "{" and "}" to
>     search-previous and search-next.
>
> I don't mind that on the basis of the keys, but I question
> whether these functions really need such bindings.  It seems to
> me the natural way to "search again" (forward) is to hit s RET.
> That's what I've always done myself -- I never even knew
> search-previous/next existed.

But 'search next/previous' exist in just about every program that 
offers searching, for example N/Shift-N in vim and less, and 
F3/Shift-F3 in Firefox and many KDE programs.  Many people will 
expect them to exist in 'info'.

> As for search-backward, we've already discussed the general
> weirdnesses of going backwards.

In vim and less I regularly search backwards, going to the end of 
the file and typing ?string<Enter>.  I agree that in a manual this 
is probably a strange thing to do, but in log files it is normal.

> See if it passes muster now, please ...

It's better.  But the proposed line explaining Ctrl-G is missing, 
the blank line before "1...9" is missing, and the following is in my 
opinion not a good change:

-  N_("\\%-10[history-node]  Go back to the last node seen in this window.\n"),
+  N_("\\%-10[history-node]  Return to the previous node seen in this 
window.\n"),

It is better to say "last node", to get the mnemonic for the "l" 
key, and it's probably better to say "go back", to indicate that it 
works like the back-button in a browser.  And somehow "back back 
back" sounds linear, whereas "return return return" sounds like 
going back and forth.

In my opinion there is no need the mention the "n" and "p" keys, but 
if you want to keep them, the following may be better descriptions:

n           Go to the next node on this level.
p           Go to the previous node on this level.

The block of five lines in info/infomap.c that starts with
"/* We want help to report q, not C-x C-c, etc.  */"
should be moved to the end of the function, and these two lines must 
be moved there too to get "Up" and "Down" to display correctly in 
the help text:

        SK_ESCAPE, SK_UP_ARROW, NUL,            A_info_prev_line,
        SK_ESCAPE, SK_DOWN_ARROW, NUL,          A_info_next_line,

Benno




reply via email to

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