annotate doc/misc/vip.texi @ 85265:4fe6aac1d449

(ebrowse-tree-mode): Disable undo in the BROWSE buffer.
author Eli Zaretskii <eliz@gnu.org>
date Sat, 13 Oct 2007 12:55:00 +0000
parents 3d431f1997d8
children 5d58981e6690
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
84322
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1 \input texinfo
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2
84329
3d431f1997d8 (setfilename): Go up one more level to ../../info.
Glenn Morris <rgm@gnu.org>
parents: 84322
diff changeset
3 @setfilename ../../info/vip
84322
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4 @settitle VIP
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6 @copying
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7 Copyright @copyright{} 1987, 2001, 2002, 2003, 2004,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8 2005, 2006, 2007 Free Software Foundation, Inc.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
10 @quotation
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
11 Permission is granted to copy, distribute and/or modify this document
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
12 under the terms of the GNU Free Documentation License, Version 1.2 or
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
13 any later version published by the Free Software Foundation; with no
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
14 Invariant Sections, with the Front-Cover texts being ``A GNU
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
15 Manual'', and with the Back-Cover Texts as in (a) below. A copy of the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
16 license is included in the section entitled ``GNU Free Documentation
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
17 License'' in the Emacs manual.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
18
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
19 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
20 this GNU Manual, like GNU software. Copies published by the Free
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
21 Software Foundation raise funds for GNU development.''
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
22
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
23 This document is part of a collection distributed under the GNU Free
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
24 Documentation License. If you want to distribute this document
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
25 separately from the collection, you can do so by adding a copy of the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
26 license to the document, as described in section 6 of the license.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
27 @end quotation
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
28 @end copying
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
29
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
30 @titlepage
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
31 @sp 10
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
32 @center @titlefont{VIP}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
33 @sp 1
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
34 @center A Vi Package for GNU Emacs
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
35 @center (Version 3.5, September 15, 1987)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
36 @sp 2
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
37 @center Masahiko Sato
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
38 @page
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
39 @vskip 0pt plus1filll
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
40 @insertcopying
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
41 @end titlepage
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
42
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
43 @dircategory Emacs
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
44 @direntry
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
45 * VIP: (vip). An older VI-emulation for Emacs.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
46 @end direntry
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
47
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
48 @finalout
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
49
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
50 @ifnottex
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
51 @node Top, Survey,, (DIR)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
52 @top VIP
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
53
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
54 VIP is a Vi emulating package written in Emacs Lisp. VIP implements most
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
55 Vi commands including Ex commands. It is therefore hoped that this package
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
56 will enable you to do Vi style editing under the powerful GNU Emacs
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
57 environment. This info file describes the usage of VIP assuming that you
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
58 are fairly accustomed to Vi but not so much with Emacs. Also we will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
59 concentrate mainly on differences from Vi, especially features unique to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
60 VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
61
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
62 It is recommended that you read nodes on survey and on customization before
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63 you start using VIP. Other nodes may be visited as needed.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
64
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
65 Comments and bug reports are welcome. Please send messages to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
66 @code{ms@@Sail.Stanford.Edu} if you are outside of Japan and to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
67 @code{masahiko@@sato.riec.tohoku.junet} if you are in Japan.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
68
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
69 @end ifnottex
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
70
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
71 @menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
72 * Survey:: A survey of VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
73 * Vi Commands:: Details of Vi commands.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
74 * Ex Commands:: Details of Ex commands.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
75 * Customization:: How to customize VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
76 * GNU Free Documentation License:: The license for this documentation.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
77
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
78 @end menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
79 @iftex
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
80 @unnumbered Introduction
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
81
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
82 VIP is a Vi emulating package written in Emacs Lisp. VIP implements most
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
83 Vi commands including Ex commands. It is therefore hoped that this package
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
84 will enable you to do Vi style editing under the powerful GNU Emacs
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
85 environment. This manual describes the usage of VIP assuming that you are
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
86 fairly accustomed to Vi but not so much with Emacs. Also we will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
87 concentrate mainly on differences from Vi, especially features unique to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
88 VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
89
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
90 It is recommended that you read chapters on survey and on customization
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
91 before you start using VIP. Other chapters may be used as future
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
92 references.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
93
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
94 Comments and bug reports are welcome. Please send messages to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
95 @code{ms@@Sail.Stanford.Edu} if you are outside of Japan and to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
96 @code{masahiko@@unsun.riec.tohoku.junet} if you are in Japan.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
97 @end iftex
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
98
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
99 @node Survey, Basic Concepts, Top, Top
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
100 @chapter A Survey of VIP
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
101
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
102 In this chapter we describe basics of VIP with emphasis on the features not
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
103 found in Vi and on how to use VIP under GNU Emacs.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
104
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
105 @menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
106 * Basic Concepts:: Basic concepts in Emacs.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
107 * Loading VIP:: How to load VIP automatically.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
108 * Modes in VIP:: VIP has three modes, which are orthogonal to modes
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
109 in Emacs.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
110 * Differences from Vi:: Differences of VIP from Vi is explained.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
111 @end menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
112
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
113 @node Basic Concepts, Loading VIP, Survey, Survey
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
114 @section Basic Concepts
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
115
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
116 We begin by explaining some basic concepts of Emacs. These concepts are
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
117 explained in more detail in the GNU Emacs Manual.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
118
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
119 @cindex buffer
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
120 @cindex point
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
121 @cindex mark
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
122 @cindex text
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
123 @cindex looking at
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
124 @cindex end (of buffer)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
125 @cindex region
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
126
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
127 Conceptually, a @dfn{buffer} is just a string of @acronym{ASCII} characters and two
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
128 special characters @key{PNT} (@dfn{point}) and @key{MRK} (@dfn{mark}) such
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
129 that the character @key{PNT} occurs exactly once and @key{MRK} occurs at
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
130 most once. The @dfn{text} of a buffer is obtained by deleting the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
131 occurrences of @key{PNT} and @key{MRK}. If, in a buffer, there is a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
132 character following @key{PNT} then we say that point is @dfn{looking at}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
133 the character; otherwise we say that point is @dfn{at the end of buffer}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
134 @key{PNT} and @key{MRK} are used
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
135 to indicate positions in a buffer and they are not part of the text of the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
136 buffer. If a buffer contains a @key{MRK} then the text between @key{MRK}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
137 and @key{PNT} is called the @dfn{region} of the buffer.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
138
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
139 @cindex window
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
140
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
141 Emacs provides (multiple) @dfn{windows} on the screen, and you can see the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
142 content of a buffer through the window associated with the buffer. The
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
143 cursor of the screen is always positioned on the character after @key{PNT}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
144 @refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
145
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
146 @cindex mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
147 @cindex keymap
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
148 @cindex local keymap
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
149 @cindex global keymap
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
150
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
151 A @dfn{keymap} is a table that records the bindings between characters and
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
152 command functions. There is the @dfn{global keymap} common to all the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
153 buffers. Each buffer has its @dfn{local keymap} that determines the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
154 @dfn{mode} of the buffer. Local keymap overrides global keymap, so that if
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
155 a function is bound to some key in the local keymap then that function will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
156 be executed when you type the key. If no function is bound to a key in the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
157 local map, however, the function bound to the key in the global map becomes
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
158 in effect.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
159
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
160 @node Loading VIP, Modes in VIP, Basic Concepts, Survey
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
161 @section Loading VIP
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
162
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
163 The recommended way to load VIP automatically is to include the line:
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
164 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
165 (load "vip")
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
166 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
167 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
168 in your @file{.emacs} file. The @file{.emacs} file is placed in your home
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
169 directory and it will be executed every time you invoke Emacs. If you wish
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
170 to be in vi mode whenever Emacs starts up, you can include the following
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
171 line in your @file{.emacs} file instead of the above line:
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
172 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
173 (setq term-setup-hook 'vip-mode)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
174 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
175 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
176 (@xref{Vi Mode}, for the explanation of vi mode.)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
177
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
178 Even if your @file{.emacs} file does not contain any of the above lines,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
179 you can load VIP and enter vi mode by typing the following from within
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
180 Emacs.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
181 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
182 M-x vip-mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
183 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
184 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
185
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
186 @node Modes in VIP, Emacs Mode, Loading VIP, Survey
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
187 @section Modes in VIP
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
188
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
189 @kindex 032 @kbd{C-z} (@code{vip-change-mode-to-vi})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
190 @kindex 0301 @kbd{C-x C-z} (@code{suspend-emacs})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
191
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
192 Loading VIP has the effect of globally binding @kbd{C-z} (@kbd{Control-z})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
193 to the function @code{vip-change-mode-to-vi}. The default binding of @kbd{C-z}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
194 in GNU Emacs is @code{suspend-emacs}, but, you can also call
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
195 @code{suspend-emacs} by typing @kbd{C-x C-z}. Other than this, all the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
196 key bindings of Emacs remain the same after loading VIP.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
197
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
198 @cindex vi mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
199
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
200 Now, if you hit @kbd{C-z}, the function @code{vip-change-mode-to-vi} will be
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
201 called and you will be in @dfn{vi mode}. (Some major modes may locally bind
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
202 @kbd{C-z} to some special functions. In such cases, you can call
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
203 @code{vip-change-mode-to-vi} by @code{execute-extended-command} which is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
204 invoked by @kbd{M-x}. Here @kbd{M-x} means @kbd{Meta-x}, and if your
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
205 terminal does not have a @key{META} key you can enter it by typing
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
206 @kbd{@key{ESC} x}. The same effect can also be achieve by typing
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
207 @kbd{M-x vip-mode}.)@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
208
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
209 @cindex mode line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
210
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
211 You can observe the change of mode by looking at the @dfn{mode line}. For
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
212 instance, if the mode line is:@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
213 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
214 -----Emacs: *scratch* (Lisp Interaction)----All------------
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
215 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
216 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
217 then it will change to:
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
218 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
219 -----Vi: *scratch* (Lisp Interaction)----All------------
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
220 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
221 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
222 Thus the word @samp{Emacs} in the mode line will change to @samp{Vi}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
223
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
224 @cindex insert mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
225 @cindex emacs mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
226
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
227 You can go back to the original @dfn{emacs mode} by typing @kbd{C-z} in
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
228 vi mode. Thus @kbd{C-z} toggles between these two modes.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
229
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
230 Note that modes in VIP exist orthogonally to modes in Emacs. This means
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
231 that you can be in vi mode and at the same time, say, shell mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
232
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
233 Vi mode corresponds to Vi's command mode. From vi mode you can enter
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
234 @dfn{insert mode} (which corresponds to Vi's insert mode) by usual Vi command
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
235 keys like @kbd{i}, @kbd{a}, @kbd{o} @dots{} etc.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
236
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
237 In insert mode, the mode line will look like this:
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
238 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
239 -----Insert *scratch* (Lisp Interaction)----All------------
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
240 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
241 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
242 You can exit from insert mode by hitting @key{ESC} key as you do in Vi.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
243
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
244 That VIP has three modes may seem very complicated, but in fact it is not
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
245 so. VIP is implemented so that you can do most editing remaining only
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
246 in the two modes for Vi (that is vi mode and insert mode).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
247
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
248 @ifinfo
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
249 The figure below shows the transition of three modes in VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
250 @display
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
251
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
252
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
253 === C-z ==> == i,o ... ==>
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
254 emacs mode vi mode insert mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
255 <== X-z === <=== ESC ====
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
256 @end display
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
257 @end ifinfo
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
258
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
259 @menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
260 * Emacs Mode:: This is the mode you should know better.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
261 * Vi Mode:: Vi commands are executed in this mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
262 * Insert Mode:: You can enter text, and also can do editing if you
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
263 know enough Emacs commands.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
264 @end menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
265
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
266 @node Emacs Mode, Vi Mode, Modes in VIP, Modes in VIP
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
267 @subsection Emacs Mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
268
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
269 @kindex 032 @kbd{C-z} (@code{vip-change-mode-to-vi})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
270
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
271 You will be in this mode just after you loaded VIP. You can do all
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
272 normal Emacs editing in this mode. Note that the key @kbd{C-z} is globally
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
273 bound to @code{vip-change-mode-to-vi}. So, if you type @kbd{C-z} in this mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
274 then you will be in vi mode.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
275
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
276 @node Vi Mode, Insert Mode, Emacs Mode, Modes in VIP
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
277 @subsection Vi Mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
278
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
279 This mode corresponds to Vi's command mode. Most Vi commands work as they
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
280 do in Vi. You can go back to emacs mode by typing @kbd{C-z}. You can
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
281 enter insert mode, just as in Vi, by typing @kbd{i}, @kbd{a} etc.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
282
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
283 @node Insert Mode, Differences from Vi, Vi Mode, Modes in VIP
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
284 @subsection Insert Mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
285
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
286 The key bindings in this mode is the same as in the emacs mode except for
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
287 the following 4 keys. So, you can move around in the buffer and change
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
288 its content while you are in insert mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
289
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
290 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
291 @item @key{ESC}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
292 @kindex 033 @kbd{ESC} (@code{vip-change-mode-to-vi}) (insert mode)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
293 This key will take you back to vi mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
294 @item C-h
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
295 @kindex 010 @kbd{C-h} (@code{vip-delete-backward-char}) (insert mode)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
296 Delete previous character.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
297 @item C-w
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
298 @kindex 027 @kbd{C-w} (@code{vip-delete-backward-word}) (insert mode)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
299 Delete previous word.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
300 @item C-z
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
301 @kindex 032 @kbd{C-z} (@code{vip-ESC}) (insert mode)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
302 Typing this key has the same effect as typing @key{ESC} in emacs mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
303 Thus typing @kbd{C-z x} in insert mode will have the same effect as typing
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
304 @kbd{ESC x} in emacs mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
305 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
306
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
307 @node Differences from Vi, Undoing, Insert Mode, Survey
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
308 @section Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
309
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
310 The major differences from Vi are explained below.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
311
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
312 @menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
313 * Undoing:: You can undo more in VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
314 * Changing:: Commands for changing the text.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
315 * Searching:: Search commands.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
316 * z Command:: You can now use zH, zM and zL as well as z- etc.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
317 * Counts:: Some Vi commands which do not accept a count now
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
318 accept one.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
319 * Marking:: You can now mark the current point, beginning of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
320 the buffer etc.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
321 * Region Commands:: You can now give a region as an argument for delete
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
322 commands etc.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
323 * New Commands:: Some new commands not available in Vi are added.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
324 * New Bindings:: Bindings of some keys are changed for the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
325 convenience of editing under Emacs.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
326 * Window Commands:: Commands for moving among windows etc.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
327 * Buffer Commands:: Commands for selecting buffers etc.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
328 * File Commands:: Commands for visiting files etc.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
329 * Misc Commands:: Other useful commands.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
330 @end menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
331
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
332 @node Undoing, Changing, Differences from Vi, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
333 @subsection Undoing
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
334
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
335 @kindex 165 @kbd{u} (@code{vip-undo})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
336 @kindex 056 @kbd{.} (@code{vip-repeat})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
337
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
338 You can repeat undoing by the @kbd{.} key. So, @kbd{u} will undo
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
339 a single change, while @kbd{u .@: .@: .@:}, for instance, will undo 4 previous
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
340 changes. Undo is undoable as in Vi. So the content of the buffer will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
341 be the same before and after @kbd{u u}.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
342
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
343 @node Changing, Searching, Undoing, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
344 @subsection Changing
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
345
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
346 Some commands which change a small number of characters are executed
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
347 slightly differently. Thus, if point is at the beginning of a word
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
348 @samp{foo} and you wished to change it to @samp{bar} by typing @w{@kbd{c w}},
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
349 then VIP will prompt you for a new word in the minibuffer by the prompt
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
350 @samp{foo => }. You can then enter @samp{bar} followed by @key{RET} or
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
351 @key{ESC} to complete the command. Before you enter @key{RET} or
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
352 @key{ESC} you can abort the command by typing @kbd{C-g}. In general,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
353 @kindex 007 @kbd{C-g} (@code{vip-keyboard-quit})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
354 you can abort a partially formed command by typing @kbd{C-g}.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
355
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
356 @node Searching, z Command, Changing, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
357 @subsection Searching
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
358
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
359 @kindex 057 @kbd{/} (@code{vip-search-forward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
360 @kindex 077 @kbd{?} (@code{vip-search-backward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
361
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
362 As in Vi, searching is done by @kbd{/} and @kbd{?}. The string will be
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
363 searched literally by default. To invoke a regular expression search,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
364 first execute the search command @kbd{/} (or @kbd{?}) with empty search
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
365 string. (I.e, type @kbd{/} followed by @key{RET}.)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
366 A search for empty string will toggle the search mode between vanilla
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
367 search and regular expression search. You cannot give an offset to the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
368 search string. (It is a limitation.) By default, search will wrap around
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
369 the buffer as in Vi. You can change this by rebinding the variable
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
370 @code{vip-search-wrap-around}. @xref{Customization}, for how to do this.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
371
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
372 @node z Command, Counts, Searching, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
373 @subsection z Command
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
374
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
375 @kindex 1723 @kbd{z H} (@code{vip-line-to-top})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
376 @kindex 1721 @kbd{z RET} (@code{vip-line-to-top})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
377 @kindex 1723 @kbd{z M} (@code{vip-line-to-middle})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
378 @kindex 1722 @kbd{z .} (@code{vip-line-to-middle})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
379 @kindex 1723 @kbd{z L} (@code{vip-line-to-bottom})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
380 @kindex 1722 @kbd{z -} (@code{vip-line-to-bottom})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
381
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
382 For those of you who cannot remember which of @kbd{z} followed by @key{RET},
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
383 @kbd{.}@: and @kbd{-} do what. You can also use @kbd{z} followed by @kbd{H},
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
384 @kbd{M} and @kbd{L} to place the current line in the Home (Middle, and
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
385 Last) line of the window.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
386
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
387 @node Counts, Marking, z Command, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
388 @subsection Counts
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
389
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
390 Some Vi commands which do not accept a count now accept one
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
391
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
392 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
393 @item p
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
394 @itemx P
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
395 @kindex 160 @kbd{p} (@code{vip-put-back})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
396 @kindex 120 @kbd{P} (@code{vip-Put-back})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
397 Given counts, text will be yanked (in Vi's sense) that many times. Thus
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
398 @kbd{3 p} is the same as @kbd{p p p}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
399 @item o
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
400 @itemx O
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
401 @kindex 157 @kbd{o} (@code{vip-open-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
402 @kindex 117 @kbd{O} (@code{vip-Open-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
403 Given counts, that many copies of text will be inserted. Thus
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
404 @kbd{o a b c @key{ESC}} will insert 3 lines of @samp{abc} below the current
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
405 line.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
406 @item /
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
407 @itemx ?
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
408 @kindex 057 @kbd{/} (@code{vip-search-forward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
409 @kindex 077 @kbd{?} (@code{vip-search-backward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
410 Given a count @var{n}, @var{n}-th occurrence will be searched.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
411 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
412
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
413 @node Marking, Region Commands, Counts, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
414 @subsection Marking
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
415
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
416 Typing an @kbd{m} followed by a lower-case character @var{ch} marks the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
417 point to the register named @var{ch} as in Vi. In addition to these, we
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
418 have following key bindings for marking.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
419
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
420 @kindex 155 @kbd{m} (@code{vip-mark-point})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
421
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
422 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
423 @item m <
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
424 Set mark at the beginning of buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
425 @item m >
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
426 Set mark at the end of buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
427 @item m .
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
428 Set mark at point (and push old mark on mark ring).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
429 @item m ,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
430 Jump to mark (and pop mark off the mark ring).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
431 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
432
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
433 @node Region Commands, New Commands, Marking, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
434 @subsection Region Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
435
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
436 @cindex region
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
437
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
438 Vi operators like @kbd{d}, @kbd{c} etc. are usually used in combination
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
439 with motion commands. It is now possible to use current region as the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
440 argument to these operators. (A @dfn{region} is a part of buffer
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
441 delimited by point and mark.) The key @kbd{r} is used for this purpose.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
442 Thus @kbd{d r} will delete the current region. If @kbd{R} is used instead
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
443 of @kbd{r} the region will first be enlarged so that it will become the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
444 smallest region containing the original region and consisting of whole
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
445 lines. Thus @kbd{m .@: d R} will have the same effect as @kbd{d d}.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
446
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
447 @node New Commands, New Bindings, Region Commands, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
448 @subsection Some New Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
449
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
450 Note that the keys below (except for @kbd{R}) are not used in Vi.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
451
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
452 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
453 @item C-a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
454 @kindex 001 @kbd{C-a} (@code{vip-beginning-of-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
455 Move point to the beginning of line.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
456 @item C-n
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
457 @kindex 016 @kbd{C-n} (@code{vip-next-window})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
458 If you have two or more windows in the screen, this key will move point to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
459 the next window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
460 @item C-o
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
461 @kindex 017 @kbd{C-o} (@code{vip-open-line-at-point})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
462 Insert a newline and leave point before it, and then enter insert mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
463 @item C-r
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
464 @kindex 022 @kbd{C-r} (@code{isearch-backward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
465 Backward incremental search.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
466 @item C-s
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
467 @kindex 023 @kbd{C-s} (@code{isearch-forward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
468 Forward incremental search.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
469 @item C-c
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
470 @itemx C-x
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
471 @itemx @key{ESC}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
472 @kindex 003 @kbd{C-c} (@code{vip-ctl-c})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
473 @kindex 0300 @kbd{C-x} (@code{vip-ctl-x})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
474 @kindex 033 @kbd{ESC} (@code{vip-ESC})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
475 These keys will exit from vi mode and return to emacs mode temporarily. If
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
476 you hit one of these keys, Emacs will be in emacs mode and will believe
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
477 that you hit that key in emacs mode. For example, if you hit @kbd{C-x}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
478 followed by @kbd{2}, then the current window will be split into 2 and you
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
479 will be in vi mode again.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
480 @item \
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
481 @kindex 134 @kbd{\} (@code{vip-escape-to-emacs})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
482 Escape to emacs mode. Hitting @kbd{\} will take you to emacs mode, and you
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
483 can execute a single Emacs command. After executing the Emacs command you
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
484 will be in vi mode again. You can give a count before typing @kbd{\}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
485 Thus @kbd{5 \ *}, as well as @kbd{\ C-u 5 *}, will insert @samp{*****}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
486 before point. Similarly @kbd{1 0 \ C-p} will move the point 10 lines above
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
487 the current line.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
488 @item K
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
489 @kindex 113 @kbd{K} (@code{vip-kill-buffer})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
490 Kill current buffer if it is not modified. Useful when you selected a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
491 buffer which you did not want.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
492 @item Q
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
493 @itemx R
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
494 @kindex 121 @kbd{Q} (@code{vip-query-replace})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
495 @kindex 122 @kbd{R} (@code{vip-replace-string})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
496 @kbd{Q} is for query replace and @kbd{R} is for replace. By default,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
497 string to be replaced are treated literally. If you wish to do a regular
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
498 expression replace, first do replace with empty string as the string to be
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
499 replaced. In this way, you can toggle between vanilla and regular
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
500 expression replacement.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
501 @item v
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
502 @itemx V
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
503 @kindex 166 @kbd{v} (@code{vip-find-file})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
504 @kindex 126 @kbd{V} (@code{vip-find-file-other-window})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
505 These keys are used to Visit files. @kbd{v} will switch to a buffer
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
506 visiting file whose name can be entered in the minibuffer. @kbd{V} is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
507 similar, but will use window different from the current window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
508 @item #
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
509 @kindex 0430 @kbd{#} (@code{vip-command-argument})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
510 If followed by a certain character @var{ch}, it becomes an operator whose
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
511 argument is the region determined by the motion command that follows.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
512 Currently, @var{ch} can be one of @kbd{c}, @kbd{C}, @kbd{g}, @kbd{q} and
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
513 @kbd{s}.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
514 @item # c
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
515 @kindex 0432 @kbd{# c} (@code{downcase-region})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
516 Change upper-case characters in the region to lower case
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
517 (@code{downcase-region}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
518 @item # C
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
519 @kindex 0431 @kbd{# C} (@code{upcase-region})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
520 Change lower-case characters in the region to upper case. For instance,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
521 @kbd{# C 3 w} will capitalize 3 words from the current point
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
522 (@code{upcase-region}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
523 @item # g
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
524 @kindex 0432 @kbd{# g} (@code{vip-global-execute})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
525 Execute last keyboard macro for each line in the region
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
526 (@code{vip-global-execute}).@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
527 @item # q
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
528 @kindex 0432 @kbd{# q} (@code{vip-quote-region})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
529 Insert specified string at the beginning of each line in the region
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
530 (@code{vip-quote-region}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
531 @item # s
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
532 @kindex 0432 @kbd{# s} (@code{spell-region})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
533 Check spelling of words in the region (@code{spell-region}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
534 @item *
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
535 @kindex 052 @kbd{*} (@code{vip-call-last-kbd-macro})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
536 Call last keyboard macro.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
537 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
538
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
539 @node New Bindings, Window Commands, New Commands, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
540 @subsection New Key Bindings
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
541
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
542 In VIP the meanings of some keys are entirely different from Vi. These key
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
543 bindings are done deliberately in the hope that editing under Emacs will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
544 become easier. It is however possible to rebind these keys to functions
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
545 which behave similarly as in Vi. @xref{Customizing Key Bindings}, for
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
546 details.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
547
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
548 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
549 @item C-g
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
550 @itemx g
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
551 @kindex 007 @kbd{C-g} (@code{vip-keyboard-quit})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
552 @kindex 147 @kbd{g} (@code{vip-info-on-file})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
553 In Vi, @kbd{C-g} is used to get information about the file associated to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
554 the current buffer. Here, @kbd{g} will do that, and @kbd{C-g} is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
555 used to abort a command (this is for compatibility with emacs mode.)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
556 @item SPC
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
557 @itemx @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
558 @kindex 040 @kbd{SPC} (@code{vip-scroll})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
559 @kindex 015 @kbd{RET} (@code{vip-scroll-back})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
560 Now these keys will scroll up and down the text of current window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
561 Convenient for viewing the text.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
562 @item s
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
563 @itemx S
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
564 @kindex 163 @kbd{s} (@code{vip-switch-to-buffer})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
565 @kindex 123 @kbd{S} (@code{vip-switch-to-buffer-other-window})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
566 They are used to switch to a specified buffer. Useful for switching to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
567 already existing buffer since buffer name completion is provided. Also
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
568 a default buffer will be given as part of the prompt, to which you can
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
569 switch by just typing @key{RET} key. @kbd{s} is used to select buffer
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
570 in the current window, while @kbd{S} selects buffer in another window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
571 @item C
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
572 @itemx X
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
573 @kindex 103 @kbd{C} (@code{vip-ctl-c-equivalent})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
574 @kindex 1300 @kbd{X} (@code{vip-ctl-x-equivalent})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
575 These keys will exit from vi mode and return to emacs mode temporarily.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
576 If you type @kbd{C} (@kbd{X}), Emacs will be in emacs mode and will believe
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
577 that you have typed @kbd{C-c} (@kbd{C-x}, resp.) in emacs mode. Moreover,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
578 if the following character you type is an upper-case letter, then Emacs
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
579 will believe that you have typed the corresponding control character.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
580 You will be in vi mode again after the command is executed. For example,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
581 typing @kbd{X S} in vi mode is the same as typing @kbd{C-x C-s} in emacs
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
582 mode. You get the same effect by typing @kbd{C-x C-s} in vi mode, but
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
583 the idea here is that you can execute useful Emacs commands without typing
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
584 control characters. For example, if you hit @kbd{X} (or @kbd{C-x}) followed
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
585 by @kbd{2}, then the current window will be split into 2 and you will be in
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
586 vi mode again.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
587 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
588
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
589 In addition to these, @code{ctl-x-map} is slightly modified:
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
590
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
591 @kindex 1301 @kbd{X 3} (@code{vip-buffer-in-two-windows})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
592
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
593 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
594 @item X 3
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
595 @itemx C-x 3
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
596 This is equivalent to @kbd{C-x 1 C-x 2} (1 + 2 = 3).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
597 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
598
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
599 @node Window Commands, Buffer Commands, New Bindings, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
600 @subsection Window Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
601
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
602 In this and following subsections, we give a summary of key bindings for
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
603 basic functions related to windows, buffers and files.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
604
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
605 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
606 @item C-n
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
607 @kindex 016 @kbd{C-n} (@code{vip-next-window})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
608 Switch to next window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
609 @item X 1
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
610 @itemx C-x 1
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
611 @kindex 1301 @kbd{X 1} (@code{delete-other-windows})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
612 Delete other windows.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
613 @item X 2
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
614 @itemx C-x 2
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
615 @kindex 1301 @kbd{X 2} (@code{split-window-vertically})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
616 Split current window into two windows.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
617 @item X 3
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
618 @itemx C-x 3
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
619 @kindex 1301 @kbd{X 3} (@code{vip-buffer-in-two-windows})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
620 Show current buffer in two windows.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
621 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
622
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
623 @node Buffer Commands, File Commands, Window Commands, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
624 @subsection Buffer Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
625
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
626 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
627 @item s
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
628 @kindex 163 @kbd{s} (@code{vip-switch-to-buffer})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
629 Switch to the specified buffer in the current window
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
630 (@code{vip-switch-to-buffer}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
631 @item S
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
632 @kindex 123 @kbd{S} (@code{vip-switch-to-buffer-other-window})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
633 Switch to the specified buffer in another window
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
634 (@code{vip-switch-to-buffer-other-window}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
635 @item K
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
636 @kindex 113 @kbd{K} (@code{vip-kill-buffer})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
637 Kill the current buffer if it is not modified.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
638 @item X S
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
639 @itemx C-x C-s
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
640 @kindex 1302 @kbd{X S} (@code{save-buffer})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
641 Save the current buffer in the file associated to the buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
642 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
643
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
644 @node File Commands, Misc Commands, Buffer Commands, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
645 @subsection File Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
646
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
647 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
648 @item v
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
649 @kindex 166 @kbd{v} (@code{vip-find-file})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
650 Visit specified file in the current window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
651 @item V
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
652 @kindex 126 @kbd{V} (@code{vip-find-file-other-window})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
653 Visit specified file in another window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
654 @item X W
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
655 @itemx C-x C-w
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
656 @kindex 1302 @kbd{X W} (@code{write-file})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
657 Write current buffer into the specified file.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
658 @item X I
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
659 @itemx C-x C-i
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
660 @kindex 1302 @kbd{X I} (@code{insert-file})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
661
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
662 Insert specified file at point.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
663 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
664
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
665 @node Misc Commands, Vi Commands, File Commands, Differences from Vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
666 @subsection Miscellaneous Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
667
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
668 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
669 @item X (
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
670 @itemx C-x (
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
671 @kindex 1301 @kbd{X (} (@code{start-kbd-macro})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
672 Start remembering keyboard macro.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
673 @item X )
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
674 @itemx C-x )
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
675 @kindex 1301 @kbd{X )} (@code{end-kbd-macro})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
676 Finish remembering keyboard macro.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
677 @item *
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
678 @kindex 052 @kbd{*} (@code{vip-call-last-kbd-macro})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
679 Call last remembered keyboard macro.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
680 @item X Z
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
681 @itemx C-x C-z
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
682 @kindex 1302 @kbd{X Z} (@code{suspend-emacs})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
683 Suspend Emacs.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
684 @item Z Z
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
685 Exit Emacs.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
686 @itemx Q
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
687 Query replace.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
688 @itemx R
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
689 Replace.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
690 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
691
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
692 @node Vi Commands, Numeric Arguments, Misc Commands, Top
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
693 @chapter Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
694
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
695 This chapter describes Vi commands other than Ex commands implemented in
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
696 VIP. Except for the last section which discusses insert mode, all the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
697 commands described in this chapter are to be used in vi mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
698
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
699 @menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
700 * Numeric Arguments:: Many commands accept numeric arguments
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
701 * Important Keys:: Some very important keys.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
702 * Buffers and Windows:: Commands for handling buffers and windows.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
703 * Files:: Commands for handling files.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
704 * Viewing the Buffer:: How you can view the current buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
705 * Mark Commands:: Marking positions in a buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
706 * Motion Commands:: Commands for moving point.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
707 * Searching and Replacing:: Commands for searching and replacing.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
708 * Modifying Commands:: Commands for modifying the buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
709 * Other Vi Commands:: Miscellaneous Commands.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
710 * Commands in Insert Mode:: Commands for entering insert mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
711 @end menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
712
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
713 @node Numeric Arguments, Important Keys, Vi Commands, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
714 @section Numeric Arguments
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
715
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
716 @cindex numeric arguments
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
717 @cindex count
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
718 @kindex 061 @kbd{1} (numeric argument)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
719 @kindex 062 @kbd{2} (numeric argument)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
720 @kindex 063 @kbd{3} (numeric argument)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
721 @kindex 064 @kbd{4} (numeric argument)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
722 @kindex 065 @kbd{5} (numeric argument)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
723 @kindex 066 @kbd{6} (numeric argument)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
724 @kindex 067 @kbd{7} (numeric argument)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
725 @kindex 068 @kbd{8} (numeric argument)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
726 @kindex 069 @kbd{9} (numeric argument)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
727
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
728 Most Vi commands accept a @dfn{numeric argument} which can be supplied as
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
729 a prefix to the commands. A numeric argument is also called a @dfn{count}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
730 In many cases, if a count is given, the command is executed that many times.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
731 For instance, @kbd{5 d d} deletes 5 lines while simple @kbd{d d} deletes a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
732 line. In this manual the metavariable @var{n} will denote a count.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
733
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
734 @node Important Keys, Buffers and Windows, Numeric Arguments, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
735 @section Important Keys
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
736
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
737 The keys @kbd{C-g} and @kbd{C-l} are unique in that their associated
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
738 functions are the same in any of emacs, vi and insert mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
739
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
740 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
741 @item C-g
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
742 @kindex 007 @kbd{C-g} (@code{vip-keyboard-quit})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
743 Quit. Cancel running or partially typed command (@code{keyboard-quit}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
744 @item C-l
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
745 @kindex 014 @kbd{C-l} (@code{recenter})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
746 Clear the screen and reprint everything (@code{recenter}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
747 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
748
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
749 In Emacs many commands are bound to the key strokes that start with
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
750 @kbd{C-x}, @kbd{C-c} and @key{ESC}. These commands can be
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
751 accessed from vi mode as easily as from emacs mode.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
752
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
753 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
754 @item C-x
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
755 @itemx C-c
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
756 @itemx @key{ESC}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
757 @kindex 003 @kbd{C-c} (@code{vip-ctl-c})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
758 @kindex 0300 @kbd{C-x} (@code{vip-ctl-x})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
759 @kindex 033 @kbd{ESC} (@code{vip-ESC})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
760 Typing one of these keys have the same effect as typing it in emacs mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
761 Appropriate command will be executed according as the keys you type after
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
762 it. You will be in vi mode again after the execution of the command.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
763 For instance, if you type @kbd{@key{ESC} <} (in vi mode) then the cursor will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
764 move to the beginning of the buffer and you will still be in vi mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
765 @item C
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
766 @itemx X
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
767 @kindex 103 @kbd{C} (@code{vip-ctl-c-equivalent})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
768 @kindex 1300 @kbd{X} (@code{vip-ctl-x-equivalent})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
769 Typing one of these keys have the effect of typing the corresponding
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
770 control character in emacs mode. Moreover, if you type an upper-case
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
771 character following it, that character will also be translated to the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
772 corresponding control character. Thus typing @kbd{X W} in vi mode is the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
773 same as typing @kbd{C-x C-w} in emacs mode. You will be in vi mode again
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
774 after the execution of a command.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
775 @item \
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
776 @kindex 134 @kbd{\} (@code{vip-escape-to-emacs})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
777 Escape to emacs mode. Hitting the @kbd{\} key will take you to emacs mode,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
778 and you can execute a single Emacs command. After executing the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
779 Emacs command you will be in vi mode again. You can give a count before
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
780 typing @kbd{\}. Thus @kbd{5 \ +}, as well as @kbd{\ C-u 5 +}, will insert
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
781 @samp{+++++} before point.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
782 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
783
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
784 @node Buffers and Windows, Files, Important Keys, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
785 @section Buffers and Windows
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
786
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
787 @cindex buffer
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
788 @cindex selected buffer
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
789 @cindex current buffer
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
790
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
791 In Emacs the text you edit is stored in a @dfn{buffer}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
792 See GNU Emacs Manual, for details. There is always one @dfn{current}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
793 buffer, also called the @dfn{selected buffer}.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
794
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
795 @cindex window
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
796 @cindex modified (buffer)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
797
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
798 You can see the contents of buffers through @dfn{windows} created by Emacs.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
799 When you have multiple windows on the screen only one of them is selected.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
800 Each buffer has a unique name, and each window has a mode line which shows
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
801 the name of the buffer associated with the window and other information
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
802 about the status of the buffer. You can change the format of the mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
803 line, but normally if you see @samp{**} at the beginning of a mode line it
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
804 means that the buffer is @dfn{modified}. If you write out the content of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
805 the buffer to a file, then the buffer will become not modified. Also if
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
806 you see @samp{%%} at the beginning of the mode line, it means that the file
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
807 associated with the buffer is write protected.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
808
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
809 We have the following commands related to windows and buffers.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
810
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
811 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
812 @item C-n
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
813 @kindex 016 @kbd{C-n} (@code{vip-next-window})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
814 Move cursor to the next-window (@code{vip-next-window}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
815 @item X 1
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
816 @kindex 1301 @kbd{X 1} (@code{delete-other-windows})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
817 Delete other windows and make the selected window fill the screen
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
818 @*(@code{delete-other-windows}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
819 @item X 2
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
820 @kindex 1301 @kbd{X 2} (@code{split-window-vertically})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
821 Split current window into two windows (@code{split-window-vertically}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
822 @item X 3
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
823 @kindex 1301 @kbd{X 3} (@code{vip-buffer-in-two-windows})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
824 Show current buffer in two windows.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
825 @item s @var{buffer} @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
826 @kindex 163 @kbd{s} (@code{vip-switch-to-buffer})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
827 Select or create a buffer named @var{buffer} (@code{vip-switch-to-buffer}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
828 @item S @var{buffer} @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
829 @kindex 123 @kbd{S} (@code{vip-switch-to-buffer-other-window})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
830 Similar but select a buffer named @var{buffer} in another window
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
831 @*(@code{vip-switch-to-buffer-other-window}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
832 @item K
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
833 @kindex 113 @kbd{K} (@code{vip-kill-buffer})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
834 Kill the current buffer if it is not modified or if it is not associated
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
835 with a file @*(@code{vip-kill-buffer}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
836 @item X B
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
837 @kindex 1302 @kbd{X B} (@code{list-buffers})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
838 List the existing buffers (@code{list-buffers}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
839 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
840
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
841 @cindex buffer name completion
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
842
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
843 As @dfn{buffer name completion} is provided, you have only to type in
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
844 initial substring of the buffer name which is sufficient to identify it
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
845 among names of existing buffers. After that, if you hit @key{TAB} the rest
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
846 of the buffer name will be supplied by the system, and you can confirm it
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
847 by @key{RET}. The default buffer name to switch to will also be prompted,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
848 and you can select it by giving a simple @key{RET}. See GNU Emacs Manual
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
849 for details of completion.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
850
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
851 @node Files, Viewing the Buffer, Buffers and Windows, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
852 @section Files
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
853
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
854 We have the following commands related to files. They are used to visit,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
855 save and insert files.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
856
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
857 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
858 @item v @var{file} @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
859 @kindex 166 @kbd{v} (@code{vip-find-file})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
860 Visit specified file in the current window (@code{vip-find-file}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
861 @item V @var{file} @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
862 @kindex 126 @kbd{V} (@code{vip-find-file-other-window})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
863 Visit specified file in another window (@code{vip-find-file-other-window}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
864 @item X S
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
865 @kindex 1302 @kbd{X S} (@code{save-buffer})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
866 Save current buffer to the file associated with the buffer. If no file is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
867 associated with the buffer, the name of the file to write out the content
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
868 of the buffer will be asked in the minibuffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
869 @item X W @var{file} @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
870 @kindex 1302 @kbd{X W} (@code{write-file})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
871 Write current buffer into a specified file.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
872 @item X I @var{file} @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
873 @kindex 1302 @kbd{X I} (@code{insert-file})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
874 Insert a specified file at point.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
875 @item g
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
876 @kindex 147 @kbd{g} (@code{vip-info-on-file})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
877 Give information on the file associated with the current buffer. Tell you
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
878 the name of the file associated with the buffer, the line number of the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
879 current point and total line numbers in the buffer. If no file is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
880 associated with the buffer, this fact will be indicated by the null file
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
881 name @samp{""}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
882 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
883
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
884 @cindex visiting (a file)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
885 @cindex default directory
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
886
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
887 In Emacs, you can edit a file by @dfn{visiting} it. If you wish to visit a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
888 file in the current window, you can just type @kbd{v}. Emacs maintains the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
889 @dfn{default directory} which is specific to each buffer. Suppose, for
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
890 instance, that the default directory of the current buffer is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
891 @file{/usr/masahiko/lisp/}. Then you will get the following prompt in the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
892 minibuffer.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
893 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
894 visit file: /usr/masahiko/lisp/
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
895 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
896 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
897 @cindex file name completion
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
898 If you wish to visit, say, @file{vip.el} in this directory, then you can
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
899 just type @samp{vip.el} followed by @key{RET}. If the file @file{vip.el}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
900 already exists in the directory, Emacs will visit that file, and if not,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
901 the file will be created. Emacs will use the file name (@file{vip.el}, in
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
902 this case) as the name of the buffer visiting the file. In order to make
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
903 the buffer name unique, Emacs may append @samp{<2>}, @samp{<3>} etc., to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
904 the buffer name. As the @dfn{file name completion} is provided here, you
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
905 can sometime save typing. For instance, suppose there is only one file in the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
906 default directory whose name starts with @samp{v}, that is @samp{vip.el}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
907 Then if you just type @kbd{v @key{TAB}} then it will be completed to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
908 @samp{vip.el}. Thus, in this case, you just have to type @kbd{v v @key{TAB}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
909 @key{RET}} to visit @file{/usr/masahiko/lisp/vip.el}. Continuing the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
910 example, let us now suppose that you wished to visit the file
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
911 @file{/usr/masahiko/man/vip.texinfo}. Then to the same prompt which you get
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
912 after you typed @kbd{v}, you can enter @samp{/usr/masahiko/man/vip.texinfo} or
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
913 @samp{../man/vip.texinfo} followed by @key{RET}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
914
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
915 Use @kbd{V} instead of @kbd{v}, if you wish to visit a file in another
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
916 window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
917
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
918 You can verify which file you are editing by typing @kbd{g}. (You can also
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
919 type @kbd{X B} to get information on other buffers too.) If you type
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
920 @kbd{g} you will get an information like below in the echo area:@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
921 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
922 "/usr/masahiko/man/vip.texinfo" line 921 of 1949
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
923 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
924
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
925 After you edited the buffer (@samp{vip.texinfo}, in our example) for a while,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
926 you may wish to save it in a file. If you wish to save it in the file
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
927 associated with the buffer (@file{/usr/masahiko/man/vip.texinfo}, in this
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
928 case), you can just say @kbd{X S}. If you wish to save it in another file,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
929 you can type @kbd{X W}. You will then get a similar prompt as you get for
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
930 @kbd{v}, to which you can enter the file name.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
931
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
932 @node Viewing the Buffer, Mark Commands, Files, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
933 @section Viewing the Buffer
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
934
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
935 In this and next section we discuss commands for moving around in the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
936 buffer. These command do not change the content of the buffer. The
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
937 following commands are useful for viewing the content of the current
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
938 buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
939
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
940 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
941 @item @key{SPC}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
942 @itemx C-f
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
943 @kindex 040 @kbd{SPC} (@code{vip-scroll})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
944 @kindex 006 @kbd{C-f} (@code{vip-scroll-back})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
945 Scroll text of current window upward almost full screen. You can go
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
946 @i{forward} in the buffer by this command (@code{vip-scroll}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
947 @item @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
948 @itemx C-b
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
949 @kindex 015 @kbd{RET} (@code{vip-scroll-back})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
950 @kindex 002 @kbd{C-b} (@code{vip-scroll-back})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
951 Scroll text of current window downward almost full screen. You can go
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
952 @i{backward} in the buffer by this command (@code{vip-scroll-back}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
953 @itemx C-d
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
954 @kindex 004 @kbd{C-d} (@code{vip-scroll-up})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
955 Scroll text of current window upward half screen. You can go
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
956 @i{down} in the buffer by this command (@code{vip-scroll-down}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
957 @itemx C-u
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
958 @kindex 025 @kbd{C-u} (@code{vip-scroll-down})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
959 Scroll text of current window downward half screen. You can go
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
960 @i{up} in the buffer by this command (@code{vip-scroll-up}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
961 @item C-y
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
962 @kindex 031 @kbd{C-y} (@code{vip-scroll-down-one})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
963 Scroll text of current window upward by one line (@code{vip-scroll-down-one}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
964 @item C-e
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
965 @kindex 005 @kbd{C-e} (@code{vip-scroll-up-one})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
966 Scroll text of current window downward by one line (@code{vip-scroll-up-one}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
967 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
968 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
969 You can repeat these commands by giving a count. Thus, @kbd{2 @key{SPC}}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
970 has the same effect as @kbd{@key{SPC} @key{SPC}}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
971
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
972 The following commands reposition point in the window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
973
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
974 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
975 @item z H
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
976 @itemx z @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
977 @kindex 1723 @kbd{z H} (@code{vip-line-to-top})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
978 @kindex 1721 @kbd{z RET} (@code{vip-line-to-top})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
979 Put point on the top (@i{home}) line in the window. So the current line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
980 becomes the top line in the window. Given a count @var{n}, point will be
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
981 placed in the @var{n}-th line from top (@code{vip-line-to-top}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
982 @item z M
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
983 @itemx z .
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
984 @kindex 1723 @kbd{z M} (@code{vip-line-to-middle})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
985 @kindex 1722 @kbd{z .} (@code{vip-line-to-middle})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
986 Put point on the @i{middle} line in the window. Given a count @var{n},
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
987 point will be placed in the @var{n}-th line from the middle line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
988 (@code{vip-line-to-middle}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
989 @item z L
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
990 @itemx z -
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
991 @kindex 1723 @kbd{z L} (@code{vip-line-to-bottom})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
992 @kindex 1722 @kbd{z -} (@code{vip-line-to-bottom})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
993 Put point on the @i{bottom} line in the window. Given a count @var{n},
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
994 point will be placed in the @var{n}-th line from bottom
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
995 (@code{vip-line-to-bottom}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
996 @item C-l
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
997 Center point in window and redisplay screen (@code{recenter}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
998 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
999
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1000 @node Mark Commands, Motion Commands, Viewing the Buffer, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1001 @section Mark Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1002
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1003 The following commands are used to mark positions in the buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1004
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1005 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1006 @item m @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1007 @kindex 155 @kbd{m} (@code{vip-mark-point})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1008 Store current point in the register @var{ch}. @var{ch} must be a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1009 lower-case @acronym{ASCII} letter.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1010 @item m <
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1011 Set mark at the beginning of current buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1012 @item m >
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1013 Set mark at the end of current buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1014 @item m .
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1015 Set mark at point.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1016 @item m ,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1017 Jump to mark (and pop mark off the mark ring).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1018 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1019
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1020 @cindex mark ring
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1021
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1022 Emacs uses the @dfn{mark ring} to store marked positions. The commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1023 @kbd{m <}, @kbd{m >} and @kbd{m .}@: not only set mark but also add it as the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1024 latest element of the mark ring (replacing the oldest one). By repeating
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1025 the command `@kbd{m ,}' you can visit older and older marked positions. You
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1026 will eventually be in a loop as the mark ring is a ring.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1027
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1028 @node Motion Commands, Searching and Replacing, Mark Commands, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1029 @section Motion Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1030
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1031 Commands for moving around in the current buffer are collected here. These
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1032 commands are used as an `argument' for the delete, change and yank commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1033 to be described in the next section.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1034
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1035 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1036 @item h
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1037 @kindex 150 @kbd{h} (@code{vip-backward-char})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1038 Move point backward by one character. Signal error if point is at the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1039 beginning of buffer, but (unlike Vi) do not complain otherwise
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1040 (@code{vip-backward-char}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1041 @item l
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1042 @kindex 154 @kbd{l} (@code{vip-forward-char})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1043 Move point backward by one character. Signal error if point is at the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1044 end of buffer, but (unlike Vi) do not complain otherwise
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1045 (@code{vip-forward-char}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1046 @item j
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1047 @kindex 152 @kbd{j} (@code{vip-next-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1048 Move point to the next line keeping the current column. If point is on the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1049 last line of the buffer, a new line will be created and point will move to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1050 that line (@code{vip-next-line}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1051 @item k
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1052 @kindex 153 @kbd{k} (@code{vip-previous-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1053 Move point to the previous line keeping the current column
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1054 (@code{vip-next-line}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1055 @item +
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1056 @kindex 053 @kbd{+} (@code{vip-next-line-at-bol})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1057 Move point to the next line at the first non-white character. If point is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1058 on the last line of the buffer, a new line will be created and point will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1059 move to the beginning of that line (@code{vip-next-line-at-bol}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1060 @item -
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1061 @kindex 055 @kbd{-} (@code{vip-previous-line-at-bol})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1062 Move point to the previous line at the first non-white character
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1063 (@code{vip-previous-line-at-bol}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1064 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1065 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1066 If a count is given to these commands, the commands will be repeated that
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1067 many times.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1068
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1069 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1070 @item 0
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1071 @kindex 060 @kbd{0} (@code{vip-beginning-of-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1072 Move point to the beginning of line (@code{vip-beginning-of-line}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1073 @item ^
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1074 @kindex 136 @kbd{^} (@code{vip-bol-and-skip-white})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1075 Move point to the first non-white character on the line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1076 (@code{vip-bol-and-skip-white}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1077 @item $
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1078 @kindex 044 @kbd{$} (@code{vip-goto-eol})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1079 Move point to the end of line (@code{vip-goto-eol}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1080 @item @var{n} |
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1081 @kindex 174 @kbd{|} (@code{vip-goto-col})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1082 Move point to the @var{n}-th column on the line (@code{vip-goto-col}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1083 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1084 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1085 Except for the @kbd{|} command, these commands neglect a count.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1086
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1087 @cindex word
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1088
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1089 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1090 @item w
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1091 @kindex 167 @kbd{w} (@code{vip-forward-word})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1092 Move point forward to the beginning of the next word
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1093 (@code{vip-forward-word}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1094 @item W
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1095 @kindex 127 @kbd{W} (@code{vip-forward-Word})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1096 Move point forward to the beginning of the next word, where a @dfn{word} is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1097 considered as a sequence of non-white characters (@code{vip-forward-Word}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1098 @item b
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1099 @kindex 142 @kbd{b} (@code{vip-backward-word})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1100 Move point backward to the beginning of a word (@code{vip-backward-word}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1101 @item B
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1102 @kindex 102 @kbd{B} (@code{vip-backward-Word})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1103 Move point backward to the beginning of a word, where a @i{word} is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1104 considered as a sequence of non-white characters (@code{vip-forward-Word}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1105 @item e
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1106 @kindex 145 @kbd{e} (@code{vip-end-of-word})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1107 Move point forward to the end of a word (@code{vip-end-of-word}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1108 @item E
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1109 @kindex 105 @kbd{E} (@code{vip-end-of-Word})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1110 Move point forward to the end of a word, where a @i{word} is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1111 considered as a sequence of non-white characters (@code{vip-end-of-Word}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1112 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1113 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1114 @cindex syntax table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1115 Here the meaning of the word `word' for the @kbd{w}, @kbd{b} and @kbd{e}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1116 commands is determined by the @dfn{syntax table} effective in the current
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1117 buffer. Each major mode has its syntax mode, and therefore the meaning of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1118 a word also changes as the major mode changes. See GNU Emacs Manual for
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1119 details of syntax table.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1120
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1121 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1122 @item H
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1123 @kindex 110 @kbd{H} (@code{vip-window-top})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1124 Move point to the beginning of the @i{home} (top) line of the window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1125 Given a count @var{n}, go to the @var{n}-th line from top
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1126 (@code{vip-window-top}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1127 @item M
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1128 @kindex 115 @kbd{M} (@code{vip-window-middle})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1129 Move point to the beginning of the @i{middle} line of the window. Given
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1130 a count @var{n}, go to the @var{n}-th line from the middle line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1131 (@code{vip-window-middle}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1132 @item L
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1133 @kindex 114 @kbd{L} (@code{vip-window-bottom})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1134 Move point to the beginning of the @i{lowest} (bottom) line of the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1135 window. Given count, go to the @var{n}-th line from bottom
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1136 (@code{vip-window-bottom}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1137 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1138 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1139 These commands can be used to go to the desired line visible on the screen.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1140
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1141 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1142 @item (
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1143 @kindex 050 @kbd{(} (@code{vip-backward-sentence})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1144 Move point backward to the beginning of the sentence
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1145 (@code{vip-backward-sentence}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1146 @item )
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1147 @kindex 051 @kbd{)} (@code{vip-forward-sentence})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1148 Move point forward to the end of the sentence
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1149 (@code{vip-forward-sentence}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1150 @item @{
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1151 @kindex 173 @kbd{@{} (@code{vip-backward-paragraph})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1152 Move point backward to the beginning of the paragraph
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1153 (@code{vip-backward-paragraph}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1154 @item @}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1155 @kindex 175 @kbd{@}} (@code{vip-forward-paragraph})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1156 Move point forward to the end of the paragraph
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1157 (@code{vip-forward-paragraph}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1158 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1159 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1160 A count repeats the effect for these commands.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1161
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1162 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1163 @item G
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1164 @kindex 107 @kbd{G} (@code{vip-goto-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1165 Given a count @var{n}, move point to the @var{n}-th line in the buffer on
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1166 the first non-white character. Without a count, go to the end of the buffer
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1167 (@code{vip-goto-line}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1168 @item ` `
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1169 @kindex 140 @kbd{`} (@code{vip-goto-mark})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1170 Exchange point and mark (@code{vip-goto-mark}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1171 @item ` @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1172 Move point to the position stored in the register @var{ch}. @var{ch} must
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1173 be a lower-case letter.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1174 @item ' '
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1175 @kindex 047 @kbd{'} (@code{vip-goto-mark-and-skip-white})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1176 Exchange point and mark, and then move point to the first non-white
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1177 character on the line (@code{vip-goto-mark-and-skip-white}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1178 @item ' @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1179 Move point to the position stored in the register @var{ch} and skip to the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1180 first non-white character on the line. @var{ch} must be a lower-case letter.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1181 @item %
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1182 @kindex 045 @kbd{%} (@code{vip-paren-match})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1183 Move point to the matching parenthesis if point is looking at @kbd{(},
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1184 @kbd{)}, @kbd{@{}, @kbd{@}}, @kbd{[} or @kbd{]}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1185 @*(@code{vip-paren-match}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1186 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1187 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1188 The command @kbd{G} mark point before move, so that you can return to the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1189 original point by @kbd{` `}. The original point will also be stored in
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1190 the mark ring.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1191
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1192 The following commands are useful for moving points on the line. A count
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1193 will repeat the effect.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1194
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1195 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1196 @item f @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1197 @kindex 146 @kbd{f} (@code{vip-find-char-forward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1198 Move point forward to the character @var{ch} on the line. Signal error if
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1199 @var{ch} could not be found (@code{vip-find-char-forward}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1200 @item F @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1201 @kindex 106 @kbd{F} (@code{vip-find-char-backward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1202 Move point backward to the character @var{ch} on the line. Signal error if
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1203 @var{ch} could not be found (@code{vip-find-char-backward}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1204 @item t @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1205 @kindex 164 @kbd{t} (@code{vip-goto-char-forward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1206 Move point forward upto the character @var{ch} on the line. Signal error if
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1207 @var{ch} could not be found (@code{vip-goto-char-forward}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1208 @item T @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1209 @kindex 124 @kbd{T} (@code{vip-goto-char-backward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1210 Move point backward upto the character @var{ch} on the line. Signal error if
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1211 @var{ch} could not be found (@code{vip-goto-char-backward}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1212 @item ;
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1213 @kindex 073 @kbd{;} (@code{vip-repeat-find})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1214 Repeat previous @kbd{f}, @kbd{t}, @kbd{F} or @kbd{T} command
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1215 (@code{vip-repeat-find}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1216 @item ,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1217 @kindex 054 @kbd{,} (@code{vip-repeat-find-opposite})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1218 Repeat previous @kbd{f}, @kbd{t}, @kbd{F} or @kbd{T} command, in the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1219 opposite direction (@code{vip-repeat-find-opposite}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1220 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1221
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1222 @node Searching and Replacing, Modifying Commands, Motion Commands, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1223 @section Searching and Replacing
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1224
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1225 Following commands are available for searching and replacing.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1226
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1227 @cindex regular expression (search)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1228
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1229 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1230 @item / @var{string} @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1231 @kindex 057 @kbd{/} (@code{vip-search-forward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1232 Search the first occurrence of the string @var{string} forward starting
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1233 from point. Given a count @var{n}, the @var{n}-th occurrence of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1234 @var{string} will be searched. If the variable @code{vip-re-search} has value
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1235 @code{t} then @dfn{regular expression} search is done and the string
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1236 matching the regular expression @var{string} is found. If you give an
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1237 empty string as @var{string} then the search mode will change from vanilla
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1238 search to regular expression search and vice versa
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1239 (@code{vip-search-forward}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1240 @item ? @var{string} @key{RET}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1241 @kindex 077 @kbd{?} (@code{vip-search-backward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1242 Same as @kbd{/}, except that search is done backward
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1243 (@code{vip-search-backward}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1244 @item n
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1245 @kindex 156 @kbd{n} (@code{vip-search-next})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1246 Search the previous search pattern in the same direction as before
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1247 (@code{vip-search-next}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1248 @item N
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1249 @kindex 116 @kbd{N} (@code{vip-search-Next})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1250 Search the previous search pattern in the opposite direction
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1251 (@code{vip-search-Next}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1252 @item C-s
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1253 @kindex 023 @kbd{C-s} (@code{isearch-forward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1254 Search forward incrementally. See GNU Emacs Manual for details
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1255 (@code{isearch-forward}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1256 @item C-r
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1257 @kindex 022 @kbd{C-r} (@code{isearch-backward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1258 Search backward incrementally (@code{isearch-backward}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1259 @cindex vanilla (replacement)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1260 @cindex regular expression (replacement)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1261 @item R @var{string} RET @var{newstring}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1262 @kindex 122 @kbd{R} (@code{vip-replace-string})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1263 There are two modes of replacement, @dfn{vanilla} and @dfn{regular expression}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1264 If the mode is @i{vanilla} you will get a prompt @samp{Replace string:},
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1265 and if the mode is @i{regular expression} you will ge a prompt
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1266 @samp{Replace regexp:}. The mode is initially @i{vanilla}, but you can
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1267 toggle these modes by giving a null string as @var{string}. If the mode is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1268 vanilla, this command replaces every occurrence of @var{string} with
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1269 @var{newstring}. If the mode is regular expression, @var{string} is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1270 treated as a regular expression and every string matching the regular
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1271 expression is replaced with @var{newstring} (@code{vip-replace-string}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1272 @item Q @var{string} RET @var{newstring}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1273 @kindex 121 @kbd{Q} (@code{vip-query-replace})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1274 Same as @kbd{R} except that you will be asked form confirmation before each
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1275 replacement
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1276 @*(@code{vip-query-replace}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1277 @item r @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1278 @kindex 162 @kbd{r} (@code{vip-replace-char})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1279 Replace the character point is looking at by the character @var{ch}. Give
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1280 count, replace that many characters by @var{ch} (@code{vip-replace-char}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1281 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1282 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1283 The commands @kbd{/} and @kbd{?} mark point before move, so that you can
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1284 return to the original point by @w{@kbd{` `}}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1285
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1286 @node Modifying Commands, Delete Commands, Searching and Replacing, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1287 @section Modifying Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1288
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1289 In this section, commands for modifying the content of a buffer are
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1290 described. These commands affect the region determined by a motion command
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1291 which is given to the commands as their argument.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1292
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1293 @cindex point commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1294 @cindex line commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1295
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1296 We classify motion commands into @dfn{point commands} and
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1297 @dfn{line commands}. The point commands are as follows:
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1298 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1299 @kbd{h}, @kbd{l}, @kbd{0}, @kbd{^}, @kbd{$}, @kbd{w}, @kbd{W}, @kbd{b}, @kbd{B}, @kbd{e}, @kbd{E}, @kbd{(}, @kbd{)}, @kbd{/}, @kbd{?}, @kbd{`}, @kbd{f}, @kbd{F}, @kbd{t}, @kbd{T}, @kbd{%}, @kbd{;}, @kbd{,}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1300 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1301 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1302 The line commands are as follows:
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1303 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1304 @kbd{j}, @kbd{k}, @kbd{+}, @kbd{-}, @kbd{H}, @kbd{M}, @kbd{L}, @kbd{@{}, @kbd{@}}, @kbd{G}, @kbd{'}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1305 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1306 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1307 @cindex expanding (region)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1308 If a point command is given as an argument to a modifying command, the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1309 region determined by the point command will be affected by the modifying
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1310 command. On the other hand, if a line command is given as an argument to a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1311 modifying command, the region determined by the line command will be
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1312 enlarged so that it will become the smallest region properly containing the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1313 region and consisting of whole lines (we call this process @dfn{expanding
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1314 the region}), and then the enlarged region will be affected by the modifying
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1315 command.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1316
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1317 @menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1318 * Delete Commands:: Commands for deleting text.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1319 * Yank Commands:: Commands for yanking text in Vi's sense.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1320 * Put Back Commands:: Commands for putting back deleted/yanked text.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1321 * Change Commands:: Commands for changing text.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1322 * Repeating and Undoing Modifications::
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1323 @end menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1324 @node Delete Commands, Yank Commands, Modifying Commands, Modifying Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1325 @subsection Delete Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1326
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1327 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1328 @item d @var{motion-command}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1329 @kindex 1440 @kbd{d} (@code{vip-command-argument})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1330 Delete the region determined by the motion command @var{motion-command}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1331 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1332 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1333 For example, @kbd{d $} will delete the region between point and end of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1334 current line since @kbd{$} is a point command that moves point to end of line.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1335 @kbd{d G} will delete the region between the beginning of current line and
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1336 end of the buffer, since @kbd{G} is a line command. A count given to the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1337 command above will become the count for the associated motion command.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1338 Thus, @kbd{3 d w} will delete three words.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1339
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1340 @kindex 042 @kbd{"} (@code{vip-command-argument})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1341 It is also possible to save the deleted text into a register you specify.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1342 For example, you can say @kbd{" t 3 d w} to delete three words and save it
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1343 to register @kbd{t}. The name of a register is a lower-case letter between
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1344 @kbd{a} and @kbd{z}. If you give an upper-case letter as an argument to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1345 a delete command, then the deleted text will be appended to the content of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1346 the register having the corresponding lower-case letter as its name. So,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1347 @kbd{" T d w} will delete a word and append it to register @kbd{t}. Other
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1348 modifying commands also accept a register name as their argument, and we
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1349 will not repeat similar explanations.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1350
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1351 We have more delete commands as below.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1352
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1353 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1354 @item d d
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1355 @kindex 1442 @kbd{d d}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1356 Delete a line. Given a count @var{n}, delete @var{n} lines.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1357 @item d r
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1358 @kindex 1442 @kbd{d r}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1359 Delete current region.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1360 @item d R
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1361 @kindex 1441 @kbd{d R}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1362 Expand current region and delete it.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1363 @item D
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1364 @kindex 104 @kbd{D} (@code{vip-kill-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1365 Delete to the end of a line (@code{vip-kill-line}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1366 @item x
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1367 @kindex 170 @kbd{x} (@code{vip-delete-char})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1368 Delete a character after point. Given @var{n}, delete @var{n} characters
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1369 (@code{vip-delete-char}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1370 @item @key{DEL}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1371 @kindex 177 @kbd{DEL} (@code{vip-delete-backward-char})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1372 Delete a character before point. Given @var{n}, delete @var{n} characters
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1373 (@code{vip-delete-backward-char}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1374 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1375
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1376 @node Yank Commands, Put Back Commands, Delete Commands, Modifying Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1377 @subsection Yank Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1378
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1379 @cindex yank
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1380
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1381 Yank commands @dfn{yank} a text of buffer into a (usually anonymous) register.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1382 Here the word `yank' is used in Vi's sense. Thus yank commands do not
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1383 alter the content of the buffer, and useful only in combination with
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1384 commands that put back the yanked text into the buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1385
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1386 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1387 @item y @var{motion-command}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1388 @kindex 1710 @kbd{y} (@code{vip-command-argument})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1389 Yank the region determined by the motion command @var{motion-command}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1390 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1391 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1392 For example, @kbd{y $} will yank the text between point and the end of line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1393 into an anonymous register, while @kbd{"c y $} will yank the same text into
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1394 register @kbd{c}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1395
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1396 Use the following command to yank consecutive lines of text.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1397
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1398 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1399 @item y y
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1400 @itemx Y
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1401 @kindex 131 @kbd{Y} (@code{vip-yank-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1402 @kindex 1712 @kbd{y y} (@code{vip-yank-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1403 Yank a line. Given @var{n}, yank @var{n} lines (@code{vip-yank-line}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1404 @item y r
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1405 @kindex 1712 @kbd{y r}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1406 Yank current region.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1407 @item y R
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1408 @kindex 1711 @kbd{y R}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1409 Expand current region and yank it.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1410 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1411
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1412 @node Put Back Commands, Change Commands, Yank Commands, Modifying Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1413 @subsection Put Back Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1414 Deleted or yanked texts can be put back into the buffer by the command
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1415 below.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1416
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1417 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1418 @item p
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1419 @kindex 160 @kbd{p} (@code{vip-put-back})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1420 Insert, after the character point is looking at, most recently
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1421 deleted/yanked text from anonymous register. Given a register name
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1422 argument, the content of the named register will be put back. Given a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1423 count, the command will be repeated that many times. This command also
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1424 checks if the text to put back ends with a new line character, and if so
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1425 the text will be put below the current line (@code{vip-put-back}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1426 @item P
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1427 @kindex 120 @kbd{P} (@code{vip-Put-back})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1428 Insert at point most recently deleted/yanked text from anonymous register.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1429 Given a register name argument, the content of the named register will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1430 be put back. Given a count, the command will be repeated that many times.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1431 This command also checks if the text to put back ends with a new line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1432 character, and if so the text will be put above the current line rather
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1433 than at point (@code{vip-Put-back}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1434 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1435 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1436 @cindex number register
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1437 Thus, @kbd{" c p} will put back the content of the register @kbd{c} into the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1438 buffer. It is also possible to specify @dfn{number register} which is a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1439 numeral between @kbd{1} and @kbd{9}. If the number register @var{n} is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1440 specified, @var{n}-th previously deleted/yanked text will be put back. It
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1441 is an error to specify a number register for the delete/yank commands.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1442
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1443 @node Change Commands, Repeating and Undoing Modifications, Put Back Commands, Modifying Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1444 @subsection Change Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1445
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1446 Most commonly used change command takes the following form.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1447
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1448 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1449 @item c @var{motion-command}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1450 @kindex 1430 @kbd{c} (@code{vip-command-argument})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1451 Replace the content of the region determined by the motion command
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1452 @var{motion-command} by the text you type. If the motion command is a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1453 point command then you will type the text into minibuffer, and if the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1454 motion command is a line command then the region will be deleted first and
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1455 you can insert the text in @var{insert mode}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1456 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1457 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1458 For example, if point is at the beginning of a word @samp{foo} and you
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1459 wish to change it to @samp{bar}, you can type @kbd{c w}. Then, as @kbd{w}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1460 is a point command, you will get the prompt @samp{foo =>} in the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1461 minibuffer, for which you can type @kbd{b a r @key{RET}} to complete the change
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1462 command.@refill
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1463
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1464 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1465 @item c c
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1466 @kindex 1432 @kbd{c c}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1467 Change a line. Given a count, that many lines are changed.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1468 @item c r
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1469 @kindex 1432 @kbd{c r}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1470 Change current region.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1471 @item c R
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1472 @kindex 1431 @kbd{c R}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1473 Expand current region and change it.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1474 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1475
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1476 @node Repeating and Undoing Modifications, Other Vi Commands, Change Commands, Modifying Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1477 @subsection Repeating and Undoing Modifications
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1478
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1479 VIP records the previous modifying command, so that it is easy to repeat
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1480 it. It is also very easy to undo changes made by modifying commands.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1481
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1482 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1483 @item u
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1484 @kindex 165 @kbd{u} (@code{vip-undo})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1485 Undo the last change. You can undo more by repeating undo by the repeat
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1486 command @samp{.}. For example, you can undo 5 previous changes by typing
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1487 @samp{u....}. If you type @samp{uu}, then the second @samp{u} undoes the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1488 first undo command (@code{vip-undo}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1489 @item .
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1490 @kindex 056 @kbd{.} (@code{vip-repeat})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1491 Repeat the last modifying command. Given count @var{n} it becomes the new
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1492 count for the repeated command. Otherwise, the count for the last
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1493 modifying command is used again (@code{vip-repeat}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1494 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1495
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1496 @node Other Vi Commands, Commands in Insert Mode, Repeating and Undoing Modifications, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1497 @section Other Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1498
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1499 Miscellaneous Vi commands are collected here.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1500
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1501 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1502 @item Z Z
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1503 @kindex 132 @kbd{Z Z} (@code{save-buffers-kill-emacs})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1504 Exit Emacs. If modified buffers exist, you will be asked whether you wish
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1505 to save them or not (@code{save-buffers-kill-emacs}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1506 @item !@: @var{motion-command} @var{format-command}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1507 @itemx @var{n} !@: !@: @var{format-command}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1508 @kindex 041 @kbd{!} (@code{vip-command-argument})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1509 The region determined by the motion command @var{motion-command} will be
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1510 given to the shell command @var{format-command} and the region will be
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1511 replaced by its output. If a count is given, it will be passed to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1512 @var{motion-command}. For example, @samp{3!Gsort} will sort the region
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1513 between point and the 3rd line. If @kbd{!} is used instead of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1514 @var{motion-command} then @var{n} lines will be processed by
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1515 @var{format-command} (@code{vip-command-argument}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1516 @item J
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1517 @kindex 112 @kbd{J} (@code{vip-join-lines})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1518 Join two lines. Given count, join that many lines. A space will be
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1519 inserted at each junction (@code{vip-join-lines}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1520 @item < @var{motion-command}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1521 @itemx @var{n} < <
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1522 @kindex 074 @kbd{<} (@code{vip-command-argument})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1523 Shift region determined by the motion command @var{motion-command} to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1524 left by @var{shift-width} (default is 8). If @kbd{<} is used instead of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1525 @var{motion-command} then shift @var{n} lines
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1526 @*(@code{vip-command-argument}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1527 @item > @var{motion-command}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1528 @itemx @var{n} > >
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1529 @kindex 076 @kbd{>} (@code{vip-command-argument})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1530 Shift region determined by the motion command @var{motion-command} to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1531 right by @var{shift-width} (default is 8). If @kbd{<} is used instead of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1532 @var{motion-command} then shift @var{n} lines
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1533 @*(@code{vip-command-argument}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1534 @item = @var{motion-command}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1535 @kindex 075 @kbd{=} (@code{vip-command-argument})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1536 Indent region determined by the motion command @var{motion-command}. If
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1537 @kbd{=} is used instead of @var{motion-command} then indent @var{n} lines
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1538 (@code{vip-command-argument}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1539 @item *
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1540 @kindex 052 @kbd{*} (@code{vip-call-last-kbd-macro})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1541 Call last remembered keyboard macro.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1542 @item #
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1543 A new vi operator. @xref{New Commands}, for more details.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1544 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1545
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1546 The following keys are reserved for future extensions, and currently
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1547 assigned to a function that just beeps (@code{vip-nil}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1548
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1549 @kindex 046 @kbd{&} (@code{vip-nil})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1550 @kindex 100 @kbd{@@} (@code{vip-nil})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1551 @kindex 125 @kbd{U} (@code{vip-nil})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1552 @kindex 133 @kbd{[} (@code{vip-nil})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1553 @kindex 135 @kbd{]} (@code{vip-nil})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1554 @kindex 137 @kbd{_} (@code{vip-nil})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1555 @kindex 161 @kbd{q} (@code{vip-nil})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1556 @kindex 176 @kbd{~} (@code{vip-nil})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1557
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1558 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1559 &, @@, U, [, ], _, q, ~
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1560 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1561
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1562 VIP uses a special local keymap to interpret key strokes you enter in vi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1563 mode. The following keys are bound to @var{nil} in the keymap. Therefore,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1564 these keys are interpreted by the global keymap of Emacs. We give below a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1565 short description of the functions bound to these keys in the global
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1566 keymap. See GNU Emacs Manual for details.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1567
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1568 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1569 @item C-@@
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1570 @kindex 000 @kbd{C-@@} (@code{set-mark-command})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1571 Set mark and push previous mark on mark ring (@code{set-mark-command}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1572 @item TAB
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1573 @kindex 011 TAB (@code{indent-for-tab-command})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1574 Indent line for current major mode (@code{indent-for-tab-command}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1575 @item C-j
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1576 @kindex 012 @kbd{C-j} (@code{newline-and-indent})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1577 Insert a newline, then indent according to mode (@code{newline-and-indent}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1578 @item C-k
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1579 @kindex 013 @kbd{C-k} (@code{kill-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1580 Kill the rest of the current line; before a newline, kill the newline.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1581 With a numeric argument, kill that many lines from point. Negative arguments
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1582 kill lines backward (@code{kill-line}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1583 @item C-l
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1584 @kindex 014 @kbd{C-l} (@code{recenter})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1585 Clear the screen and reprint everything (@code{recenter}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1586 @item @var{n} C-p
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1587 @kindex 020 @kbd{C-p} (@code{previous-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1588 Move cursor vertically up @var{n} lines (@code{previous-line}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1589 @item C-q
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1590 @kindex 021 @kbd{C-q} (@code{quoted-insert})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1591 Read next input character and insert it. Useful for inserting control
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1592 characters
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1593 @*(@code{quoted-insert}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1594 @item C-r
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1595 @kindex 022 @kbd{C-r} (@code{isearch-backward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1596 Search backward incrementally (@code{isearch-backward}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1597 @item C-s
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1598 @kindex 023 @kbd{C-s} (@code{isearch-forward})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1599 Search forward incrementally (@code{isearch-forward}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1600 @item @var{n} C-t
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1601 @kindex 024 @kbd{C-t} (@code{transpose-chars})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1602 Interchange characters around point, moving forward one character. With
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1603 count @var{n}, take character before point and drag it forward past @var{n}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1604 other characters. If no argument and at end of line, the previous two
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1605 characters are exchanged (@code{transpose-chars}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1606 @item @var{n} C-v
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1607 @kindex 026 @kbd{C-v} (@code{scroll-up})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1608 Scroll text upward @var{n} lines. If @var{n} is not given, scroll near
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1609 full screen (@code{scroll-up}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1610 @item C-w
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1611 @kindex 027 @kbd{C-w} (@code{kill-region})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1612 Kill between point and mark. The text is save in the kill ring. The
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1613 command @kbd{P} or @kbd{p} can retrieve it from kill ring
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1614 (@code{kill-region}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1615 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1616
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1617 @node Commands in Insert Mode, Ex Commands, Other Vi Commands, Vi Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1618 @section Insert Mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1619
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1620 You can enter insert mode by one of the following commands. In addition to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1621 these, you will enter insert mode if you give a change command with a line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1622 command as the motion command. Insert commands are also modifying commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1623 and you can repeat them by the repeat command @kbd{.} (@code{vip-repeat}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1624
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1625 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1626 @item i
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1627 @kindex 151 @kbd{i} (@code{vip-insert})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1628 Enter insert mode at point (@code{vip-insert}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1629 @item I
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1630 @kindex 111 @kbd{I} (@code{vip-Insert})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1631 Enter insert mode at the first non white character on the line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1632 (@code{vip-Insert}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1633 @item a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1634 @kindex 141 @kbd{a} (@code{vip-append})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1635 Move point forward by one character and then enter insert mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1636 (@code{vip-append}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1637 @item A
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1638 @kindex 101 @kbd{A} (@code{vip-Append})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1639 Enter insert mode at end of line (@code{vip-Append}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1640 @item o
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1641 @kindex 157 @kbd{o} (@code{vip-open-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1642 Open a new line below the current line and enter insert mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1643 (@code{vip-open-line}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1644 @item O
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1645 @kindex 117 @kbd{O} (@code{vip-Open-line})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1646 Open a new line above the current line and enter insert mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1647 (@code{vip-Open-line}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1648 @item C-o
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1649 @kindex 017 @kbd{C-o} (@code{vip-open-line-at-point})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1650 Insert a newline and leave point before it, and then enter insert mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1651 @*(@code{vip-open-line-at-point}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1652 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1653
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1654 Insert mode is almost like emacs mode. Only the following 4 keys behave
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1655 differently from emacs mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1656
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1657 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1658 @item @key{ESC}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1659 @kindex 033 @kbd{ESC} (@code{vip-change-mode-to-vi}) (insert mode)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1660 This key will take you back to vi mode (@code{vip-change-mode-to-vi}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1661 @item C-h
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1662 @kindex 010 @kbd{C-h} (@code{delete-backward-char}) (insert mode)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1663 Delete previous character (@code{delete-backward-char}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1664 @item C-w
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1665 @kindex 027 @kbd{C-w} (@code{vip-delete-backward-word}) (insert mode)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1666 Delete previous word (@code{vip-delete-backward-word}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1667 @item C-z
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1668 @kindex 032 @kbd{C-z} (@code{vip-ESC}) (insert mode)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1669 This key simulates @key{ESC} key in emacs mode. For instance, typing
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1670 @kbd{C-z x} in insert mode is the same as typing @kbd{ESC x} in emacs mode
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1671 (@code{vip-ESC}).
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1672 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1673 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1674 You can also bind @kbd{C-h} to @code{help-command} if you like.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1675 (@xref{Customizing Key Bindings}, for details.) Binding @kbd{C-h} to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1676 @code{help-command} has the effect of making the meaning of @kbd{C-h}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1677 uniform among emacs, vi and insert modes.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1678
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1679 When you enter insert mode, VIP records point as the start point of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1680 insertion, and when you leave insert mode the region between point and
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1681 start point is saved for later use by repeat command etc. Therefore, repeat
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1682 command will not really repeat insertion if you move point by emacs
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1683 commands while in insert mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1684
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1685 @node Ex Commands, Ex Command Reference, Commands in Insert Mode, Top
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1686 @chapter Ex Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1687
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1688 @kindex 072 @kbd{:} (@code{vip-ex})
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1689
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1690 In vi mode, you can execute an Ex command @var{ex-command} by typing:
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1691 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1692 @kbd{:@: @var{ex-command} @key{RET}}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1693 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1694 Every Ex command follows the following pattern:
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1695 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1696 @var{address command} @kbd{!}@: @var{parameters count flags}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1697 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1698 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1699 @cindex address
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1700 where all parts are optional. For the syntax of @dfn{address}, the reader
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1701 is referred to the reference manual of Ex.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1702
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1703 @cindex magic
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1704 @cindex regular expression
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1705
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1706 In the current version of VIP, searching by Ex commands is always
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1707 @dfn{magic}. That is, search patterns are always treated as @dfn{regular
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1708 expressions}. For example, a typical forward search would be invoked by
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1709 @kbd{:/@var{pat}/}. If you wish to include @samp{/} as part of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1710 @var{pat} you must preceded it by @samp{\}. VIP strips off these @kbd{\}'s
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1711 before @kbd{/} and the resulting @var{pat} becomes the actual search
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1712 pattern. Emacs provides a different and richer class or regular
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1713 expressions than Vi/Ex, and VIP uses Emacs' regular expressions. See GNU
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1714 Emacs Manual for details of regular expressions.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1715
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1716 Several Ex commands can be entered in a line by separating them by a pipe
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1717 character @samp{|}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1718
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1719 @menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1720 * Ex Command Reference:: Explain all the Ex commands available in VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1721 @end menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1722 @node Ex Command Reference, Customization, Ex Commands, Ex Commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1723 @section Ex Command Reference
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1724 In this section we briefly explain all the Ex commands supported by VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1725 Most Ex commands expect @var{address} as their argument, and they use
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1726 default addresses if they are not explicitly given. In the following, such
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1727 default addresses will be shown in parentheses.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1728
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1729 Most command names can and preferably be given in abbreviated forms. In
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1730 the following, optional parts of command names will be enclosed in
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1731 brackets. For example, @samp{co[py]} will mean that copy command can be
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1732 give as @samp{co} or @samp{cop} or @samp{copy}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1733
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1734 If @var{command} is empty, point will move to the beginning of the line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1735 specified by the @var{address}. If @var{address} is also empty, point will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1736 move to the beginning of the current line.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1737
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1738 @cindex flag
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1739
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1740 Some commands accept @dfn{flags} which are one of @kbd{p}, @kbd{l} and
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1741 @kbd{#}. If @var{flags} are given, the text affected by the commands will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1742 be displayed on a temporary window, and you will be asked to hit return to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1743 continue. In this way, you can see the text affected by the commands
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1744 before the commands will be executed. If you hit @kbd{C-g} instead of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1745 @key{RET} then the commands will be aborted. Note that the meaning of
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1746 @var{flags} is different in VIP from that in Vi/Ex.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1747
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1748 @table @kbd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1749 @item (.,.@:) co[py] @var{addr} @var{flags}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1750 @itemx (.,.@:) t @var{addr} @var{flags}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1751 Place a copy of specified lines after @var{addr}. If @var{addr} is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1752 @kbd{0}, it will be placed before the first line.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1753 @item (.,.@:) d[elete] @var{register} @var{count} @var{flags}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1754 Delete specified lines. Text will be saved in a named @var{register} if a
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1755 lower-case letter is given, and appended to a register if a capital letter is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1756 given.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1757 @item e[dit] !@: +@var{addr} @var{file}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1758 @itemx e[x] !@: +@var{addr} @var{file}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1759 @itemx vi[sual] !@: +@var{addr} @var{file}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1760 Edit a new file @var{file} in the current window. The command will abort
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1761 if current buffer is modified, which you can override by giving @kbd{!}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1762 If @kbd{+}@var{addr} is given, @var{addr} becomes the current line.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1763 @item file
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1764 Give information about the current file.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1765 @item (1,$) g[lobal] !@: /@var{pat}/ @var{cmds}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1766 @itemx (1,$) v /@var{pat}/ @var{cmds}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1767 Among specified lines first mark each line which matches the regular
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1768 expression @var{pat}, and then execute @var{cmds} on each marked line.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1769 If @kbd{!}@: is given, @var{cmds} will be executed on each line not matching
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1770 @var{pat}. @kbd{v} is same as @kbd{g!}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1771 @item (.,.+1) j[oin] !@: @var{count} @var{flags}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1772 Join specified lines into a line. Without @kbd{!}, a space character will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1773 be inserted at each junction.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1774 @item (.@:) k @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1775 @itemx (.@:) mar[k] @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1776 Mark specified line by a lower-case character @var{ch}. Then the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1777 addressing form @kbd{'}@var{ch} will refer to this line. No white space is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1778 required between @kbd{k} and @var{ch}. A white space is necessary between
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1779 @kbd{mark} and @var{ch}, however.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1780 @item map @var{ch} @var{rhs}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1781 Define a macro for vi mode. After this command, the character @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1782 will be expanded to @var{rhs} in vi mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1783 @item (.,.@:) m[ove] @var{addr}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1784 Move specified lines after @var{addr}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1785 @item (.@:) pu[t] @var{register}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1786 Put back previously deleted or yanked text. If @var{register} is given,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1787 the text saved in the register will be put back; otherwise, last deleted or
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1788 yanked text will be put back.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1789 @item q[uit] !
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1790 Quit from Emacs. If modified buffers with associated files exist, you will
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1791 be asked whether you wish to save each of them. At this point, you may
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1792 choose not to quit, by hitting @kbd{C-g}. If @kbd{!}@: is given, exit from
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1793 Emacs without saving modified buffers.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1794 @item (.@:) r[ead] @var{file}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1795 Read in the content of the file @var{file} after the specified line.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1796 @item (.@:) r[ead] !@: @var{command}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1797 Read in the output of the shell command @var{command} after the specified
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1798 line.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1799 @item se[t]
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1800 Set a variable's value. @xref{Customizing Constants}, for the list of variables
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1801 you can set.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1802 @item sh[ell]
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1803 Run a subshell in a window.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1804 @item (.,.@:) s[ubstitute] /@var{pat}/@var{repl}/ @var{options} @var{count} @var{flags}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1805 @itemx (.,.@:) & @var{options} @var{count} @var{flags}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1806 On each specified line, the first occurrence of string matching regular
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1807 expression @var{pat} is replaced by replacement pattern @var{repl}. Option
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1808 characters are @kbd{g} and @kbd{c}. If global option character @kbd{g}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1809 appears as part of @var{options}, all occurrences are substituted. If
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1810 confirm option character @kbd{c} appears, you will be asked to give
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1811 confirmation before each substitution. If @kbd{/@var{pat}/@var{repl}/} is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1812 missing, the last substitution is repeated.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1813 @item st[op]
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1814 Suspend Emacs.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1815 @item ta[g] @var{tag}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1816 @cindex tag
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1817 @cindex selected tags table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1818 Find first definition of @var{tag}. If no @var{tag} is given, previously
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1819 given @var{tag} is used and next alternate definition is find. By default,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1820 the file @file{TAGS} in the current directory becomes the @dfn{selected tags
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1821 table}. You can select another tags table by @kbd{set} command.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1822 @xref{Customizing Constants}, for details.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1823 @item und[o]
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1824 Undo the last change.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1825 @item unm[ap] @var{ch}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1826 The macro expansion associated with @var{ch} is removed.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1827 @item ve[rsion]
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1828 Tell the version number of VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1829 @item (1,$) w[rite] !@: @var{file}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1830 Write out specified lines into file @var{file}. If no @var{file} is given,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1831 text will be written to the file associated to the current buffer. Unless
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1832 @kbd{!}@: is given, if @var{file} is different from the file associated to
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1833 the current buffer and if the file @var{file} exists, the command will not
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1834 be executed. Unlike Ex, @var{file} becomes the file associated to the
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1835 current buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1836 @item (1,$) w[rite]>> @var{file}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1837 Write out specified lines at the end of file @var{file}. @var{file}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1838 becomes the file associated to the current buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1839 @item (1,$) wq !@: @var{file}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1840 Same as @kbd{write} and then @kbd{quit}. If @kbd{!}@: is given, same as
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1841 @kbd{write !}@: then @kbd{quit}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1842 @item (.,.) y[ank] @var{register} @var{count}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1843 Save specified lines into register @var{register}. If no register is
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1844 specified, text will be saved in an anonymous register.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1845 @item @var{addr} !@: @var{command}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1846 Execute shell command @var{command}. The output will be shown in a new
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1847 window. If @var{addr} is given, specified lines will be used as standard
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1848 input to @var{command}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1849 @item ($) =
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1850 Print the line number of the addressed line.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1851 @item (.,.) > @var{count} @var{flags}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1852 Shift specified lines to the right. The variable @code{vip-shift-width}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1853 (default value is 8) determines the amount of shift.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1854 @item (.,.) < @var{count} @var{flags}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1855 Shift specified lines to the left. The variable @code{vip-shift-width}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1856 (default value is 8) determines the amount of shift.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1857 @item (.,.@:) ~ @var{options} @var{count} @var{flags}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1858 Repeat the previous @kbd{substitute} command using previous search pattern
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1859 as @var{pat} for matching.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1860 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1861
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1862 The following Ex commands are available in Vi, but not implemented in VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1863 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1864 @kbd{abbreviate}, @kbd{list}, @kbd{next}, @kbd{print}, @kbd{preserve}, @kbd{recover}, @kbd{rewind}, @kbd{source},
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1865 @kbd{unabbreviate}, @kbd{xit}, @kbd{z}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1866 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1867
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1868 @node Customization, Customizing Constants, Ex Command Reference, Top
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1869 @chapter Customization
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1870
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1871 If you have a file called @file{.vip} in your home directory, then it
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1872 will also be loaded when VIP is loaded. This file is thus useful for
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1873 customizing VIP.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1874
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1875 @menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1876 * Customizing Constants:: How to change values of constants.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1877 * Customizing Key Bindings:: How to change key bindings.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1878 @end menu
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1879
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1880 @node Customizing Constants, Customizing Key Bindings, Customization, Customization
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1881 @section Customizing Constants
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1882 An easy way to customize VIP is to change the values of constants used
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1883 in VIP. Here is the list of the constants used in VIP and their default
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1884 values.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1885
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1886 @table @code
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1887 @item vip-shift-width 8
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1888 The number of columns shifted by @kbd{>} and @kbd{<} command.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1889 @item vip-re-replace nil
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1890 If @code{t} then do regexp replace, if @code{nil} then do string replace.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1891 @item vip-search-wrap-around t
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1892 If @code{t}, search wraps around the buffer.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1893 @item vip-re-search nil
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1894 If @code{t} then search is reg-exp search, if @code{nil} then vanilla
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1895 search.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1896 @item vip-case-fold-search nil
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1897 If @code{t} search ignores cases.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1898 @item vip-re-query-replace nil
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1899 If @code{t} then do reg-exp replace in query replace.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1900 @item vip-open-with-indent nil
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1901 If @code{t} then indent to the previous current line when open a new line
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1902 by @kbd{o} or @kbd{O} command.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1903 @item vip-tags-file-name "TAGS"
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1904 The name of the file used as the tags table.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1905 @item vip-help-in-insert-mode nil
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1906 If @code{t} then @key{C-h} is bound to @code{help-command} in insert mode,
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1907 if @code{nil} then it sis bound to @code{delete-backward-char}.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1908 @end table
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1909 @noindent
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1910 You can reset these constants in VIP by the Ex command @kbd{set}. Or you
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1911 can include a line like this in your @file{.vip} file:
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1912 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1913 (setq vip-case-fold-search t)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1914 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1915
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1916 @node Customizing Key Bindings,, Customizing Constants, Customization
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1917 @section Customizing Key Bindings
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1918
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1919 @cindex local keymap
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1920
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1921 VIP uses @code{vip-command-mode-map} as the @dfn{local keymap} for vi mode.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1922 For example, in vi mode, @key{SPC} is bound to the function
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1923 @code{vip-scroll}. But, if you wish to make @key{SPC} and some other keys
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1924 behave like Vi, you can include the following lines in your @file{.vip}
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1925 file.
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1926
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1927 @example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1928 (define-key vip-command-mode-map "\C-g" 'vip-info-on-file)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1929 (define-key vip-command-mode-map "\C-h" 'vip-backward-char)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1930 (define-key vip-command-mode-map "\C-m" 'vip-next-line-at-bol)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1931 (define-key vip-command-mode-map " " 'vip-forward-char)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1932 (define-key vip-command-mode-map "g" 'vip-keyboard-quit)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1933 (define-key vip-command-mode-map "s" 'vip-substitute)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1934 (define-key vip-command-mode-map "C" 'vip-change-to-eol)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1935 (define-key vip-command-mode-map "R" 'vip-change-to-eol)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1936 (define-key vip-command-mode-map "S" 'vip-substitute-line)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1937 (define-key vip-command-mode-map "X" 'vip-delete-backward-char)
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1938 @end example
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1939
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1940 @node GNU Free Documentation License,,, Top
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1941 @appendix GNU Free Documentation License
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1942 @include doclicense.texi
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1943
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1944
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1945 @unnumbered Key Index
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1946
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1947 @printindex ky
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1948
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1949 @unnumbered Concept Index
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1950 @printindex cp
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1951
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1952 @setchapternewpage odd
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1953 @contents
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1954 @bye
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1955
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1956 @ignore
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1957 arch-tag: 7c5d17b9-1d21-4261-a88a-b9fdbbf1020b
299931d27e45 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1958 @end ignore