declare smobs in alloc.c
[bpt/emacs.git] / etc / refcards / vipcard.tex
1 % Quick Reference Card for VIP
2
3 % Copyright (C) 1987, 2001-2014 Free Software Foundation, Inc.
4
5 % Author: Masahiko Sato <ms@sail.stanford.edu>, <masahiko@sato.riec.tohoku.junet>
6
7 % This file is part of GNU Emacs.
8
9 % GNU Emacs is free software: you can redistribute it and/or modify
10 % it under the terms of the GNU General Public License as published by
11 % the Free Software Foundation, either version 3 of the License, or
12 % (at your option) any later version.
13
14 % GNU Emacs is distributed in the hope that it will be useful,
15 % but WITHOUT ANY WARRANTY; without even the implied warranty of
16 % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 % GNU General Public License for more details.
18
19 % You should have received a copy of the GNU General Public License
20 % along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
21
22
23 % This file is intended to be processed by plain TeX (TeX82).
24 %
25 % The final reference card has six columns, three on each side.
26 % This file can be used to produce it in any of three ways:
27 % 1 column per page
28 % produces six separate pages, each of which needs to be reduced to 80%.
29 % This gives the best resolution.
30 % 2 columns per page
31 % produces three already-reduced pages.
32 % You will still need to cut and paste.
33 % 3 columns per page
34 % produces two pages which must be printed sideways to make a
35 % ready-to-use 8.5 x 11 inch reference card.
36 % For this you need a dvi device driver that can print sideways.
37 % Which mode to use is controlled by setting \columnsperpage.
38
39
40 %**start of header
41 \newcount\columnsperpage
42
43 % This file can be printed with 1, 2, or 3 columns per page.
44 % Specify how many you want here.
45 \columnsperpage=1
46
47 % PDF output layout. 0 for A4, 1 for letter (US), a `l' is added for
48 % a landscape layout.
49 \input pdflayout.sty
50 \pdflayout=(1)
51
52 \input emacsver.tex
53 \def\versionemacs{18} % version of Emacs this is for
54 \def\versionvip{3.5}
55
56 % Nothing else needs to be changed.
57
58 \def\shortcopyrightnotice{\vskip 1ex plus 2 fill
59 \centerline{\small \copyright\ \year\ Free Software Foundation, Inc.
60 Permissions on back.}}
61
62 \def\copyrightnotice{
63 %\vskip 1ex plus 2 fill\begingroup\small
64 \vskip 1ex \begingroup\small
65 \centerline{Copyright \copyright\ \year\ Free Software Foundation, Inc.}
66 \centerline{For VIP \versionvip\ with GNU Emacs version \versionemacs}
67 \centerline{Written by Masahiko Sato,}
68 \centerline{using refcard layout designed by Stephen Gildea.}
69
70 Permission is granted to make and distribute copies of
71 this card provided the copyright notice and this permission notice
72 are preserved on all copies.
73
74 For copies of the GNU Emacs manual, see:
75
76 {\tt http://www.gnu.org/software/emacs/\#Manuals}
77 \endgroup}
78
79 % make \bye not \outer so that the \def\bye in the \else clause below
80 % can be scanned without complaint.
81 \def\bye{\par\vfill\supereject\end}
82
83 \newdimen\intercolumnskip
84 \newbox\columna
85 \newbox\columnb
86
87 \def\ncolumns{\the\columnsperpage}
88
89 \message{[\ncolumns\space
90 column\if 1\ncolumns\else s\fi\space per page]}
91
92 \def\scaledmag#1{ scaled \magstep #1}
93
94 % This multi-way format was designed by Stephen Gildea
95 % October 1986.
96 % Slightly modified by Masahiko Sato, September 1987.
97 \if 1\ncolumns
98 \hsize 4in
99 \vsize 10in
100 %\voffset -.7in
101 \voffset -.57in
102 \font\titlefont=\fontname\tenbf \scaledmag3
103 \font\headingfont=\fontname\tenbf \scaledmag2
104 \font\miniheadingfont=\fontname\tenbf \scaledmag1 % masahiko
105 \font\smallfont=\fontname\sevenrm
106 \font\smallsy=\fontname\sevensy
107
108 \footline{\hss\folio}
109 \def\makefootline{\baselineskip10pt\hsize6.5in\line{\the\footline}}
110 \else
111 %\hsize 3.2in
112 %\vsize 7.95in
113 \hsize 3.41in % masahiko
114 \vsize 8in % masahiko
115 \hoffset -.75in
116 \voffset -.745in
117 \font\titlefont=cmbx10 \scaledmag2
118 \font\headingfont=cmbx10 \scaledmag1
119 \font\miniheadingfont=cmbx10 % masahiko
120 \font\smallfont=cmr6
121 \font\smallsy=cmsy6
122 \font\eightrm=cmr8
123 \font\eightbf=cmbx8
124 \font\eightit=cmti8
125 \font\eightsl=cmsl8
126 \font\eighttt=cmtt8
127 \font\eightsy=cmsy8
128 \textfont0=\eightrm
129 \textfont2=\eightsy
130 \def\rm{\eightrm}
131 \def\bf{\eightbf}
132 \def\it{\eightit}
133 \def\sl{\eightsl} % masahiko
134 \def\tt{\eighttt}
135 \normalbaselineskip=.8\normalbaselineskip
136 \normallineskip=.8\normallineskip
137 \normallineskiplimit=.8\normallineskiplimit
138 \normalbaselines\rm %make definitions take effect
139
140 \if 2\ncolumns
141 \let\maxcolumn=b
142 \footline{\hss\rm\folio\hss}
143 \def\makefootline{\vskip 2in \hsize=6.86in\line{\the\footline}}
144 \else \if 3\ncolumns
145 \let\maxcolumn=c
146 \nopagenumbers
147 \else
148 \errhelp{You must set \columnsperpage equal to 1, 2, or 3.}
149 \errmessage{Illegal number of columns per page}
150 \fi\fi
151
152 %\intercolumnskip=.46in
153 \intercolumnskip=.19in % masahiko .19x4 + 3.41x3 = 10.99
154 \def\abc{a}
155 \output={%
156 % This next line is useful when designing the layout.
157 %\immediate\write16{Column \folio\abc\space starts with \firstmark}
158 \if \maxcolumn\abc \multicolumnformat \global\def\abc{a}
159 \else\if a\abc
160 \global\setbox\columna\columnbox \global\def\abc{b}
161 %% in case we never use \columnb (two-column mode)
162 \global\setbox\columnb\hbox to -\intercolumnskip{}
163 \else
164 \global\setbox\columnb\columnbox \global\def\abc{c}\fi\fi}
165 \def\multicolumnformat{\shipout\vbox{\makeheadline
166 \hbox{\box\columna\hskip\intercolumnskip
167 \box\columnb\hskip\intercolumnskip\columnbox}
168 \makefootline}\advancepageno}
169 \def\columnbox{\leftline{\pagebody}}
170
171 \def\bye{\par\vfill\supereject
172 \if a\abc \else\null\vfill\eject\fi
173 \if a\abc \else\null\vfill\eject\fi
174 \end}
175 \fi
176
177 % we won't be using math mode much, so redefine some of the characters
178 % we might want to talk about
179 \catcode`\^=12
180 \catcode`\_=12
181
182 \chardef\\=`\\
183 \chardef\{=`\{
184 \chardef\}=`\}
185
186 \hyphenation{mini-buf-fer}
187
188 \parindent 0pt
189 \parskip 1ex plus .5ex minus .5ex
190
191 \def\small{\smallfont\textfont2=\smallsy\baselineskip=.8\baselineskip}
192
193 \outer\def\newcolumn{\vfill\eject}
194
195 \outer\def\title#1{{\titlefont\centerline{#1}}\vskip 1ex plus .5ex}
196
197 \outer\def\section#1{\par\filbreak
198 \vskip 3ex plus 2ex minus 2ex {\headingfont #1}\mark{#1}%
199 \vskip 2ex plus 1ex minus 1.5ex}
200
201 % masahiko
202 \outer\def\subsection#1{\par\filbreak
203 \vskip 2ex plus 2ex minus 2ex {\miniheadingfont #1}\mark{#1}%
204 \vskip 1ex plus 1ex minus 1.5ex}
205
206 \newdimen\keyindent
207
208 \def\beginindentedkeys{\keyindent=1em}
209 \def\endindentedkeys{\keyindent=0em}
210 \endindentedkeys
211
212 \def\paralign{\vskip\parskip\halign}
213
214 \def\<#1>{$\langle${\rm #1}$\rangle$}
215
216 \def\kbd#1{{\tt#1}\null} %\null so not an abbrev even if period follows
217
218 \def\beginexample{\par\leavevmode\begingroup
219 \obeylines\obeyspaces\parskip0pt\tt}
220 {\obeyspaces\global\let =\ }
221 \def\endexample{\endgroup}
222
223 \def\key#1#2{\leavevmode\hbox to \hsize{\vtop
224 {\hsize=.75\hsize\rightskip=1em
225 \hskip\keyindent\relax#1}\kbd{#2}\hfil}}
226
227 \newbox\metaxbox
228 \setbox\metaxbox\hbox{\kbd{M-x }}
229 \newdimen\metaxwidth
230 \metaxwidth=\wd\metaxbox
231
232 \def\metax#1#2{\leavevmode\hbox to \hsize{\hbox to .75\hsize
233 {\hskip\keyindent\relax#1\hfil}%
234 \hskip -\metaxwidth minus 1fil
235 \kbd{#2}\hfil}}
236
237 \def\fivecol#1#2#3#4#5{\hskip\keyindent\relax#1\hfil&\kbd{#2}\quad
238 &\kbd{#3}\quad&\kbd{#4}\quad&\kbd{#5}\cr}
239
240 \def\fourcol#1#2#3#4{\hskip\keyindent\relax#1\hfil&\kbd{#2}\quad
241 &\kbd{#3}\quad&\kbd{#4}\quad\cr}
242
243 \def\threecol#1#2#3{\hskip\keyindent\relax#1\hfil&\kbd{#2}\quad
244 &\kbd{#3}\quad\cr}
245
246 \def\twocol#1#2{\hskip\keyindent\relax\kbd{#1}\hfil&\kbd{#2}\quad\cr}
247
248 \def\twocolkey#1#2#3#4{\hskip\keyindent\relax#1\hfil&\kbd{#2}\quad&\relax#3\hfil&\kbd{#4}\quad\cr}
249
250 %**end of header
251 \f
252 \beginindentedkeys
253
254 \title{VIP Quick Reference Card}
255
256 \centerline{(Based on VIP \versionvip\ in GNU Emacs \versionemacs)}
257
258 %\copyrightnotice
259
260 \section{Loading VIP}
261
262 Just type \kbd{M-x vip-mode} followed by \kbd{RET}
263
264 \section{VIP Modes}
265
266 VIP has three modes: {\it emacs mode}, {\it vi mode} and {\it insert mode}.
267 Mode line tells you which mode you are in.
268 In emacs mode you can do all the normal GNU Emacs editing.
269 This card explains only vi mode and insert mode.
270 {\bf GNU Emacs Reference Card} explains emacs mode.
271 You can switch modes as follows.
272
273 \key{from emacs mode to vi mode}{C-z}
274 \key{from vi mode to emacs mode}{C-z}
275 \metax{from vi mode to insert mode}{i, I, a, A, o, O {\rm or} C-o}
276 \key{from insert mode to vi mode}{ESC}
277
278 If you wish to be in vi mode just after you startup Emacs,
279 include the line:
280
281 \hskip 5ex
282 \kbd{(add-hook 'emacs-startup-hook 'vip-mode)}
283
284 in your \kbd{.emacs} file.
285 Or, you can put the following alias in your \kbd{.cshrc} file.
286
287 \hskip 5ex
288 \kbd{alias vip 'emacs \\!* -f vip-mode'}
289
290
291 \section{Insert Mode}
292 Insert mode is like emacs mode except for the following.
293
294 \key{go back to vi mode}{ESC}
295 \key{delete previous character}{C-h}
296 \key{delete previous word}{C-w}
297 \key{emulate \kbd{ESC} key in emacs mode}{C-z}
298
299 The rest of this card explains commands in {\bf vi mode}.
300
301 \section{Getting Information on VIP}
302
303 Execute info command by typing \kbd{M-x info} and select menu item
304 \kbd{vip}. Also:
305
306 \key{describe function attached to the key {\it x}}{C-h k {\it x}}
307
308 \section{Leaving Emacs}
309
310 \key{suspend Emacs}{X Z {\rm or} :st}
311 \metax{exit Emacs permanently}{Z Z {\rm or} X C {\rm or} :q}
312
313 \section{Error Recovery}
314
315 \key{abort partially typed or executing command}{C-g}
316 \key{redraw messed up screen}{C-l}
317 \metax{{\bf recover} a file lost by a system crash}{M-x recover-file}
318 \metax{restore a buffer to its original contents}{M-x revert-buffer}
319
320 \shortcopyrightnotice
321
322 \section{Counts}
323
324 Most commands in vi mode accept a {\it count} which can be supplied as a
325 prefix to the commands. In most cases, if a count is given, the
326 command is executed that many times. E.g., \kbd{5 d d} deletes 5
327 lines.
328
329 %\shortcopyrightnotice
330 \section{Registers}
331
332 There are 26 registers (\kbd{a} to \kbd{z}) that can store texts
333 and marks.
334 You can append a text at the end of a register (say \kbd{x}) by
335 specifying the register name in capital letter (say \kbd{X}).
336 There are also 9 read only registers (\kbd{1} to \kbd{9}) that store
337 up to 9 previous changes.
338 We will use {\it x\/} to denote a register.
339 \section{Entering Insert Mode}
340
341 \key{{\bf insert} at point}{i}
342 \key{{\bf append} after cursor}{a}
343 \key{{\bf insert} before first non-white}{I}
344 \key{{\bf append} at end of line}{A}
345 \key{{\bf open} line below}{o}
346 \key{{\bf open} line above}{O}
347 \key{{\bf open} line at point}{C-o}
348
349 \section{Buffers and Windows}
350
351 \key{move cursor to {\bf next} window}{C-n}
352 \key{delete current window}{X 0}
353 \key{delete other windows}{X 1}
354 \key{split current window into two windows}{X 2}
355 \key{show current buffer in two windows}{X 3}
356 \key{{\bf switch} to a buffer in the current window}{s {\sl buffer}}
357 \key{{\bf switch} to a buffer in another window}{S {\sl buffer}}
358 \key{{\bf kill} a buffer}{K}
359 \key{list existing {\bf buffers}}{X B}
360
361 \section{Files}
362
363 \metax{{\bf visit} file in the current window}{v {\sl file} {\rm or} :e {\sl file}}
364 \key{{\bf visit} file in another window}{V {\sl file}}
365 \key{{\bf save} buffer to the associated file}{X S}
366 \key{{\bf write} buffer to a specified file}{X W}
367 \key{{\bf insert} a specified file at point}{X I}
368 \key{{\bf get} information on the current {\bf file}}{g {\rm or} :f}
369 \key{run the {\bf directory} editor}{X d}
370
371 \section{Viewing the Buffer}
372
373 \key{scroll to next screen}{SPC {\rm or} C-f}
374 \key{scroll to previous screen}{RET {\rm or} C-b}
375 \key{scroll {\bf down} half screen}{C-d}
376 \key{scroll {\bf up} half screen}{C-u}
377 \key{scroll down one line}{C-e}
378 \key{scroll up one line}{C-y}
379
380 \key{put current line on the {\bf home} line}{z H {\rm or} z RET}
381 \key{put current line on the {\bf middle} line}{z M {\rm or} z .}
382 \key{put current line on the {\bf last} line}{z L {\rm or} z -}
383
384 \section{Marking and Returning}
385
386 \key{{\bf mark} point in register {\it x}}{m {\it x}}
387 \key{set mark at buffer beginning}{m <}
388 \key{set mark at buffer end}{m >}
389 \key{set mark at point}{m .}
390 \key{jump to mark}{m ,}
391 \key{exchange point and mark}{` `}
392 \key{... and skip to first non-white on line}{' '}
393 \key{go to mark {\it x}}{` {\it x}}
394 \key{... and skip to first non-white on line}{' {\it x}}
395
396 \section{Macros}
397
398 \key{start remembering keyboard macro}{X (}
399 \key{finish remembering keyboard macro}{X )}
400 \key{call last keyboard macro}{*}
401 \key{execute macro stored in register {\it x}}{@ {\it x}}
402
403 \section{Motion Commands}
404
405 \key{go backward one character}{h}
406 \key{go forward one character}{l}
407 \key{next line keeping the column}{j}
408 \key{previous line keeping the column}{k}
409 \key{next line at first non-white}{+}
410 \key{previous line at first non-white}{-}
411
412 \key{beginning of line}{0}
413 \key{first non-white on line}{^}
414 \key{end of line}{\$}
415 \key{go to {\it n}-th column on line}{{\it n} |}
416
417 \key{go to {\it n}-th line}{{\it n} G}
418 \key{go to last line}{G}
419 \key{find matching parenthesis for \kbd{()}, \kbd{\{\}} and \kbd{[]}}{\%}
420
421 \key{go to {\bf home} window line}{H}
422 \key{go to {\bf middle} window line}{M}
423 \key{go to {\bf last} window line}{L}
424
425 \subsection{Words, Sentences, Paragraphs}
426
427 \key{forward {\bf word}}{w {\rm or} W}
428 \key{{\bf backward} word}{b {\rm or} B}
429 \key{{\bf end} of word}{e {\rm or} E}
430
431 In the case of capital letter commands, a word is delimited by a
432 non-white character.
433
434 \key{forward sentence}{)}
435 \key{backward sentence}{(}
436
437 \key{forward paragraph}{\}}
438 \key{backward paragraph}{\{}
439
440 \subsection{Find Characters on the Line}
441
442 \key{{\bf find} {\it c} forward on line}{f {\it c}}
443 \key{{\bf find} {\it c} backward on line}{F {\it c}}
444 \key{up {\bf to} {\it c} forward on line}{t {\it c}}
445 \key{up {\bf to} {\it c} backward on line}{T {\it c}}
446 \key{repeat previous \kbd{f}, \kbd{F}, \kbd{t} or \kbd{T}}{;}
447 \key{... in the opposite direction}{,}
448
449 \newcolumn
450 \title{VIP Quick Reference Card}
451
452 \section{Searching and Replacing}
453
454 \key{search forward for {\sl pat}}{/ {\sl pat}}
455 \key{search backward for {\sl pat}}{?\ {\sl pat}}
456 \key{repeat previous search}{n}
457 \key{... in the opposite direction}{N}
458
459 \key{incremental {\bf search}}{C-s}
460 \key{{\bf reverse} incremental search}{C-r}
461
462 \key{{\bf replace}}{R}
463 \key{{\bf query} replace}{Q}
464 \key{{\bf replace} a character by another character {\it c}}{r {\it c}}
465
466 \section{Modifying Commands}
467
468 The delete (yank, change) commands explained below accept a motion command as
469 their argument and delete (yank, change) the region determined by the motion
470 command. Motion commands are classified into {\it point commands} and
471 {\it line commands}. In the case of line commands, whole lines will
472 be affected by the command. Motion commands will be represented by
473 {\it m} below.
474
475 The point commands are as follows:
476
477 \hskip 5ex
478 \kbd{h l 0 ^ \$ w W b B e E ( ) / ?\ ` f F t T \% ; ,}
479
480 The line commands are as follows:
481
482 \hskip 5ex
483 \kbd{j k + - H M L \{ \} G '}
484
485 \subsection{Delete/Yank/Change Commands}
486
487 \paralign to \hsize{#\tabskip=10pt plus 1 fil&#\tabskip=0pt&#\tabskip=0pt&#\cr
488 \fourcol{}{{\bf delete}}{{\bf yank}}{{\bf change}}
489 \fourcol{region determined by {\it m}}{d {\it m}}{y {\it m}}{c {\it m}}
490 \fourcol{... into register {\it x}}{" {\it x\/} d {\it m}}{" {\it x\/} y {\it m}}{" {\it x\/} c {\it m}}
491 \fourcol{a line}{d d}{Y {\rm or} y y}{c c}
492 \fourcol{current {\bf region}}{d r}{y r}{c r}
493 \fourcol{expanded {\bf region}}{d R}{y R}{c R}
494 \fourcol{to end of line}{D}{y \$}{c \$}
495 \fourcol{a character after point}{x}{y l}{c l}
496 \fourcol{a character before point}{DEL}{y h}{c h}
497 }
498
499 \subsection{Put Back Commands}
500
501 Deleted/yanked/changed text can be put back by the following commands.
502
503 \key{{\bf Put} back at point/above line}{P}
504 \key{... from register {\it x}}{" {\it x\/} P}
505 \key{{\bf put} back after point/below line}{p}
506 \key{... from register {\it x}}{" {\it x\/} p}
507
508 \subsection{Repeating and Undoing Modifications}
509
510 \key{{\bf undo} last change}{u {\rm or} :und}
511 \key{repeat last change}{.\ {\rm (dot)}}
512
513 Undo is undoable by \kbd{u} and repeatable by \kbd{.}.
514 For example, \kbd{u...} will undo 4 previous changes.
515 A \kbd{.} after \kbd{5dd} is equivalent to \kbd{5dd},
516 while \kbd{3.} after \kbd{5dd} is equivalent to \kbd{3dd}.
517
518 \section{Miscellaneous Commands}
519
520 \endindentedkeys
521
522 \paralign to \hsize{#\tabskip=5pt plus 1 fil&#\tabskip=0pt&#\tabskip=0pt&#\tabskip=0pt&#\cr
523 \fivecol{}{{\bf shift left}}{{\bf shift right}}{{\bf filter shell command}}{{\bf indent}}
524 \fivecol{region}{< {\it m}}{> {\it m}}{!\ {\it m\/} {\sl shell-com}}{= {\it m}}
525 \fivecol{line}{< <}{> >}{!\ !\ {\sl shell-com}}{= =}
526 }
527
528 \key{emulate \kbd{ESC}/\kbd{C-h} in emacs mode}{ESC{\rm /}C-h}
529 \key{emulate \kbd{C-c}/\kbd{C-x} in emacs mode}{C{\rm /}X}
530
531 \key{{\bf join} lines}{J}
532
533 \key{lowercase region}{\# c {\it m}}
534 \key{uppercase region}{\# C {\it m}}
535 \key{execute last keyboard macro on each line in the region}{\# g {\it m}}
536
537 \key{insert specified string for each line in the region}{\# q {\it m}}
538 \key{check spelling of the words in the region}{\# s {\it m}}
539
540 \section{Differences from Vi}
541
542 \beginindentedkeys
543
544 In VIP some keys behave rather differently from Vi.
545 The table below lists such keys, and you can get the effect of typing
546 these keys by typing the corresponding keys in the VIP column.
547
548 \paralign to \hsize{#\tabskip=10pt plus 1 fil&#\tabskip=0pt&#\cr
549 \threecol{}{{\bf Vi}}{{\bf VIP}}
550 \threecol{forward character}{SPC}{l}
551 \threecol{backward character}{C-h}{h}
552 \threecol{next line at first non-white}{RET}{+}
553 \threecol{delete previous character}{X}{DEL}
554 \threecol{get information on file}{C-g}{g}
555 \threecol{substitute characters}{s}{x i}
556 \threecol{substitute line}{S}{c c}
557 \threecol{change to end of line}{C {\rm or} R}{c \$}
558 }
559
560 (Strictly speaking, \kbd{C} and \kbd{R} behave slightly differently in Vi.)
561
562 \section{Customization}
563
564 By default, search is case sensitive.
565 You can change this by including the following line in your \kbd{.vip} file.
566
567 \hskip 5ex
568 \kbd{(setq vip-case-fold-search t)}
569
570 \beginindentedkeys
571
572 \paralign to \hsize{#\tabskip=10pt plus 1 fil&#\tabskip=0pt&#\cr
573 \twocol{{\bf variable}}{{\bf default value}}
574 \twocol{vip-search-wrap-around}{t}
575 \twocol{vip-case-fold-search}{nil}
576 \twocol{vip-re-search}{nil}
577 \twocol{vip-re-replace}{nil}
578 \twocol{vip-re-query-replace}{nil}
579 \twocol{vip-open-with-indent}{nil}
580 \twocol{vip-help-in-insert-mode}{nil}
581 \twocol{vip-shift-width}{8}
582 \twocol{vip-tags-file-name}{"TAGS"}
583 }
584
585 %\subsection{Customizing Key Bindings}
586
587 Include (some of) following lines in your \kbd{.vip} file
588 to restore Vi key bindings.
589
590 \beginexample
591 (define-key vip-mode-map "\\C-g" 'vip-info-on-file)
592 (define-key vip-mode-map "\\C-h" 'vip-backward-char)
593 (define-key vip-mode-map "\\C-m" 'vip-next-line-at-bol)
594 (define-key vip-mode-map " " 'vip-forward-char)
595 (define-key vip-mode-map "g" 'vip-keyboard-quit)
596 (define-key vip-mode-map "s" 'vip-substitute)
597 (define-key vip-mode-map "C" 'vip-change-to-eol)
598 (define-key vip-mode-map "R" 'vip-change-to-eol)
599 (define-key vip-mode-map "S" 'vip-substitute-line)
600 (define-key vip-mode-map "X" 'vip-delete-backward-char)
601 \endexample
602
603 \newcolumn
604
605 \title{Ex Commands in VIP}
606
607 In vi mode, an Ex command is entered by typing:
608
609 \hskip 5ex
610 \kbd{:\ {\sl ex-command} RET}
611
612 \section{Ex Addresses}
613
614 \paralign to \hsize{#\tabskip=5pt plus 1 fil&#\tabskip=2pt&#\tabskip=5pt plus 1 fil&#\cr
615 \twocolkey{current line}{.}{next line with {\sl pat}}{/ {\sl pat} /}
616 \twocolkey{line {\it n}}{{\it n}}{previous line with {\sl pat}}{?\ {\sl pat} ?}
617 \twocolkey{last line}{\$}{{\it n\/} line before {\it a}}{{\it a} - {\it n}}
618 \twocolkey{next line}{+}{{\it a\/} through {\it b}}{{\it a\/} , {\it b}}
619 \twocolkey{previous line}{-}{line marked with {\it x}}{' {\it x}}
620 \twocolkey{entire buffer}{\%}{previous context}{' '}
621 }
622
623 Addresses can be specified in front of a command.
624 For example,
625
626 \hskip 5ex
627 \kbd{:.,.+10m\$}
628
629 moves 11 lines below current line to the end of buffer.
630
631 \section{Ex Commands}
632
633 \endindentedkeys
634
635 \key{mark lines matching {\sl pat} and execute {\sl cmds} on these lines}{:g /{\sl pat}/ {\sl cmds}}
636
637 \key{mark lines {\it not\/} matching {\sl pat} and execute {\sl cmds} on these lines}{:v /{\sl pat}/ {\sl cmds}}
638
639
640 \key{{\bf move} specified lines after {\sl addr}}{:m {\sl addr}}
641 \key{{\bf copy} specified lines after {\sl addr}}{:co\rm\ (or \kbd{:t})\ \sl addr}
642 \key{{\bf delete} specified lines [into register {\it x\/}]}{:d {\rm [{\it x\/}]}}
643 \key{{\bf yank} specified lines [into register {\it x\/}]}{:y {\rm [{\it x\/}]}}
644 \key{{\bf put} back text [from register {\it x\/}]}{:pu {\rm [{\it x\/}]}}
645
646 \key{{\bf substitute} {\sl repl} for first string on line matching {\sl pat}}{:s /{\sl pat}/{\sl repl}/}
647
648 \key{repeat last substitution}{:\&}
649 \key{repeat previous substitute with previous search pattern as {\sl pat}}{:\~{}}
650
651 \key{{\bf read} in a file}{:r {\sl file}}
652 \key{{\bf read} in the output of a shell command}{:r!\ {\sl command}}
653 \key{write out specified lines into {\sl file}}{:w {\sl file}}
654 \key{write out specified lines at the end of {\sl file}}{:w>> {\sl file}}
655 \key{write out and then quit}{:wq {\sl file}}
656
657 \key{define a macro {\it x} that expands to {\sl cmd}}{:map {\it x} {\sl cmd}}
658 \key{remove macro expansion associated with {\it x}}{:unma {\it x}}
659
660 \key{print line number}{:=}
661 \key{print {\bf version} number of VIP}{:ve}
662
663 \key{shift specified lines to the right}{:>}
664 \key{shift specified lines to the left}{:<}
665
666 \key{{\bf join} lines}{:j}
667 \key{mark specified line to register {\it x}}{:k {\it x}}
668 \key{{\bf set} a variable's value}{:se}
669 \key{run a sub{\bf shell} in a window}{:sh}
670 \key{execute shell command {\sl command}}{:!\ {\sl command}}
671 \key{find first definition of {\bf tag} {\sl tag}}{:ta {\sl tag}}
672
673
674 \copyrightnotice
675
676 \bye
677 \f
678 % Local variables:
679 % compile-command: "pdftex vipcard"
680 % End:
681