unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* etc/refcard.tex update.
@ 2005-07-06 10:21 Lute Kamstra
  2005-07-06 21:44 ` Juri Linkov
  2005-07-06 21:45 ` Juri Linkov
  0 siblings, 2 replies; 23+ messages in thread
From: Lute Kamstra @ 2005-07-06 10:21 UTC (permalink / raw)


I've updated etc/refcard.tex.  Ok to commit?

Lute.


2005-07-06  Lute Kamstra  <lute@gnu.org>

	* refcard.tex: Update `versionnumber' and `year'.  Update Emacs's
	version to 22.
	(Starting Emacs): Delete sentence to fix formatting problems.
	(Query Replace): query-replace-regexp is bound to C-M-%.  Mention
	alternative bindings.
	(Multiple Windows): Clarify first sentence.  Mention C-x 5 1.
	(Formatting): Update the binding of set face.
	(International Character Sets): set-language-environment is bound
	to C-x RET l


Index: etc/refcard.tex
===================================================================
RCS file: /cvsroot/emacs/emacs/etc/refcard.tex,v
retrieving revision 1.9
diff -c -r1.9 refcard.tex
*** etc/refcard.tex	4 Jul 2005 23:32:43 -0000	1.9
--- etc/refcard.tex	6 Jul 2005 10:16:03 -0000
***************
*** 14,20 ****
  \letterpaper=1
  
  % Nothing else needs to be changed below this line.
! % Copyright (c) 1987, 1993, 1996, 1997 Free Software Foundation, Inc.
  
  % This file is part of GNU Emacs.
  
--- 14,20 ----
  \letterpaper=1
  
  % Nothing else needs to be changed below this line.
! % Copyright (c) 1987, 1993, 1996, 1997, 2005 Free Software Foundation, Inc.
  
  % This file is part of GNU Emacs.
  
***************
*** 62,69 ****
  
  % If there were room, it would be nice to see a section on Dired.
  
! \def\versionnumber{2.2}
! \def\year{1997}
  
  \def\shortcopyrightnotice{\vskip 1ex plus 2 fill
    \centerline{\small \copyright\ \year\ Free Software Foundation, Inc.
--- 62,69 ----
  
  % If there were room, it would be nice to see a section on Dired.
  
! \def\versionnumber{2.3}
! \def\year{2005}
  
  \def\shortcopyrightnotice{\vskip 1ex plus 2 fill
    \centerline{\small \copyright\ \year\ Free Software Foundation, Inc.
***************
*** 72,78 ****
  \def\copyrightnotice{
  \vskip 1ex plus 2 fill\begingroup\small
  \centerline{Copyright \copyright\ \year\ Free Software Foundation, Inc.}
! \centerline{v\versionnumber{} for GNU Emacs version 21, \year}
  \centerline{designed by Stephen Gildea}
  
  Permission is granted to make and distribute copies of
--- 72,78 ----
  \def\copyrightnotice{
  \vskip 1ex plus 2 fill\begingroup\small
  \centerline{Copyright \copyright\ \year\ Free Software Foundation, Inc.}
! \centerline{v\versionnumber{} for GNU Emacs version 22, \year}
  \centerline{designed by Stephen Gildea}
  
  Permission is granted to make and distribute copies of
***************
*** 270,282 ****
  
  \title{GNU Emacs Reference Card}
  
! \centerline{(for version 21)}
  
  \section{Starting Emacs}
  
! To enter GNU Emacs 21, just type its name: \kbd{emacs}
! 
! To read in a file to edit, see Files, below.
  
  \section{Leaving Emacs}
  
--- 270,280 ----
  
  \title{GNU Emacs Reference Card}
  
! \centerline{(for version 22)}
  
  \section{Starting Emacs}
  
! To enter GNU Emacs 22, just type its name: \kbd{emacs}
  
  \section{Leaving Emacs}
  
***************
*** 388,413 ****
  \section{Query Replace}
  
  \key{interactively replace a text string}{M-\%}
! \metax{using regular expressions}{M-x query-replace-regexp}
  
  Valid responses in query-replace mode are
  
! \key{{\bf replace} this one, go on to next}{SPC}
  \key{replace this one, don't move}{,}
! \key{{\bf skip} to next without replacing}{DEL}
  \key{replace all remaining matches}{!}
  \key{{\bf back up} to the previous match}{^}
! \key{{\bf exit} query-replace}{RET}
  \key{enter recursive edit (\kbd{C-M-c} to exit)}{C-r}
  
  \section{Multiple Windows}
  
! When two commands are shown, the second is for ``other frame.''
! 
! \key{delete all other windows}{C-x 1}
  
  {\setbox0=\hbox{\kbd{0}}\advance\hsize by 0\wd0
  \paralign to \hsize{#\tabskip=10pt plus 1 fil&#\tabskip=0pt&#\cr
  \threecol{split window, above and below}{C-x 2\ \ \ \ }{C-x 5 2}
  \threecol{delete this window}{C-x 0\ \ \ \ }{C-x 5 0}
  }}
--- 386,411 ----
  \section{Query Replace}
  
  \key{interactively replace a text string}{M-\%}
! \key{using regular expressions}{C-M-\%}
  
  Valid responses in query-replace mode are
  
! \key{{\bf replace} this one, go on to next}{SPC {\rm or} y}
  \key{replace this one, don't move}{,}
! \key{{\bf skip} to next without replacing}{DEL {\rm or} n}
  \key{replace all remaining matches}{!}
  \key{{\bf back up} to the previous match}{^}
! \key{{\bf exit} query-replace}{RET {\rm or} q}
  \key{enter recursive edit (\kbd{C-M-c} to exit)}{C-r}
  
  \section{Multiple Windows}
  
! When two commands are shown, the second is a similar command for a
! frame instead of a window.
  
  {\setbox0=\hbox{\kbd{0}}\advance\hsize by 0\wd0
  \paralign to \hsize{#\tabskip=10pt plus 1 fil&#\tabskip=0pt&#\cr
+ \threecol{delete all other windows}{C-x 1\ \ \ \ }{C-x 5 1}
  \threecol{split window, above and below}{C-x 2\ \ \ \ }{C-x 5 2}
  \threecol{delete this window}{C-x 0\ \ \ \ }{C-x 5 0}
  }}
***************
*** 449,455 ****
  \key{set fill column}{C-x f}
  \key{set prefix each line starts with}{C-x .}
  
! \key{set face}{M-g}
  
  \section{Case Change}
  
--- 447,453 ----
  \key{set fill column}{C-x f}
  \key{set prefix each line starts with}{C-x .}
  
! \key{set face}{M-o}
  
  \section{Case Change}
  
***************
*** 562,568 ****
  
  \section{International Character Sets}
  
! \metax{specify principal language}{M-x set-language-environment}
  \metax{show all input methods}{M-x list-input-methods}
  \key{enable or disable input method}{C-\\}
  \key{set coding system for next command}{C-x RET c}
--- 560,566 ----
  
  \section{International Character Sets}
  
! \key{specify principal language}{C-x RET l}
  \metax{show all input methods}{M-x list-input-methods}
  \key{enable or disable input method}{C-\\}
  \key{set coding system for next command}{C-x RET c}

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-06 10:21 etc/refcard.tex update Lute Kamstra
@ 2005-07-06 21:44 ` Juri Linkov
  2005-07-07  8:10   ` Lute Kamstra
  2005-07-06 21:45 ` Juri Linkov
  1 sibling, 1 reply; 23+ messages in thread
From: Juri Linkov @ 2005-07-06 21:44 UTC (permalink / raw)
  Cc: emacs-devel

> I've updated etc/refcard.tex.  Ok to commit?
>
> 2005-07-06  Lute Kamstra  <lute@gnu.org>
>
> 	* refcard.tex: Update `versionnumber' and `year'.  Update Emacs's
> 	version to 22.

It seems you missed a change to version 22 in the comments
`% Reference Card for GNU Emacs version 21 on Unix systems'.

PS: Perhaps maintainers of refcard's translations should be
notified after all changes in refcard.tex are completed.

-- 
Juri Linkov
http://www.jurta.org/emacs/

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-06 10:21 etc/refcard.tex update Lute Kamstra
  2005-07-06 21:44 ` Juri Linkov
@ 2005-07-06 21:45 ` Juri Linkov
  2005-07-06 23:34   ` Andreas Schwab
                     ` (2 more replies)
  1 sibling, 3 replies; 23+ messages in thread
From: Juri Linkov @ 2005-07-06 21:45 UTC (permalink / raw)
  Cc: emacs-devel

I looked at etc/refcard.tex too and noticed places that need to be fixed
other than those already corrected by Lute.

1. In the section `Files'

\key{version control checkin/checkout}{C-x C-q}

needs to be replaced with

\key{toggle read only}{C-x C-q}
\key{version control checkin/checkout}{C-x v v}

2. In the section `Getting Help' keys `C-x 1' and `C-M-v' in

\key{remove help window}{C-x 1}
\key{scroll help window}{C-M-v}

don't work after typing C-h or F1 that were suggested to type
in the beginning of the same section.

3. IMO, `C-h k' is more useful than `C-h c' for

\key{show the function a key runs}{C-h c}

Even though `C-h k' creates a new window, all three other keys
described in the same block do the same.

4. There is `C-h f' key, but no `C-h v'.

5. There is `M-x recover-file', but no `M-x recover-session'.

6. Search and Replace

Currently such highly related operations as Search and Replace are
described on different refcard pages.  Wouldn't it be better to move
`Incremental Search' down and place it immediately before `Query
Replace'?  Also unlike the section `Query Replace', `Incremental
Search' doesn't distinguish keys used to enter Isearch mode
from keys active in Isearch mode.

7. In the section `Info'

\key{find specified function or variable in Info}{C-h C-i}

the keybinding `C-h C-i' is not available anymore.

-- 
Juri Linkov
http://www.jurta.org/emacs/

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-06 21:45 ` Juri Linkov
@ 2005-07-06 23:34   ` Andreas Schwab
  2005-07-07  6:02     ` Juri Linkov
  2005-07-07  8:32   ` Lute Kamstra
  2005-07-07 21:31   ` Richard M. Stallman
  2 siblings, 1 reply; 23+ messages in thread
From: Andreas Schwab @ 2005-07-06 23:34 UTC (permalink / raw)
  Cc: Lute Kamstra, emacs-devel

Juri Linkov <juri@jurta.org> writes:

> 5. There is `M-x recover-file', but no `M-x recover-session'.

recover-session is an interactive compiled Lisp function in `files'.
It is bound to <menu-bar> <file> <recover-session>.
(recover-session)

Andreas.

-- 
Andreas Schwab, SuSE Labs, schwab@suse.de
SuSE Linux Products GmbH, Maxfeldstraße 5, 90409 Nürnberg, Germany
Key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-06 23:34   ` Andreas Schwab
@ 2005-07-07  6:02     ` Juri Linkov
  2005-07-07  8:46       ` Andreas Schwab
  0 siblings, 1 reply; 23+ messages in thread
From: Juri Linkov @ 2005-07-07  6:02 UTC (permalink / raw)
  Cc: lute.kamstra.lists, emacs-devel

>> 5. There is `M-x recover-file', but no `M-x recover-session'.
>
> recover-session is an interactive compiled Lisp function in `files'.
> It is bound to <menu-bar> <file> <recover-session>.
> (recover-session)

Yes, I meant exactly the same command.  I think `M-x recover-session'
is a more useful command to know than `M-x recover-file', because when
the user visits a file that needs recovering after a system crash, then
Emacs displays a warning with instructions how to recover the file
(`M-x recover-this-file'), but the user might not know about
`recover-session' to recover all files.

-- 
Juri Linkov
http://www.jurta.org/emacs/

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-06 21:44 ` Juri Linkov
@ 2005-07-07  8:10   ` Lute Kamstra
  0 siblings, 0 replies; 23+ messages in thread
From: Lute Kamstra @ 2005-07-07  8:10 UTC (permalink / raw)
  Cc: emacs-devel

Juri Linkov <juri@jurta.org> writes:

> It seems you missed a change to version 22 in the comments
> `% Reference Card for GNU Emacs version 21 on Unix systems'.

Thanks.  Fixed.

> PS: Perhaps maintainers of refcard's translations should be
> notified after all changes in refcard.tex are completed.

You read my thoughts.

Lute.

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-06 21:45 ` Juri Linkov
  2005-07-06 23:34   ` Andreas Schwab
@ 2005-07-07  8:32   ` Lute Kamstra
  2005-07-09 20:57     ` Juri Linkov
  2005-07-07 21:31   ` Richard M. Stallman
  2 siblings, 1 reply; 23+ messages in thread
From: Lute Kamstra @ 2005-07-07  8:32 UTC (permalink / raw)
  Cc: emacs-devel

Juri Linkov <juri@jurta.org> writes:

> I looked at etc/refcard.tex too and noticed places that need to be fixed
> other than those already corrected by Lute.
>
> 1. In the section `Files'
>
> \key{version control checkin/checkout}{C-x C-q}
>
> needs to be replaced with
>
> \key{toggle read only}{C-x C-q}
> \key{version control checkin/checkout}{C-x v v}

Ah, I missed that one.  I don't think there is room to add a line.
You'll have to choose between the two.

> 2. In the section `Getting Help' keys `C-x 1' and `C-M-v' in
>
> \key{remove help window}{C-x 1}
> \key{scroll help window}{C-M-v}
>
> don't work after typing C-h or F1 that were suggested to type
> in the beginning of the same section.

They work for me.  If I type C-h and follow the directions (I type ?
and then, say, b to get a list of bindings), I get a new window with a
*Help* buffer and I can use C-M-v to scroll it and C-x 1 to get rid of
it.

> 3. IMO, `C-h k' is more useful than `C-h c' for
>
> \key{show the function a key runs}{C-h c}

Agreed.

> Even though `C-h k' creates a new window, all three other keys
> described in the same block do the same.
>
> 4. There is `C-h f' key, but no `C-h v'.

I don't think there is room for an extra line, but you can try.

> 5. There is `M-x recover-file', but no `M-x recover-session'.

recover-session seems more useful to mention indeed.

> 6. Search and Replace
>
> Currently such highly related operations as Search and Replace are
> described on different refcard pages.  Wouldn't it be better to move
> `Incremental Search' down and place it immediately before `Query
> Replace'?

On a 2 or 3 column refcard, the two are side by side.  Moving them
around might give quite some formatting headaches, but you're free to
try.

> Also unlike the section `Query Replace', `Incremental Search'
> doesn't distinguish keys used to enter Isearch mode from keys active
> in Isearch mode.
>
> 7. In the section `Info'
>
> \key{find specified function or variable in Info}{C-h C-i}
>
> the keybinding `C-h C-i' is not available anymore.

Is there a new binding?

Lute.

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-07  6:02     ` Juri Linkov
@ 2005-07-07  8:46       ` Andreas Schwab
  0 siblings, 0 replies; 23+ messages in thread
From: Andreas Schwab @ 2005-07-07  8:46 UTC (permalink / raw)
  Cc: lute.kamstra.lists, emacs-devel

Juri Linkov <juri@jurta.org> writes:

>>> 5. There is `M-x recover-file', but no `M-x recover-session'.
>>
>> recover-session is an interactive compiled Lisp function in `files'.
>> It is bound to <menu-bar> <file> <recover-session>.
>> (recover-session)
>
> Yes, I meant exactly the same command.

Sorry, I misunderstood you.

Andreas.

-- 
Andreas Schwab, SuSE Labs, schwab@suse.de
SuSE Linux Products GmbH, Maxfeldstraße 5, 90409 Nürnberg, Germany
Key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-06 21:45 ` Juri Linkov
  2005-07-06 23:34   ` Andreas Schwab
  2005-07-07  8:32   ` Lute Kamstra
@ 2005-07-07 21:31   ` Richard M. Stallman
  2005-07-09 20:57     ` Juri Linkov
  2 siblings, 1 reply; 23+ messages in thread
From: Richard M. Stallman @ 2005-07-07 21:31 UTC (permalink / raw)
  Cc: Lute.Kamstra.lists, emacs-devel

Aside from the following points, would you please install fixes for
the problems you found?

    2. In the section `Getting Help' keys `C-x 1' and `C-M-v' in

    \key{remove help window}{C-x 1}
    \key{scroll help window}{C-M-v}

    don't work after typing C-h or F1 that were suggested to type
    in the beginning of the same section.

I don't understand the problem.  What is the full scenario?

    4. There is `C-h f' key, but no `C-h v'.

Let's add C-h v _if there is room_.

    5. There is `M-x recover-file', but no `M-x recover-session'.

Let's replace recover-file with recover-session.

    Currently such highly related operations as Search and Replace are
    described on different refcard pages.  Wouldn't it be better to move
    `Incremental Search' down and place it immediately before `Query
    Replace'?

Having them near each other would be better.  However, searching is
pretty important, so perhaps moving it later is a change for the
worse.  I am not sure which way is better overall--it is not
self-evident.  One needs to look at both versions printed out.

Also, moving the sections around is tricky--it can cause pages not to
fit.  The refcard is not like a manual, where you can add or rearrange
material without worrying.  You have to check the output after each
change.

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-07 21:31   ` Richard M. Stallman
@ 2005-07-09 20:57     ` Juri Linkov
  2005-07-10 17:35       ` Richard M. Stallman
  0 siblings, 1 reply; 23+ messages in thread
From: Juri Linkov @ 2005-07-09 20:57 UTC (permalink / raw)
  Cc: lute.kamstra.lists, emacs-devel

>     2. In the section `Getting Help' keys `C-x 1' and `C-M-v' in
>
>     \key{remove help window}{C-x 1}
>     \key{scroll help window}{C-M-v}
>
>     don't work after typing C-h or F1 that were suggested to type
>     in the beginning of the same section.
>
> I don't understand the problem.  What is the full scenario?

I meant that `C-h ? C-M-v' doesn't work.  But don't worry, refcard
is not a place for such nuances, and the phrase `follow the directions'
is sufficient.

>     Currently such highly related operations as Search and Replace are
>     described on different refcard pages.  Wouldn't it be better to move
>     `Incremental Search' down and place it immediately before `Query
>     Replace'?
>
> Having them near each other would be better.  However, searching is
> pretty important, so perhaps moving it later is a change for the
> worse.  I am not sure which way is better overall--it is not
> self-evident.  One needs to look at both versions printed out.

As Lute pointed out, on a 2 column refcard they are side by side,
so let's not move them.

What still bothers me in `Query Replace' is that `C-M-%' is not
mentioned.  Lute added a comment saying that it can't be typed on
consoles.  But is it a reason for majority of users (X, xterm,
MSWindows, MacOS) to not know about `C-M-%'?  Users who can't type
`C-M-%' on consoles, have other means (manuals, help facility) to find
a replacement command.

-- 
Juri Linkov
http://www.jurta.org/emacs/

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-07  8:32   ` Lute Kamstra
@ 2005-07-09 20:57     ` Juri Linkov
  2005-07-10  7:51       ` Lute Kamstra
  2005-07-10 17:35       ` Richard M. Stallman
  0 siblings, 2 replies; 23+ messages in thread
From: Juri Linkov @ 2005-07-09 20:57 UTC (permalink / raw)
  Cc: emacs-devel

>> 1. In the section `Files'
>>
>> \key{version control checkin/checkout}{C-x C-q}
>>
>> needs to be replaced with
>>
>> \key{toggle read-only}{C-x C-q}
>> \key{version control checkin/checkout}{C-x v v}
>
> Ah, I missed that one.  I don't think there is room to add a line.
> You'll have to choose between the two.

>From these two, {C-x v v} is more specialized, so let's leave only
{C-x C-q}.

>> 7. In the section `Info'
>>
>> \key{find specified function or variable in Info}{C-h C-i}
>>
>> the keybinding `C-h C-i' is not available anymore.
>
> Is there a new binding?

Currently `C-h C-i' is unbound.  Some time ago I proposed to bind it
to `info' to make it easier to enter Info browser (you don't need
to release the Control key during typing a sequence like `C-2 C-h C-i'),
but it was rejected with the argument to reserve it for something more
useful.

-- 
Juri Linkov
http://www.jurta.org/emacs/

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-09 20:57     ` Juri Linkov
@ 2005-07-10  7:51       ` Lute Kamstra
  2005-07-11  0:05         ` Juri Linkov
  2005-07-11  5:34         ` Richard M. Stallman
  2005-07-10 17:35       ` Richard M. Stallman
  1 sibling, 2 replies; 23+ messages in thread
From: Lute Kamstra @ 2005-07-10  7:51 UTC (permalink / raw)
  Cc: emacs-devel

Juri Linkov <juri@jurta.org> writes:

[...]

>>> 7. In the section `Info'
>>>
>>> \key{find specified function or variable in Info}{C-h C-i}
>>>
>>> the keybinding `C-h C-i' is not available anymore.
>>
>> Is there a new binding?
>
> Currently `C-h C-i' is unbound.  Some time ago I proposed to bind it
> to `info' to make it easier to enter Info browser (you don't need
> to release the Control key during typing a sequence like `C-2 C-h C-i'),
> but it was rejected with the argument to reserve it for something more
> useful.

What I actually meant was: is there a new binding for the function
formerly bound to C-h C-i.  I checked with on old version of Emacs
that C-h C-i ran info-lookup-symbol and that that function is now
bound to C-h S.  So maybe we should now just list:

  \key{find specified function or variable in Info}{C-h S}

Lute.

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-09 20:57     ` Juri Linkov
@ 2005-07-10 17:35       ` Richard M. Stallman
  2005-07-10 23:48         ` Juri Linkov
  0 siblings, 1 reply; 23+ messages in thread
From: Richard M. Stallman @ 2005-07-10 17:35 UTC (permalink / raw)
  Cc: lute.kamstra.lists, emacs-devel

    What still bothers me in `Query Replace' is that `C-M-%' is not
    mentioned.  Lute added a comment saying that it can't be typed on
    consoles.  But is it a reason for majority of users (X, xterm,
    MSWindows, MacOS) to not know about `C-M-%'?  Users who can't type
    `C-M-%' on consoles, have other means (manuals, help facility) to find
    a replacement command.

I would not mind mentioning it, if there is room.

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-09 20:57     ` Juri Linkov
  2005-07-10  7:51       ` Lute Kamstra
@ 2005-07-10 17:35       ` Richard M. Stallman
  2005-07-10 18:30         ` David Kastrup
  1 sibling, 1 reply; 23+ messages in thread
From: Richard M. Stallman @ 2005-07-10 17:35 UTC (permalink / raw)
  Cc: Lute.Kamstra.lists, emacs-devel

    >> \key{find specified function or variable in Info}{C-h C-i}
    >>
    >> the keybinding `C-h C-i' is not available anymore.
    >
    > Is there a new binding?

I think the new key for this job is C-h F.
It does not exactly fit that description, since it works
only for commands.

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-10 17:35       ` Richard M. Stallman
@ 2005-07-10 18:30         ` David Kastrup
  0 siblings, 0 replies; 23+ messages in thread
From: David Kastrup @ 2005-07-10 18:30 UTC (permalink / raw)
  Cc: Juri Linkov, Lute.Kamstra.lists, emacs-devel

"Richard M. Stallman" <rms@gnu.org> writes:

>     >> \key{find specified function or variable in Info}{C-h C-i}
>     >>
>     >> the keybinding `C-h C-i' is not available anymore.
>     >
>     > Is there a new binding?
>
> I think the new key for this job is C-h F.
> It does not exactly fit that description, since it works
> only for commands.

Sounds more like C-h S to me.

-- 
David Kastrup, Kriemhildstr. 15, 44793 Bochum

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-10 17:35       ` Richard M. Stallman
@ 2005-07-10 23:48         ` Juri Linkov
  2005-07-11  8:14           ` Kim F. Storm
  0 siblings, 1 reply; 23+ messages in thread
From: Juri Linkov @ 2005-07-10 23:48 UTC (permalink / raw)
  Cc: lute.kamstra.lists, emacs-devel

[-- Attachment #1: Type: text/plain, Size: 464 bytes --]

>     What still bothers me in `Query Replace' is that `C-M-%' is not
>     mentioned.  Lute added a comment saying that it can't be typed on
>     consoles.  But is it a reason for majority of users (X, xterm,
>     MSWindows, MacOS) to not know about `C-M-%'?  Users who can't type
>     `C-M-%' on consoles, have other means (manuals, help facility) to find
>     a replacement command.
>
> I would not mind mentioning it, if there is room.

There is no room:


[-- Attachment #2: query-replace.png --]
[-- Type: image/png, Size: 3909 bytes --]

[-- Attachment #3: Type: text/plain, Size: 45 bytes --]


-- 
Juri Linkov
http://www.jurta.org/emacs/

[-- Attachment #4: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-10  7:51       ` Lute Kamstra
@ 2005-07-11  0:05         ` Juri Linkov
  2005-07-11 16:53           ` Richard M. Stallman
  2005-07-11  5:34         ` Richard M. Stallman
  1 sibling, 1 reply; 23+ messages in thread
From: Juri Linkov @ 2005-07-11  0:05 UTC (permalink / raw)
  Cc: emacs-devel

> What I actually meant was: is there a new binding for the function
> formerly bound to C-h C-i.  I checked with on old version of Emacs
> that C-h C-i ran info-lookup-symbol and that that function is now
> bound to C-h S.  So maybe we should now just list:
>
>   \key{find specified function or variable in Info}{C-h S}

I think this is ok.

There are other useful Info commands (and some of them are new).
I am not sure to what extent to add them to refcard.tex (and also
to what extent to document them in the Info manual).  At least,
I think `t' definitely should be added to refcard.tex.

BTW, would you object if I will move your added line for `C-x 0'
two lines higher to the more logical place for it?

Below is the composite patch (I think `diff -u' is more appropriate
here):

Index: etc/refcard.tex
===================================================================
RCS file: /cvsroot/emacs/emacs/etc/refcard.tex,v
retrieving revision 1.10
diff -u -r1.10 refcard.tex
--- etc/refcard.tex	7 Jul 2005 08:06:42 -0000	1.10
+++ etc/refcard.tex	11 Jul 2005 00:05:04 -0000
@@ -289,7 +289,7 @@
 \key{{\bf insert} contents of another file into this buffer}{C-x i}
 \key{replace this file with the file you really want}{C-x C-v}
 \key{write buffer to a specified file}{C-x C-w}
-\key{version control checkin/checkout}{C-x C-q}
+\key{toggle read-only status of buffer}{C-x C-q}
 
 \section{Getting Help}
 
@@ -301,14 +301,14 @@
 \key{scroll help window}{C-M-v}
 
 \key{apropos: show commands matching a string}{C-h a}
-\key{show the function a key runs}{C-h c}
+\key{describe the function a key runs}{C-h k}
 \key{describe a function}{C-h f}
 \key{get mode-specific information}{C-h m}
 
 \section{Error Recovery}
 
 \key{{\bf abort} partially typed or executing command}{C-g}
-\metax{{\bf recover} a file lost by a system crash}{M-x recover-file}
+\metax{{\bf recover} files lost by a system crash}{M-x recover-session}
 \metax{{\bf undo} an unwanted change}{C-x u, C-_ {\rm or} C-/}
 \metax{restore a buffer to its original contents}{M-x revert-buffer}
 \key{redraw garbaged screen}{C-l}
@@ -407,9 +407,9 @@
 
 {\setbox0=\hbox{\kbd{0}}\advance\hsize by 0\wd0
 \paralign to \hsize{#\tabskip=10pt plus 1 fil&#\tabskip=0pt&#\cr
+\threecol{delete this window}{C-x 0\ \ \ \ }{C-x 5 0}
 \threecol{delete all other windows}{C-x 1\ \ \ \ }{C-x 5 1}
 \threecol{split window, above and below}{C-x 2\ \ \ \ }{C-x 5 2}
-\threecol{delete this window}{C-x 0\ \ \ \ }{C-x 5 0}
 }}
 \key{split window, side by side}{C-x 3}
 
@@ -572,7 +572,7 @@
 \section{Info}
 
 \key{enter the Info documentation reader}{C-h i}
-\key{find specified function or variable in Info}{C-h C-i}
+\key{find specified function or variable in Info}{C-h S}
 \beginindentedkeys
 
 Moving within a node:
@@ -591,6 +591,7 @@
 \key{follow cross reference  (return with \kbd{l})}{f}
 \key{return to last node you saw}{l}
 \key{return to directory node}{d}
+\key{go to top node of Info file}{t}
 \key{go to any node by name}{g}
 
 Other:

-- 
Juri Linkov
http://www.jurta.org/emacs/

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-10  7:51       ` Lute Kamstra
  2005-07-11  0:05         ` Juri Linkov
@ 2005-07-11  5:34         ` Richard M. Stallman
  1 sibling, 0 replies; 23+ messages in thread
From: Richard M. Stallman @ 2005-07-11  5:34 UTC (permalink / raw)
  Cc: juri, emacs-devel

    What I actually meant was: is there a new binding for the function
    formerly bound to C-h C-i.  I checked with on old version of Emacs
    that C-h C-i ran info-lookup-symbol and that that function is now
    bound to C-h S.  So maybe we should now just list:

      \key{find specified function or variable in Info}{C-h S}

If C-h S is the right key, by all means please put that in.

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-10 23:48         ` Juri Linkov
@ 2005-07-11  8:14           ` Kim F. Storm
  2005-07-12  6:38             ` Juri Linkov
  0 siblings, 1 reply; 23+ messages in thread
From: Kim F. Storm @ 2005-07-11  8:14 UTC (permalink / raw)
  Cc: rms, lute.kamstra.lists, emacs-devel

Juri Linkov <juri@jurta.org> writes:

>>     What still bothers me in `Query Replace' is that `C-M-%' is not
>>     mentioned.  Lute added a comment saying that it can't be typed on
>>     consoles.  But is it a reason for majority of users (X, xterm,
>>     MSWindows, MacOS) to not know about `C-M-%'?  Users who can't type
>>     `C-M-%' on consoles, have other means (manuals, help facility) to find
>>     a replacement command.
>>
>> I would not mind mentioning it, if there is room.
>
> There is no room:

C-x @ c m %

Oh, damn, there is no way to apply both control and meta that way.
Shouldn't there be?

E.g.

C-x @ C M %

-- 
Kim F. Storm <storm@cua.dk> http://www.cua.dk

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-11  0:05         ` Juri Linkov
@ 2005-07-11 16:53           ` Richard M. Stallman
  0 siblings, 0 replies; 23+ messages in thread
From: Richard M. Stallman @ 2005-07-11 16:53 UTC (permalink / raw)
  Cc: Lute.Kamstra.lists, emacs-devel

    BTW, would you object if I will move your added line for `C-x 0'
    two lines higher to the more logical place for it?

I think it belongs where it is.  I think of it as more advanced
than the other commands that come before it.

The rest of these changes are ok (adding `t' is ok if it fits).

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-11  8:14           ` Kim F. Storm
@ 2005-07-12  6:38             ` Juri Linkov
  2005-07-12 11:19               ` Kim F. Storm
  2005-07-13  5:17               ` Richard M. Stallman
  0 siblings, 2 replies; 23+ messages in thread
From: Juri Linkov @ 2005-07-12  6:38 UTC (permalink / raw)
  Cc: rms, lute.kamstra.lists, emacs-devel

>>>     What still bothers me in `Query Replace' is that `C-M-%' is not
>>>     mentioned.  Lute added a comment saying that it can't be typed on
>>>     consoles.  But is it a reason for majority of users (X, xterm,
>>>     MSWindows, MacOS) to not know about `C-M-%'?  Users who can't type
>>>     `C-M-%' on consoles, have other means (manuals, help facility) to find
>>>     a replacement command.
>>>
>>> I would not mind mentioning it, if there is room.
>>
>> There is no room:
>
> C-x @ c m %
>
> Oh, damn, there is no way to apply both control and meta that way.

The Emacs manual suggest `C-x @ h C-a' to enter `Hyper-Control-a'.
So `C-x @ c M-%' seems natural to enter `C-M-%'.  But it doesn't work.
It translates `C-x @ c M-%' to two separate key presses: `C-x @ c ESC'
(i.e. C-ESC) and `%'.  Is it possible to make `C-x @ c M-%' to work
on consoles?

> Shouldn't there be?
>
> E.g.
>
> C-x @ C M %

This is a shorter key sequence for typing a key with the help of `C-x @'
than using `C-x @' twice which is mentioned in the manual as a currently
impossible way to add two modifiers.  Also with upper-case letters it
looks like the standard syntax for `C-M-%' without hyphens.

But there is a conflict between Shift and Super, which use the
same character modifier with different case.

-- 
Juri Linkov
http://www.jurta.org/emacs/

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-12  6:38             ` Juri Linkov
@ 2005-07-12 11:19               ` Kim F. Storm
  2005-07-13  5:17               ` Richard M. Stallman
  1 sibling, 0 replies; 23+ messages in thread
From: Kim F. Storm @ 2005-07-12 11:19 UTC (permalink / raw)
  Cc: rms, lute.kamstra.lists, emacs-devel

Juri Linkov <juri@jurta.org> writes:

>> C-x @ C M %
>
> This is a shorter key sequence for typing a key with the help of `C-x @'
> than using `C-x @' twice which is mentioned in the manual as a currently
> impossible way to add two modifiers.  Also with upper-case letters it
> looks like the standard syntax for `C-M-%' without hyphens.
>
> But there is a conflict between Shift and Super, which use the
> same character modifier with different case.

Yes, it makes the following sequence ambiguous:

C-x @ M S C %

But how do I enter M-C-S ?   Not like this:

C-x @ M C S



Maybe this would work:

C-x @ m @ c @ S %         => M-C-S-%

C-x @ m @ c @ S s         => M-C-S

C-x @ m @ c @ S @ @       => M-C-S-@



A little more cryptic would be to let a control char mean to add
modifier and read one more modifier:

C-x @ C-m C-c S %  => M-C-S-%



Or we could add an explicit group operator:

C-x @ ( m c S ) %

or to make it easier to type:

C-x @ @ m c S @ %

or (if we apply modifiers to a non-letter key):

C-x @ @ m c S %           => M-C-S-%

C-x @ @ m c S @ s         => M-C-S

C-x @ @ m c S @ @         => M-C-S-@




-- 
Kim F. Storm <storm@cua.dk> http://www.cua.dk

^ permalink raw reply	[flat|nested] 23+ messages in thread

* Re: etc/refcard.tex update.
  2005-07-12  6:38             ` Juri Linkov
  2005-07-12 11:19               ` Kim F. Storm
@ 2005-07-13  5:17               ` Richard M. Stallman
  1 sibling, 0 replies; 23+ messages in thread
From: Richard M. Stallman @ 2005-07-13  5:17 UTC (permalink / raw)
  Cc: emacs-devel, lute.kamstra.lists, storm

If there is no room to mention C-M-%, why argue
about how to type it on a tty?

Anyway, I don't think we need to worry about tty's for this
particular thing.  If there were room, it would be good enough
to say `C-M-%'.  It is unfortunate that this non-issue distracted
people's attention.

^ permalink raw reply	[flat|nested] 23+ messages in thread

end of thread, other threads:[~2005-07-13  5:17 UTC | newest]

Thread overview: 23+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2005-07-06 10:21 etc/refcard.tex update Lute Kamstra
2005-07-06 21:44 ` Juri Linkov
2005-07-07  8:10   ` Lute Kamstra
2005-07-06 21:45 ` Juri Linkov
2005-07-06 23:34   ` Andreas Schwab
2005-07-07  6:02     ` Juri Linkov
2005-07-07  8:46       ` Andreas Schwab
2005-07-07  8:32   ` Lute Kamstra
2005-07-09 20:57     ` Juri Linkov
2005-07-10  7:51       ` Lute Kamstra
2005-07-11  0:05         ` Juri Linkov
2005-07-11 16:53           ` Richard M. Stallman
2005-07-11  5:34         ` Richard M. Stallman
2005-07-10 17:35       ` Richard M. Stallman
2005-07-10 18:30         ` David Kastrup
2005-07-07 21:31   ` Richard M. Stallman
2005-07-09 20:57     ` Juri Linkov
2005-07-10 17:35       ` Richard M. Stallman
2005-07-10 23:48         ` Juri Linkov
2005-07-11  8:14           ` Kim F. Storm
2005-07-12  6:38             ` Juri Linkov
2005-07-12 11:19               ` Kim F. Storm
2005-07-13  5:17               ` Richard M. Stallman

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).