 |  |
| |
The philosophy of this handbook is to give you a good overview of what we feel are vi survival materials for the new user. Learning a new editor, especially an editor with all the options of vi, can seem like an overwhelming task. We have made an effort to present basic concepts and commands in an easy-to-read and logical manner. The following sections describe the conventions used in this handbook.
A picture of a keyboard button, like the one on the left,
marks the main discussion of that particular keyboard
command or of related commands.
You will find a brief introduction to the main concept before it is
broken down into task-oriented sections.
We then present
the appropriate command to use in each case, along
with a description of the command and the proper syntax for
using it.
In syntax descriptions and examples, what you would actually type is shown in the Courier font, as are all command names. Variables (which you would not type literally, but would replace with an actual value when you typed the command) are shown in Courier Italic. Brackets indicate that a variable is optional. For example, in the syntax line:
vi [filename]
filename would be replaced by an actual filename. The brackets indicate that the vi command can be invoked without specifying a filename at all. The brackets themselves are not typed.
Certain examples show the effect of commands typed at the UNIX shell prompt. In such examples, what you actually type is shown in Courier Bold to distinguish it from the system response. For example:
$ ls ch01.sgm ch02.sgm ch03.sgm ch04.sgm
In examples, italic indicates a comment which is not to be typed. Otherwise, italic emphasizes special terms and indicate the names of files.
Special keystrokes are shown in a grey box. For example:
iWith a ESCThroughout the book, you will also find columns of vi commands and their results:
| Keystrokes | Results |
|---|---|
| ZZ |  Give the write and save command, ZZ. Your file is saved as a regular UNIX file. |
In the example above, the command ZZ is shown in the left column. In the window to the right is a line (or several lines) of the screen that show the result of the command. Cursor position is shown by an underscore. In this instance, since ZZ saves and writes the file, you see the status line shown when a file is written; the cursor position is not shown. Below the window is an explanation of the command and its result.
Sometimes vi commands are issued by pressing the CTRL key and another key simultaneously. In the text, this combination keystroke is written within a box (for example, CTRL-G). In examples, it is written by preceding the name of the key with a caret (^). For example, ^G means to hold down CTRL while pressing the G key.
A problem checklist is included in those sections where you may run into some trouble. You can skim these checklists and go back to them when you actually encounter a problem. All of the problem checklists are also collected in Appendix D, for ease of reference.
|  | |
| Preface |  | 0.3. What You Need to Know Before Starting |
Copyright © 2003 O'Reilly & Associates. All rights reserved.