all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#14087: [PATCH] Some fixes for refcard.tex
@ 2013-03-29  9:02 Xue Fuqiao
  2013-05-08 17:18 ` Glenn Morris
  2013-05-25  2:18 ` Xue Fuqiao
  0 siblings, 2 replies; 6+ messages in thread
From: Xue Fuqiao @ 2013-03-29  9:02 UTC (permalink / raw)
  To: 14087

The following patch refines some entries in etc/refcards/refcard.tex:

diff -cp trunk/etc/refcards/refcard.tex.orig trunk/etc/refcards/refcard.tex
*** trunk/etc/refcards/refcard.tex.orig	2013-03-10 06:42:26.000000000 +0800
--- trunk/etc/refcards/refcard.tex	2013-03-29 16:54:48.000000000 +0800
*************** If Emacs is still searching, \kbd{C-g} c
*** 355,360 ****
--- 355,361 ----
  \key{scroll current line to center, top, bottom}{C-l}
  
  \key{goto line}{M-g g}
+ \key{goto char}{M-g c}
  \key{back to indentation}{M-m}
  
  \section{Killing and Deleting}
*************** minibuffer.  Type \kbd{F10} to activate
*** 504,509 ****
--- 505,511 ----
  \key{check spelling of current word}{M-\$}
  \metax{check spelling of all words in region}{M-x ispell-region}
  \metax{check spelling of entire buffer}{M-x ispell-buffer}
+ \metax{toggle on-the-fly spell checking}{M-x flyspell-mode}
  
  \section{Tags}
  
*************** minibuffer.  Type \kbd{F10} to activate
*** 512,523 ****
  \metax{specify a new tags file}{M-x visit-tags-table}
  
  \metax{regexp search on all files in tags table}{M-x tags-search}
! \metax{run query-replace on all the files}{M-x tags-query-replace}
  \key{continue last tags search or query-replace}{M-,}
  
  \section{Shells}
  
  \key{execute a shell command}{M-!}
  \key{run a shell command on the region}{M-|}
  \key{filter region through a shell command}{C-u M-|}
  \key{start a shell in window \kbd{*shell*}}{M-x shell}
--- 514,526 ----
  \metax{specify a new tags file}{M-x visit-tags-table}
  
  \metax{regexp search on all files in tags table}{M-x tags-search}
! \metax{run {\bf query-replace-regexp} on all files listed in tags table}{M-x tags-query-replace}
  \key{continue last tags search or query-replace}{M-,}
  
  \section{Shells}
  
  \key{execute a shell command}{M-!}
+ \key{execute a shell command asynchronously}{M-&}
  \key{run a shell command on the region}{M-|}
  \key{filter region through a shell command}{C-u M-|}
  \key{start a shell in window \kbd{*shell*}}{M-x shell}
*************** minibuffer.  Type \kbd{F10} to activate
*** 554,562 ****
--- 557,568 ----
  \key{zero or more repeats}{*}
  \key{one or more repeats}{+}
  \key{zero or one repeat}{?}
+ \key{quote special characters}{\\}
  \key{quote regular expression special character {\it c\/}}{\\{\it c}}
  \key{alternative (``or'')}{\\|}
  \key{grouping}{\\( {\rm$\ldots$} \\)}
+ \key{shy grouping}{\\(:? {\rm$\ldots$} \\)}
+ \key{explicit numbered grouping}{\\(:NUM {\rm$\ldots$} \\)}
  \key{same text as {\it n\/}th group}{\\{\it n}}
  \key{at word break}{\\b}
  \key{not at word break}{\\B}
*************** minibuffer.  Type \kbd{F10} to activate
*** 565,576 ****
--- 571,585 ----
  \threecol{{\bf entity}}{{\bf match start}}{{\bf match end}}
  \threecol{line}{^}{\$}
  \threecol{word}{\\<}{\\>}
+ \threecol{symbol}{\\_<}{\\_>}
  \threecol{buffer}{\\`}{\\'}
+ %% FIXME: "`" and "'" isn't displayed correctly in the output PDF file
  
  \threecol{{\bf class of characters}}{{\bf match these}}{{\bf match others}}
  \threecol{explicit set}{[ {\rm$\ldots$} ]}{[^ {\rm$\ldots$} ]}
  \threecol{word-syntax character}{\\w}{\\W}
  \threecol{character with syntax {\it c}}{\\s{\it c}}{\\S{\it c}}
+ \threecol{character with category {\it c}}{\\c{\it c}}{\\C{\it c}}
  }
  
  \section{International Character Sets}
*************** Moving within a node:
*** 592,598 ****
  
  \key{scroll forward}{SPC}
  \key{scroll reverse}{DEL}
! \key{beginning of node}{. {\rm (dot)}}
  
  Moving between nodes:
  
--- 601,607 ----
  
  \key{scroll forward}{SPC}
  \key{scroll reverse}{DEL}
! \key{beginning of node}{b}
  
  Moving between nodes:
  
*************** Other:
*** 630,646 ****
  \key{{\bf start} defining a keyboard macro}{C-x (}
  \key{{\bf end} keyboard macro definition}{C-x )}
  \key{{\bf execute} last-defined keyboard macro}{C-x e}
! \key{append to last keyboard macro}{C-u C-x (}
  \metax{name last keyboard macro}{M-x name-last-kbd-macro}
  \metax{insert Lisp definition in buffer}{M-x insert-kbd-macro}
  
  \section{Commands Dealing with Emacs Lisp}
  
! \key{eval {\bf sexp} before point}{C-x C-e}
  \key{eval current {\bf defun}}{C-M-x}
  \metax{eval {\bf region}}{M-x eval-region}
  \key{read and eval minibuffer}{M-:}
! \metax{load from standard system directory}{M-x load-library}
  
  \section{Simple Customization}
  
--- 639,655 ----
  \key{{\bf start} defining a keyboard macro}{C-x (}
  \key{{\bf end} keyboard macro definition}{C-x )}
  \key{{\bf execute} last-defined keyboard macro}{C-x e}
! \key{record subsequent keyboard input, then append to last keyboard macro}{C-u C-x (}
  \metax{name last keyboard macro}{M-x name-last-kbd-macro}
  \metax{insert Lisp definition in buffer}{M-x insert-kbd-macro}
  
  \section{Commands Dealing with Emacs Lisp}
  
! \key{eval {\bf sexp} before point}{C-x C-e} % sexp?  form?  expression?  S-expression?
  \key{eval current {\bf defun}}{C-M-x}
  \metax{eval {\bf region}}{M-x eval-region}
  \key{read and eval minibuffer}{M-:}
! \metax{load a Lisp library from {\bf load-path}}{M-x load-library}
  
  \section{Simple Customization}
  
*************** An example:
*** 669,675 ****
  \beginexample%
  (defun this-line-to-top-of-window (line)
    "Reposition current line to top of window.
! With ARG, put point on line ARG."
    (interactive "P")
    (recenter (if (null line)
                  0
--- 678,684 ----
  \beginexample%
  (defun this-line-to-top-of-window (line)
    "Reposition current line to top of window.
! With prefix argument LINE, put point on LINE."
    (interactive "P")
    (recenter (if (null line)
                  0
*************** With ARG, put point on line ARG."
*** 677,683 ****
  \endexample
  
  The \kbd{interactive} spec says how to read arguments interactively.
! Type \kbd{C-h f interactive} for more details.
  
  \copyrightnotice
  
--- 686,692 ----
  \endexample
  
  The \kbd{interactive} spec says how to read arguments interactively.
! Type \kbd{C-h f interactive RET} for more details.
  
  \copyrightnotice
  

diff -cp trunk/etc/ChangeLog.orig trunk/etc/ChangeLog
*** trunk/etc/ChangeLog.orig	2013-03-23 18:14:12.000000000 +0800
--- trunk/etc/ChangeLog	2013-03-29 17:00:51.000000000 +0800
***************
*** 1,3 ****
--- 1,7 ----
+ 2013-03-29  Xue Fuqiao  <xfq.free@gmail.com>
+ 
+ 	* refcards/refcard.tex: Refine some entries.
+ 
  2013-03-21  Eric Ludlam  <zappo@gnu.org>
  
  	* srecode/ede-autoconf.srt: Change Copyright to FSF.

-- 
Xue Fuqiao
http://www.gnu.org/software/emacs/





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

* bug#14087: [PATCH] Some fixes for refcard.tex
  2013-03-29  9:02 bug#14087: [PATCH] Some fixes for refcard.tex Xue Fuqiao
@ 2013-05-08 17:18 ` Glenn Morris
  2013-05-09  4:59   ` Xue Fuqiao
  2013-05-25  2:18 ` Xue Fuqiao
  1 sibling, 1 reply; 6+ messages in thread
From: Glenn Morris @ 2013-05-08 17:18 UTC (permalink / raw)
  To: Xue Fuqiao; +Cc: 14087

Xue Fuqiao wrote:

> ! \metax{run {\bf query-replace-regexp} on all files listed in tags table}{M-x tags-query-replace}

Way too long. Looks terrible in generated pdf.

> + \key{execute a shell command asynchronously}{M-&}

Fails to LaTeX. Use '\&'.

> ! \key{record subsequent keyboard input, then append to last keyboard macro}{C-u C-x (}

Too long.

> ! \key{eval {\bf sexp} before point}{C-x C-e} % sexp?  form?  expression?  S-expression?

sexp seems fine for a quick reference card.





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

* bug#14087: [PATCH] Some fixes for refcard.tex
  2013-05-08 17:18 ` Glenn Morris
@ 2013-05-09  4:59   ` Xue Fuqiao
  2013-05-09  6:21     ` Glenn Morris
  0 siblings, 1 reply; 6+ messages in thread
From: Xue Fuqiao @ 2013-05-09  4:59 UTC (permalink / raw)
  To: Glenn Morris; +Cc: 14087

On Thu, May 9, 2013 at 1:18 AM, Glenn Morris <rgm@gnu.org> wrote:

(Sorry, but I cannot configure my email client to use `X-Debbugs-CC'.)

> Xue Fuqiao wrote:
>
>> ! \metax{run {\bf query-replace-regexp} on all files listed in tags table}{M-x tags-query-replace}
>
> Way too long. Looks terrible in generated pdf.

OK, I'll remove this change.

>> + \key{execute a shell command asynchronously}{M-&}
>
> Fails to LaTeX. Use '\&'.

I'll change it.

>> ! \key{record subsequent keyboard input, then append to last keyboard macro}{C-u C-x (}
>
> Too long.

I'll remove this change.

>> ! \key{eval {\bf sexp} before point}{C-x C-e} % sexp?  form?  expression?  S-expression?
>
> sexp seems fine for a quick reference card.

In (info "(elisp) Intro Eval"):

    A Lisp object that is intended for evaluation is called a "form" or
  "expression".
[...]
    It is sometimes also referred to as an "S-expression" or "sexp",
  but we generally do not use this terminology in this manual.

IMO we can use "form" here since it is consistent with the manual and
not too long.

--
Best regards, Xue Fuqiao.
http://www.gnu.org/software/emacs/





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

* bug#14087: [PATCH] Some fixes for refcard.tex
  2013-05-09  4:59   ` Xue Fuqiao
@ 2013-05-09  6:21     ` Glenn Morris
  2013-05-09  8:06       ` Xue Fuqiao
  0 siblings, 1 reply; 6+ messages in thread
From: Glenn Morris @ 2013-05-09  6:21 UTC (permalink / raw)
  To: Xue Fuqiao; +Cc: 14087

Xue Fuqiao wrote:

> (Sorry, but I cannot configure my email client to use `X-Debbugs-CC'.)

i) That option only affects new reports, not replies to existing
reports, so I don't see the relevance.

ii) I guess your mail client doesn't let you add X- headers.
Well, you can put it in the first line of the body instead.
No, it probably isn't in the documentation.

>>> ! \key{eval {\bf sexp} before point}{C-x C-e} % sexp?  form?  expression?  S-expression?
>>
>> sexp seems fine for a quick reference card.
>
> In (info "(elisp) Intro Eval"):
>
>     A Lisp object that is intended for evaluation is called a "form" or
>   "expression".
> [...]
>     It is sometimes also referred to as an "S-expression" or "sexp",
>   but we generally do not use this terminology in this manual.
>
> IMO we can use "form" here since it is consistent with the manual and
> not too long.

A reference card is not a manual.
The command is "eval-last-sexp"; "Evaluate sexp before point".
Using the word "sexp" will therefore be confusing to literally no-one,
and has added mnemonic value wrt the command-name.
There is no need to change it.





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

* bug#14087: [PATCH] Some fixes for refcard.tex
  2013-05-09  6:21     ` Glenn Morris
@ 2013-05-09  8:06       ` Xue Fuqiao
  0 siblings, 0 replies; 6+ messages in thread
From: Xue Fuqiao @ 2013-05-09  8:06 UTC (permalink / raw)
  To: Glenn Morris; +Cc: 14087

On Thu, May 9, 2013 at 2:21 PM, Glenn Morris <rgm@gnu.org> wrote:
> Xue Fuqiao wrote:
>
>> (Sorry, but I cannot configure my email client to use `X-Debbugs-CC'.)
>
> i) That option only affects new reports, not replies to existing
> reports, so I don't see the relevance.
>
> ii) I guess your mail client doesn't let you add X- headers.
> Well, you can put it in the first line of the body instead.
> No, it probably isn't in the documentation.

Ah, I see.  Thank you.

>>>> ! \key{eval {\bf sexp} before point}{C-x C-e} % sexp?  form?  expression?  S-expression?
>>>
>>> sexp seems fine for a quick reference card.
>>
>> In (info "(elisp) Intro Eval"):
>>
>>     A Lisp object that is intended for evaluation is called a "form" or
>>   "expression".
>> [...]
>>     It is sometimes also referred to as an "S-expression" or "sexp",
>>   but we generally do not use this terminology in this manual.
>>
>> IMO we can use "form" here since it is consistent with the manual and
>> not too long.
>
> A reference card is not a manual.
> The command is "eval-last-sexp"; "Evaluate sexp before point".
> Using the word "sexp" will therefore be confusing to literally no-one,
> and has added mnemonic value wrt the command-name.
> There is no need to change it.

OK, you convinced me.

--
Best regards, Xue Fuqiao.
http://www.gnu.org/software/emacs/





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

* bug#14087: [PATCH] Some fixes for refcard.tex
  2013-03-29  9:02 bug#14087: [PATCH] Some fixes for refcard.tex Xue Fuqiao
  2013-05-08 17:18 ` Glenn Morris
@ 2013-05-25  2:18 ` Xue Fuqiao
  1 sibling, 0 replies; 6+ messages in thread
From: Xue Fuqiao @ 2013-05-25  2:18 UTC (permalink / raw)
  To: 14087-done

Fixed and installed, thanks.





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

end of thread, other threads:[~2013-05-25  2:18 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-03-29  9:02 bug#14087: [PATCH] Some fixes for refcard.tex Xue Fuqiao
2013-05-08 17:18 ` Glenn Morris
2013-05-09  4:59   ` Xue Fuqiao
2013-05-09  6:21     ` Glenn Morris
2013-05-09  8:06       ` Xue Fuqiao
2013-05-25  2:18 ` Xue Fuqiao

Code repositories for project(s) associated with this external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.