annotate runtime/doc/vim.1 @ 23396:b9d94953d3e6 v8.2.2241

patch 8.2.2241: Build with Ruby and clang may fail Commit: https://github.com/vim/vim/commit/864a28b6a6ae4f1a56e230be26bc6d13e3f8b3d9 Author: Bram Moolenaar <Bram@vim.org> Date: Mon Dec 28 21:36:56 2020 +0100 patch 8.2.2241: Build with Ruby and clang may fail Problem: Build with Ruby and clang may fail. Solution: Adjust congigure and sed script. (Ozaki Kiichi, closes https://github.com/vim/vim/issues/7566)
author Bram Moolenaar <Bram@vim.org>
date Mon, 28 Dec 2020 21:45:04 +0100
parents 8dad79c661d1
children 9f41bfdbc6fc
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
826
1cdd2661f34c updated for version 7.0d01
vimboss
parents: 810
diff changeset
1 .TH VIM 1 "2006 Apr 11"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2 .SH NAME
12045
444ad56c0cac Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 8876
diff changeset
3 vim \- Vi IMproved, a programmer's text editor
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 .SH SYNOPSIS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6 .B vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 [options] [file ..]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 .B vim
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
10 [options] \-
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 .B vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 [options] \-t tag
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 .B vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 [options] \-q [errorfile]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 .B ex
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 .B view
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 .B gvim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 .B gview
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 .B evim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 .B eview
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 .B rvim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 .B rview
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 .B rgvim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 .B rgview
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 .SH DESCRIPTION
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 is a text editor that is upwards compatible to Vi.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 It can be used to edit all kinds of plain text.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 It is especially useful for editing programs.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 There are a lot of enhancements above Vi: multi level undo,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 multi windows and buffers, syntax highlighting, command line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 editing, filename completion, on-line help, visual selection, etc..
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 See ":help vi_diff.txt" for a summary of the differences between
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 and Vi.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 While running
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 a lot of help can be obtained from the on-line help system, with the ":help"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 See the ON-LINE HELP section below.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 Most often
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 is started to edit a single file with the command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 vim file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 More generally
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59 is started with:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 vim [options] [filelist]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 If the filelist is missing, the editor will start with an empty buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 Otherwise exactly one out of the following four may be used to choose one or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65 more files to be edited.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66 .TP 12
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67 file ..
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 A list of filenames.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69 The first one will be the current file and read into the buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70 The cursor will be positioned on the first line of the buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 You can get to the other files with the ":next" command.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
72 To edit a file that starts with a dash, precede the filelist with "\-\-".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
74 \-
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 The file to edit is read from stdin. Commands are read from stderr, which
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76 should be a tty.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
78 \-t {tag}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 The file to edit and the initial cursor position depends on a "tag", a sort
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 of goto label.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 {tag} is looked up in the tags file, the associated file becomes the current
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 file and the associated command is executed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 Mostly this is used for C programs, in which case {tag} could be a function
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84 name.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 The effect is that the file containing that function becomes the current file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86 and the cursor is positioned on the start of the function.
810
9f345c48220b updated for version 7.0c
vimboss
parents: 802
diff changeset
87 See ":help tag\-commands".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
89 \-q [errorfile]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90 Start in quickFix mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91 The file [errorfile] is read and the first error is displayed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92 If [errorfile] is omitted, the filename is obtained from the 'errorfile'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 option (defaults to "AztecC.Err" for the Amiga, "errors.err" on other
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94 systems).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 Further errors can be jumped to with the ":cn" command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96 See ":help quickfix".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99 behaves differently, depending on the name of the command (the executable may
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100 still be the same file).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 .TP 10
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102 vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 The "normal" way, everything is default.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 ex
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106 Start in Ex mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 Go to Normal mode with the ":vi" command.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
108 Can also be done with the "\-e" argument.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110 view
14298
4a588e3afd4a Update runtime files, add Danish translations.
Christian Brabandt <cb@256bit.org>
parents: 12559
diff changeset
111 Start in read-only mode. You will be protected from writing the files.
4a588e3afd4a Update runtime files, add Danish translations.
Christian Brabandt <cb@256bit.org>
parents: 12559
diff changeset
112 Can also be done with the "\-R" argument.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114 gvim gview
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115 The GUI version.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116 Starts a new window.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
117 Can also be done with the "\-g" argument.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119 evim eview
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120 The GUI version in easy mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121 Starts a new window.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
122 Can also be done with the "\-y" argument.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124 rvim rview rgvim rgview
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 Like the above, but with restrictions. It will not be possible to start shell
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
126 commands, or suspend
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 .B Vim.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
128 Can also be done with the "\-Z" argument.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 .SH OPTIONS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130 The options may be given in any order, before or after filenames.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 Options without an argument can be combined after a single dash.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 .TP 12
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
133 +[num]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134 For the first file the cursor will be positioned on line "num".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
135 If "num" is missing, the cursor will be positioned on the last line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
136 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
137 +/{pat}
6530
435956324539 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 1698
diff changeset
138 For the first file the cursor will be positioned in the line with the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
139 first occurrence of {pat}.
810
9f345c48220b updated for version 7.0c
vimboss
parents: 802
diff changeset
140 See ":help search\-pattern" for the available search patterns.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
141 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
142 +{command}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
143 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
144 \-c {command}
14298
4a588e3afd4a Update runtime files, add Danish translations.
Christian Brabandt <cb@256bit.org>
parents: 12559
diff changeset
145 {command} will be executed after the first file has been read.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
146 {command} is interpreted as an Ex command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
147 If the {command} contains spaces it must be enclosed in double quotes (this
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
148 depends on the shell that is used).
21499
3a1ed539ae2a Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 17758
diff changeset
149 Example: vim "+set si" main.c
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
150 .br
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
151 Note: You can use up to 10 "+" or "\-c" commands.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
152 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
153 \-S {file}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
154 {file} will be sourced after the first file has been read.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
155 This is equivalent to \-c "source {file}".
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
156 {file} cannot start with '\-'.
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
157 If {file} is omitted "Session.vim" is used (only works when \-S is the last
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
158 argument).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
160 \-\-cmd {command}
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
161 Like using "\-c", but the command is executed just before
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162 processing any vimrc file.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
163 You can use up to 10 of these commands, independently from "\-c" commands.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
164 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
165 \-A
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
166 If
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168 has been compiled with ARABIC support for editing right-to-left
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
169 oriented files and Arabic keyboard mapping, this option starts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171 in Arabic mode, i.e. 'arabic' is set. Otherwise an error
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
172 message is given and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
173 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
174 aborts.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
175 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
176 \-b
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
177 Binary mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
178 A few options will be set that makes it possible to edit a binary or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
179 executable file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
180 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
181 \-C
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
182 Compatible. Set the 'compatible' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
183 This will make
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
184 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
185 behave mostly like Vi, even though a .vimrc file exists.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
186 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
187 \-d
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
188 Start in diff mode.
1698
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 826
diff changeset
189 There should be two, three or four file name arguments.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
190 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
191 will open all the files and show differences between them.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
192 Works like vimdiff(1).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
193 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
194 \-d {device}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
195 Open {device} for use as a terminal.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
196 Only on the Amiga.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
197 Example:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
198 "\-d con:20/30/600/150".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
199 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
200 \-D
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
201 Debugging. Go to debugging mode when executing the first command from a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
202 script.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
203 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
204 \-e
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
205 Start
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
206 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
207 in Ex mode, just like the executable was called "ex".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
208 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
209 \-E
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
210 Start
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
211 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
212 in improved Ex mode, just like the executable was called "exim".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
213 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
214 \-f
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
215 Foreground. For the GUI version,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
216 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
217 will not fork and detach from the shell it was started in.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
218 On the Amiga,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
219 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
220 is not restarted to open a new window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
221 This option should be used when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
222 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
223 is executed by a program that will wait for the edit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
224 session to finish (e.g. mail).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
225 On the Amiga the ":sh" and ":!" commands will not work.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
226 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
227 \-\-nofork
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
228 Foreground. For the GUI version,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
229 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
230 will not fork and detach from the shell it was started in.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
231 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
232 \-F
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
233 If
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
234 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
235 has been compiled with FKMAP support for editing right-to-left
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
236 oriented files and Farsi keyboard mapping, this option starts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
237 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
238 in Farsi mode, i.e. 'fkmap' and 'rightleft' are set.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
239 Otherwise an error message is given and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
240 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
241 aborts.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
242 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
243 \-g
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
244 If
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
245 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
246 has been compiled with GUI support, this option enables the GUI.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
247 If no GUI support was compiled in, an error message is given and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
248 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
249 aborts.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
250 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
251 \-h
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
252 Give a bit of help about the command line arguments and options.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
253 After this
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
254 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
255 exits.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
256 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
257 \-H
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
258 If
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
259 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
260 has been compiled with RIGHTLEFT support for editing right-to-left
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
261 oriented files and Hebrew keyboard mapping, this option starts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
262 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
263 in Hebrew mode, i.e. 'hkmap' and 'rightleft' are set.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
264 Otherwise an error message is given and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
265 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
266 aborts.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
267 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
268 \-i {viminfo}
17758
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 14298
diff changeset
269 Specifies the filename to use when reading or writing the viminfo file,
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
270 instead of the default "~/.viminfo".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
271 This can also be used to skip the use of the .viminfo file, by giving the name
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
272 "NONE".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
273 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
274 \-L
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
275 Same as \-r.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
276 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
277 \-l
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
278 Lisp mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
279 Sets the 'lisp' and 'showmatch' options on.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
280 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
281 \-m
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
282 Modifying files is disabled.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
283 Resets the 'write' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
284 You can still modify the buffer, but writing a file is not possible.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
285 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
286 \-M
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
287 Modifications not allowed. The 'modifiable' and 'write' options will be unset,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
288 so that changes are not allowed and files can not be written. Note that these
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
289 options can be set to enable making modifications.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
290 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
291 \-N
17758
f2c2f9126a82 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 14298
diff changeset
292 No-compatible mode. Resets the 'compatible' option.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
293 This will make
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
294 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
295 behave a bit better, but less Vi compatible, even though a .vimrc file does
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
296 not exist.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
297 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
298 \-n
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
299 No swap file will be used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
300 Recovery after a crash will be impossible.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
301 Handy if you want to edit a file on a very slow medium (e.g. floppy).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
302 Can also be done with ":set uc=0".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
303 Can be undone with ":set uc=200".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
304 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
305 \-nb
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
306 Become an editor server for NetBeans. See the docs for details.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
307 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
308 \-o[N]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
309 Open N windows stacked.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
310 When N is omitted, open one window for each file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
311 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
312 \-O[N]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
313 Open N windows side by side.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
314 When N is omitted, open one window for each file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
315 .TP
802
c6245a087950 updated for version 7.0b01
vimboss
parents: 226
diff changeset
316 \-p[N]
c6245a087950 updated for version 7.0b01
vimboss
parents: 226
diff changeset
317 Open N tab pages.
c6245a087950 updated for version 7.0b01
vimboss
parents: 226
diff changeset
318 When N is omitted, open one tab page for each file.
c6245a087950 updated for version 7.0b01
vimboss
parents: 226
diff changeset
319 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
320 \-R
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
321 Read-only mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
322 The 'readonly' option will be set.
8876
47f17f66da3d commit https://github.com/vim/vim/commit/03413f44167c4b5cd0012def9bb331e2518c83cf
Christian Brabandt <cb@256bit.org>
parents: 6530
diff changeset
323 You can still edit the buffer, but will be prevented from accidentally
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
324 overwriting a file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
325 If you do want to overwrite a file, add an exclamation mark to the Ex command,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
326 as in ":w!".
12559
34c8ec888122 Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 12045
diff changeset
327 The \-R option also implies the \-n option (see above).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
328 The 'readonly' option can be reset with ":set noro".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
329 See ":help 'readonly'".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
330 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
331 \-r
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
332 List swap files, with information about using them for recovery.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
333 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
334 \-r {file}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
335 Recovery mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
336 The swap file is used to recover a crashed editing session.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
337 The swap file is a file with the same filename as the text file with ".swp"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
338 appended.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
339 See ":help recovery".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
340 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
341 \-s
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
342 Silent mode. Only when started as "Ex" or when the "\-e" option was given
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
343 before the "\-s" option.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
344 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
345 \-s {scriptin}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
346 The script file {scriptin} is read.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
347 The characters in the file are interpreted as if you had typed them.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
348 The same can be done with the command ":source! {scriptin}".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
349 If the end of the file is reached before the editor exits, further characters
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
350 are read from the keyboard.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
351 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
352 \-T {terminal}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
353 Tells
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
354 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
355 the name of the terminal you are using.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
356 Only required when the automatic way doesn't work.
14298
4a588e3afd4a Update runtime files, add Danish translations.
Christian Brabandt <cb@256bit.org>
parents: 12559
diff changeset
357 Should be a terminal known to
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
358 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
359 (builtin) or defined in the termcap or terminfo file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
360 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
361 \-u {vimrc}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
362 Use the commands in the file {vimrc} for initializations.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
363 All the other initializations are skipped.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
364 Use this to edit a special kind of files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
365 It can also be used to skip all initializations by giving the name "NONE".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
366 See ":help initialization" within vim for more details.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
367 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
368 \-U {gvimrc}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
369 Use the commands in the file {gvimrc} for GUI initializations.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
370 All the other GUI initializations are skipped.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
371 It can also be used to skip all GUI initializations by giving the name "NONE".
810
9f345c48220b updated for version 7.0c
vimboss
parents: 802
diff changeset
372 See ":help gui\-init" within vim for more details.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
373 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
374 \-V[N]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
375 Verbose. Give messages about which files are sourced and for reading and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
376 writing a viminfo file. The optional number N is the value for 'verbose'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
377 Default is 10.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
378 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
379 \-v
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
380 Start
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
381 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
382 in Vi mode, just like the executable was called "vi". This only has effect
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
383 when the executable is called "ex".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
384 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
385 \-w {scriptout}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
386 All the characters that you type are recorded in the file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
387 {scriptout}, until you exit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
388 .B Vim.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
389 This is useful if you want to create a script file to be used with "vim \-s" or
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
390 ":source!".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
391 If the {scriptout} file exists, characters are appended.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
392 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
393 \-W {scriptout}
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
394 Like \-w, but an existing file is overwritten.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
395 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
396 \-x
33
f6033dcbaf31 updated for version 7.0020
vimboss
parents: 7
diff changeset
397 Use encryption when writing files. Will prompt for a crypt key.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
398 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
399 \-X
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
400 Don't connect to the X server. Shortens startup time in a terminal, but the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
401 window title and clipboard will not be used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
402 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
403 \-y
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
404 Start
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
405 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
406 in easy mode, just like the executable was called "evim" or "eview".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
407 Makes
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
408 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
409 behave like a click-and-type editor.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
410 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
411 \-Z
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
412 Restricted mode. Works like the executable starts with "r".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
413 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
414 \-\-
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
415 Denotes the end of the options.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
416 Arguments after this will be handled as a file name.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
417 This can be used to edit a filename that starts with a '\-'.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
418 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
419 \-\-echo\-wid
33
f6033dcbaf31 updated for version 7.0020
vimboss
parents: 7
diff changeset
420 GTK GUI only: Echo the Window ID on stdout.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
421 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
422 \-\-help
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
423 Give a help message and exit, just like "\-h".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
424 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
425 \-\-literal
33
f6033dcbaf31 updated for version 7.0020
vimboss
parents: 7
diff changeset
426 Take file name arguments literally, do not expand wildcards. This has no
f6033dcbaf31 updated for version 7.0020
vimboss
parents: 7
diff changeset
427 effect on Unix where the shell expands wildcards.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
428 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
429 \-\-noplugin
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
430 Skip loading plugins. Implied by \-u NONE.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
431 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
432 \-\-remote
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
433 Connect to a Vim server and make it edit the files given in the rest of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
434 arguments. If no server is found a warning is given and the files are edited
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
435 in the current Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
436 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
437 \-\-remote\-expr {expr}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
438 Connect to a Vim server, evaluate {expr} in it and print the result on stdout.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
439 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
440 \-\-remote\-send {keys}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
441 Connect to a Vim server and send {keys} to it.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
442 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
443 \-\-remote\-silent
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
444 As \-\-remote, but without the warning when no server is found.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
445 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
446 \-\-remote\-wait
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
447 As \-\-remote, but Vim does not exit until the files have been edited.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
448 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
449 \-\-remote\-wait\-silent
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
450 As \-\-remote\-wait, but without the warning when no server is found.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
451 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
452 \-\-serverlist
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
453 List the names of all Vim servers that can be found.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
454 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
455 \-\-servername {name}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
456 Use {name} as the server name. Used for the current Vim, unless used with a
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
457 \-\-remote argument, then it's the name of the server to connect to.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
458 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
459 \-\-socketid {id}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
460 GTK GUI only: Use the GtkPlug mechanism to run gvim in another window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
461 .TP
22824
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21499
diff changeset
462 \-\-startuptime {file}
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21499
diff changeset
463 During startup write timing messages to the file {fname}.
8dad79c661d1 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 21499
diff changeset
464 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
465 \-\-version
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
466 Print version information and exit.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
467 .SH ON-LINE HELP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
468 Type ":help" in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
469 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
470 to get started.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
471 Type ":help subject" to get help on a specific subject.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
472 For example: ":help ZZ" to get help for the "ZZ" command.
810
9f345c48220b updated for version 7.0c
vimboss
parents: 802
diff changeset
473 Use <Tab> and CTRL-D to complete subjects (":help cmdline\-completion").
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
474 Tags are present to jump from one place to another (sort of hypertext links,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
475 see ":help").
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
476 All documentation files can be viewed in this way, for example
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
477 ":help syntax.txt".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
478 .SH FILES
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
479 .TP 15
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
480 /usr/local/lib/vim/doc/*.txt
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
481 The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
482 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
483 documentation files.
216
da182deebec7 updated for version 7.0061
vimboss
parents: 170
diff changeset
484 Use ":help doc\-file\-list" to get the complete list.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
485 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
486 /usr/local/lib/vim/doc/tags
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
487 The tags file used for finding information in the documentation files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
488 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
489 /usr/local/lib/vim/syntax/syntax.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
490 System wide syntax initializations.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
491 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
492 /usr/local/lib/vim/syntax/*.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
493 Syntax files for various languages.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
494 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
495 /usr/local/lib/vim/vimrc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
496 System wide
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
497 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
498 initializations.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
499 .TP
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 33
diff changeset
500 ~/.vimrc
8c60f65311fa updated for version 7.0052
vimboss
parents: 33
diff changeset
501 Your personal
8c60f65311fa updated for version 7.0052
vimboss
parents: 33
diff changeset
502 .B Vim
8c60f65311fa updated for version 7.0052
vimboss
parents: 33
diff changeset
503 initializations.
8c60f65311fa updated for version 7.0052
vimboss
parents: 33
diff changeset
504 .TP
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
505 /usr/local/lib/vim/gvimrc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
506 System wide gvim initializations.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
507 .TP
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 33
diff changeset
508 ~/.gvimrc
8c60f65311fa updated for version 7.0052
vimboss
parents: 33
diff changeset
509 Your personal gvim initializations.
8c60f65311fa updated for version 7.0052
vimboss
parents: 33
diff changeset
510 .TP
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
511 /usr/local/lib/vim/optwin.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
512 Script used for the ":options" command, a nice way to view and set options.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
513 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
514 /usr/local/lib/vim/menu.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
515 System wide menu initializations for gvim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
516 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
517 /usr/local/lib/vim/bugreport.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
518 Script to generate a bug report. See ":help bugs".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
519 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
520 /usr/local/lib/vim/filetype.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
521 Script to detect the type of a file by its name. See ":help 'filetype'".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
522 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
523 /usr/local/lib/vim/scripts.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
524 Script to detect the type of a file by its contents. See ":help 'filetype'".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
525 .TP
1698
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 826
diff changeset
526 /usr/local/lib/vim/print/*.ps
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
527 Files used for PostScript printing.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
528 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
529 For recent info read the VIM home page:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
530 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
531 <URL:http://www.vim.org/>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
532 .SH SEE ALSO
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
533 vimtutor(1)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
534 .SH AUTHOR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
535 Most of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
536 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
537 was made by Bram Moolenaar, with a lot of help from others.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
538 See ":help credits" in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
539 .B Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
540 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
541 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
542 is based on Stevie, worked on by: Tim Thompson,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
543 Tony Andrews and G.R. (Fred) Walter.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
544 Although hardly any of the original code remains.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
545 .SH BUGS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
546 Probably.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
547 See ":help todo" for a list of known problems.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
548 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
549 Note that a number of things that may be regarded as bugs by some, are in fact
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
550 caused by a too-faithful reproduction of Vi's behaviour.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
551 And if you think other things are bugs "because Vi does it differently",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
552 you should take a closer look at the vi_diff.txt file (or type :help
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
553 vi_diff.txt when in Vim).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
554 Also have a look at the 'compatible' and 'cpoptions' options.