Difference between revisions of "Keyboard macros"

From WikEmacs
Jump to navigation Jump to search
(Cheap Soccer Jerseys)
(Undo revision 4689 by 110.86.36.109 (talk))
Line 1: Line 1:
It truly is time for us to get off. We so are stuffed with cheese, wine, whisky, chocolate and icecream I can hardly walk. In no way yet again will I think of my home town as a culinary black hole.
+
{{Manual|emacs|Basic-Keyboard-Macro|Basic Keyboard Macro}}
Our tour manual, Bob, tells me Jason is one of the district's finest dairy technicians. Just before taking over GORGE, Melanie was a cheesemaker at our upcoming halt, Apostle Whey Cheese.
+
 
colate.
+
'''Keyboard macros''' can be used to automate or repeat tedious editing tasks in Emacs.
Our ultimate end on the twelve Apostles Gourmet Trail is Newtons Ridge Winery. It truly is breathtaking. We drive down a ridge and into a valley of vines, protected from the harsh winds that barrel in off the close by Southern Ocean. Once again this is a twoperson operation: David and Dot Newton, former dairy farmers who wanted to attempt a little something distinctive.
+
 
Obtaining thereTrains to Warrnambool leave Southern Cross Station in Melbourne three times a day. It takes 3 hrs and fares start at $31 one way, complete fare, offpeak; seevline.au
+
==Example usage==
We had been dairy farmers for many of our lives and we have now looked after the vines <b></b> similarly, David says. We're nonetheless expanding issues, but I much prefer the knockoff 4 o'clock chardonnay to a glass of milk.
+
Consider the standard <code>*scratch*</code> buffer:
Brigid Delaney travelled together with the assistance of Stop by twelve Apostles.
+
 
Dot and David opened their cellar door in 2003 and say other industries have sprung up because.
+
<pre>
Touring thereFor the Wonderful Ocean Road Gourmet Trail, tour operator Bob Scarborough requires groups of up to 22 visitors across the tra
+
;; This buffer is for notes you don't want to save, and for Lisp evaluation.
They have 250 cows  Jerseys and Friesians  and with the glass from the tasting space, it is feasible for guests to discover the cheese becoming produced. Julian emerges in cheesemaking garb. There's a romance to generating cheeses, he says. There are times with your life when you just need to make one thing.
+
;; If you want to create a file, visit that file with C-x C-f,
Dianne and Julian are farming while in the place for 31 years but have spent the previous 6 as cheesemakers. They may be famed for their Grotto cheese, which won silver during the 2007 Royal Melbourne Display. We use our very own cow milk. It really is all made here, Dianne says.
+
;; then enter the text in that file's own buffer.
The cheesetasting space overlooks the patchwork of Dianne and Julian Bensons' gorgeous, emeraldgreen dairy farm.
+
</pre>
 +
 
 +
Suppose you want to remove the first occurrence of the letter "a" on every row in that piece of text. You could write a [[regular expression]] to do the job, but let's assume you want to use a keyboard macro this time.
 +
 
 +
# Make sure [[point]] is at the start of the buffer.
 +
# Hit <code>C-x (</code> to start recording your macro. '''Note:''' If you hit <code>C-g</code> or if an error occurs, your keyboard macro recording will stop.
 +
# Hit <code>C-s</code> followed by <code>a</code> to find the first "a". Now, point is right after the first "a" in the text.
 +
# Hit backspace to delete that "a".
 +
 
 +
The first occurrence of "a" of the first line has been deleted. Let's move point to the beginning of the next line and then stop recording.
 +
 
 +
<ol start="5">
 +
<li>Hit <code>C-e C-f</code> to move point to the beginning of the next line.</li>
 +
<li>Hit <code>C-x )</code> to finish the recording of our macro.</li>
 +
</ol>
 +
 
 +
The macro you have just recorded performs the operation of removing the first occurrence of "a" it can find and then moving point to the next line.
 +
 
 +
<ol start="7">
 +
<li>Hit <code>C-x e</code> once to call that macro.</li>
 +
<li>Continue hitting <code>e</code> to call it several times. Hit any other key to get out of the macro repetition.</li>
 +
</ol>
 +
 
 +
==Saving macros==
 +
{{Manual|emacs|Save-Keyboard-Macro|Save Keyboard Macro}}
 +
 
 +
===Binding to a key===
 +
To bind a keyboard macro to a key use <code>C-x C-k b</code>.  To avoid problems caused by overriding existing bindings, the key sequences <code>C-x C-k 0</code> through <code>C-x C-k 9</code> and <code>C-x C-k A</code> through <code>C-x C-k Z</code> are reserved for your own keyboard macro bindings. You can, however, bind a keyboard macro to whatever you like.
 +
 
 +
==Variables==
 +
 
 +
Variables can be stored in lisp or in [[registers]]. Here's an example using lisp:
 +
 
 +
<pre>
 +
[M-: (setq x 1)]
 +
<F3>
 +
Line number [C-u M-: x]
 +
[M-: (setq x (+ x 1))]
 +
<F4>
 +
</pre>
 +
 
 +
Now execute the macro four times with the command <code>C-x e e e e</code> and you get:
 +
 
 +
line number 1<br />
 +
line number 2<br />
 +
line number 3<br />
 +
line number 4

Revision as of 15:00, 19 June 2013

Basic Keyboard Macro (`(info "(emacs) Basic Keyboard Macro")')

Keyboard macros can be used to automate or repeat tedious editing tasks in Emacs.

Example usage

Consider the standard *scratch* buffer:

;; This buffer is for notes you don't want to save, and for Lisp evaluation.
;; If you want to create a file, visit that file with C-x C-f,
;; then enter the text in that file's own buffer.

Suppose you want to remove the first occurrence of the letter "a" on every row in that piece of text. You could write a regular expression to do the job, but let's assume you want to use a keyboard macro this time.

  1. Make sure point is at the start of the buffer.
  2. Hit C-x ( to start recording your macro. Note: If you hit C-g or if an error occurs, your keyboard macro recording will stop.
  3. Hit C-s followed by a to find the first "a". Now, point is right after the first "a" in the text.
  4. Hit backspace to delete that "a".

The first occurrence of "a" of the first line has been deleted. Let's move point to the beginning of the next line and then stop recording.

  1. Hit C-e C-f to move point to the beginning of the next line.
  2. Hit C-x ) to finish the recording of our macro.

The macro you have just recorded performs the operation of removing the first occurrence of "a" it can find and then moving point to the next line.

  1. Hit C-x e once to call that macro.
  2. Continue hitting e to call it several times. Hit any other key to get out of the macro repetition.

Saving macros

Save Keyboard Macro (`(info "(emacs) Save Keyboard Macro")')

Binding to a key

To bind a keyboard macro to a key use C-x C-k b. To avoid problems caused by overriding existing bindings, the key sequences C-x C-k 0 through C-x C-k 9 and C-x C-k A through C-x C-k Z are reserved for your own keyboard macro bindings. You can, however, bind a keyboard macro to whatever you like.

Variables

Variables can be stored in lisp or in registers. Here's an example using lisp:

[M-: (setq x 1)]
<F3>
Line number [C-u M-: x]
[M-: (setq x (+ x 1))]
<F4>

Now execute the macro four times with the command C-x e e e e and you get:

line number 1
line number 2
line number 3
line number 4