diff options
Diffstat (limited to 'runtime/doc/starting.txt')
| -rw-r--r-- | runtime/doc/starting.txt | 81 |
1 files changed, 22 insertions, 59 deletions
diff --git a/runtime/doc/starting.txt b/runtime/doc/starting.txt index a18571b77f..017fba1824 100644 --- a/runtime/doc/starting.txt +++ b/runtime/doc/starting.txt @@ -76,7 +76,6 @@ filename One or more file names. The first one will be the current and the first error is displayed. See |quickfix|. If [errorfile] is not given, the 'errorfile' option is used for the file name. See 'errorfile' for the default value. - {not in Vi} (nothing) Without one of the four items above, Vim will start editing a new buffer. It's empty and doesn't have a file name. @@ -87,17 +86,16 @@ combined after one dash. There can be no option arguments after the "--" argument. --help *-h* *--help* --h Give usage (help) message and exit. {not in Vi} +-h Give usage (help) message and exit. See |info-message| about capturing the text. *--version* --version Print version information and exit. Same output as for - |:version| command. {not in Vi} + |:version| command. See |info-message| about capturing the text. *--noplugin* --noplugin Skip loading plugins. Resets the 'loadplugins' option. - {not in Vi} Note that the |-u| argument may also disable loading plugins: argument load vimrc files load plugins ~ (nothing) yes yes @@ -147,13 +145,11 @@ argument. Note: You can use up to 10 "+" or "-c" arguments in a Vim command. They are executed in the order given. A "-S" argument counts as a "-c" argument as well. - {Vi only allows one command} --cmd {command} *--cmd* {command} will be executed before processing any vimrc file. Otherwise it acts like -c {command}. You can use up to 10 of these commands, independently from "-c" commands. - {not in Vi} *-S* -S {file} The {file} will be sourced after the first file has been read. @@ -162,7 +158,6 @@ argument. < It can be mixed with "-c" arguments and repeated like "-c". The limit of 10 "-c" arguments applies here as well. {file} cannot start with a "-". - {not in Vi} -S Works like "-S Session.vim". Only when used as the last argument or when another "-" option follows. @@ -174,8 +169,7 @@ argument. |crash-recovery|. *-L* --L Same as -r. {only in some versions of Vi: "List recoverable - edit sessions"} +-L Same as -r. *-R* -R Readonly mode. The 'readonly' option will be set for all the @@ -194,7 +188,6 @@ argument. -m Modifications not allowed to be written. The 'write' option will be reset, so that writing files is disabled. However, the 'write' option can be set to enable writing again. - {not in Vi} *-M* -M Modifications not allowed. The 'modifiable' option will be @@ -202,18 +195,15 @@ argument. will be reset, so that writing files is disabled. However, the 'modifiable' and 'write' options can be set to enable changes and writing. - {not in Vi} *-Z* *restricted-mode* *E145* -Z Restricted mode. All commands that make use of an external shell are disabled. This includes suspending with CTRL-Z, ":sh", filtering, the system() function, backtick expansion, delete(), rename(), mkdir(), writefile(), libcall(), etc. - {not in Vi} *-g* -g Start Vim in GUI mode. See |gui|. - {not in Vi} *-e* -e Start Vim in Ex mode |Q|. @@ -250,32 +240,25 @@ argument. option is set to 0. 'modeline' is reset. The 'binary' option is set. This is done after reading the vimrc/exrc files but before reading any file in the arglist. See also - |edit-binary|. {not in Vi} + |edit-binary|. *-l* -l Lisp mode. Sets the 'lisp' and 'showmatch' options on. *-A* --A Arabic mode. Sets the 'arabic' option on. (Only when - compiled with the |+arabic| features (which include - |+rightleft|), otherwise Vim gives an error message - and exits.) {not in Vi} +-A Arabic mode. Sets the 'arabic' option on. *-F* -F Farsi mode. Sets the 'fkmap' and 'rightleft' options on. - (Only when compiled with |+rightleft| and |+farsi| features, - otherwise Vim gives an error message and exits.) {not in Vi} *-H* -H Hebrew mode. Sets the 'hkmap' and 'rightleft' options on. - (Only when compiled with the |+rightleft| feature, otherwise - Vim gives an error message and exits.) {not in Vi} *-V* *verbose* -V[N] Verbose. Sets the 'verbose' option to [N] (default: 10). Messages will be given for each file that is ":source"d and for reading or writing a viminfo file. Can be used to find - out what is happening upon startup and exit. {not in Vi} + out what is happening upon startup and exit. Example: > vim -V8 foobar @@ -290,7 +273,6 @@ argument. -D Debugging. Go to debugging mode when executing the first command from a script. |debug-mode| {not available when compiled without the |+eval| feature} - {not in Vi} *-n* -n No swap file will be used. Recovery after a crash will be @@ -308,7 +290,6 @@ argument. 'updatecount' to very big numbers, and type ":preserve" when you want to save your work. This way you keep the possibility for crash recovery. - {not in Vi} *-o* -o[N] Open N windows, split horizontally. If [N] is not given, @@ -316,13 +297,11 @@ argument. there is not enough room, only the first few files get a window. If there are more windows than arguments, the last few windows will be editing an empty file. - {not in Vi} *-O* -O[N] Open N windows, split vertically. Otherwise it's like -o. If both the -o and the -O option are given, the last one on the command line determines how the windows will be split. - {not in Vi} *-p* -p[N] Open N tab pages. If [N] is not given, one tab page is opened @@ -330,13 +309,12 @@ argument. 'tabpagemax' pages (default 10). If there are more tab pages than arguments, the last few tab pages will be editing an empty file. Also see |tabpage|. - {not in Vi} *-T* -T {terminal} Set the terminal type to "terminal". This influences the codes that Vim will send to your terminal. This is normally not needed, because Vim will be able to find out what type - of terminal you are using. (See |terminal-info|.) {not in Vi} + of terminal you are using. (See |terminal-info|.) *-d* -d Start in |diff-mode|. @@ -356,7 +334,6 @@ argument. starts. Loading plugins is also skipped. When {vimrc} is equal to "NORC" (all uppercase), this has the same effect as "NONE", but loading plugins is not skipped. - {not in Vi} *-U* *E230* -U {gvimrc} The file {gvimrc} is read for initializations when the GUI @@ -364,14 +341,12 @@ argument. is equal to "NONE", no file is read for GUI initializations at all. |gui-init| Exception: Reading the system-wide menu file is always done. - {not in Vi} *-i* -i {viminfo} The file "viminfo" is used instead of the default viminfo file. If the name "NONE" is used (all uppercase), no viminfo file is read or written, even if 'viminfo' is set or when ":rv" or ":wv" are used. See also |viminfo-file|. - {not in Vi} *-X* -X Do not try connecting to the X server to get the current @@ -389,7 +364,6 @@ argument. When the connection is desired later anyway (e.g., for client-server messages), call the |serverlist()| function. This does not enable the XSMP handler though. - {not in Vi} *-s* -s {scriptin} The script file "scriptin" is read. The characters in the @@ -398,7 +372,6 @@ argument. of the file is reached before the editor exits, further characters are read from the keyboard. Only works when not started in Ex mode, see |-s-ex|. See also |complex-repeat|. - {not in Vi} *-w_nr* -w {number} @@ -411,62 +384,60 @@ argument. ":source!". When the "scriptout" file already exists, new characters are appended. See also |complex-repeat|. {scriptout} cannot start with a digit. - {not in Vi} *-W* -W {scriptout} Like -w, but do not append, overwrite an existing file. - {not in Vi} --remote [+{cmd}] {file} ... Open the {file} in another Vim that functions as a server. Any non-file arguments must come before this. - See |--remote|. {not in Vi} + See |--remote|. --remote-silent [+{cmd}] {file} ... Like --remote, but don't complain if there is no server. - See |--remote-silent|. {not in Vi} + See |--remote-silent|. --remote-wait [+{cmd}] {file} ... Like --remote, but wait for the server to finish editing the file(s). - See |--remote-wait|. {not in Vi} + See |--remote-wait|. --remote-wait-silent [+{cmd}] {file} ... Like --remote-wait, but don't complain if there is no server. - See |--remote-wait-silent|. {not in Vi} + See |--remote-wait-silent|. --servername {name} Specify the name of the Vim server to send to or to become. - See |--servername|. {not in Vi} + See |--servername|. --remote-send {keys} Send {keys} to a Vim server and exit. - See |--remote-send|. {not in Vi} + See |--remote-send|. --remote-expr {expr} Evaluate {expr} in another Vim that functions as a server. The result is printed on stdout. - See |--remote-expr|. {not in Vi} + See |--remote-expr|. --serverlist Output a list of Vim server names and exit. See - |--serverlist|. {not in Vi} + |--serverlist|. --socketid {id} *--socketid* GTK+ GUI Vim only. Make gvim try to use GtkPlug mechanism, so that it runs inside another window. See |gui-gtk-socketid| - for details. {not in Vi} + for details. --windowid {id} *--windowid* Win32 GUI Vim only. Make gvim try to use the window {id} as a parent, so that it runs inside that window. See - |gui-w32-windowid| for details. {not in Vi} + |gui-w32-windowid| for details. --echo-wid *--echo-wid* GTK+ GUI Vim only. Make gvim echo the Window ID on stdout, which can be used to run gvim in a kpart widget. The format of the output is: > WID: 12345\n -< {not in Vi} +< --role {role} *--role* GTK+ 2 GUI only. Set the role of the main window to {role}. @@ -474,7 +445,6 @@ argument. identify a window, in order to restore window placement and such. The --role argument is passed automatically when restoring the session on login. See |gui-gnome-session| - {not in Vi} -P {parent-title} *-P* *MDI* *E671* *E672* Win32 only: Specify the title of the parent application. When @@ -848,16 +818,16 @@ vimrc file. *:mk* *:mkexrc* :mk[exrc] [file] Write current key mappings and changed options to [file] (default ".exrc" in the current directory), - unless it already exists. {not in Vi} + unless it already exists. :mk[exrc]! [file] Always write current key mappings and changed options to [file] (default ".exrc" in the current - directory). {not in Vi} + directory). *:mkv* *:mkvimrc* :mkv[imrc][!] [file] Like ":mkexrc", but the default is ".vimrc" in the current directory. The ":version" command is also - written to the file. {not in Vi} + written to the file. These commands will write ":map" and ":set" commands to a file, in such a way that when these commands are executed, the current key mappings and options @@ -918,9 +888,6 @@ You can quickly start editing with a previously saved View or Session with the |-S| argument: > vim -S Session.vim < -All this is {not in Vi} and {not available when compiled without the -|+mksession| feature}. - *:mks* *:mksession* :mks[ession][!] [file] Write a Vim script that restores the current editing session. @@ -1203,7 +1170,7 @@ most of the information will be restored). :rv[iminfo][!] [file] Read from viminfo file [file] (default: see above). If [!] is given, then any information that is already set (registers, marks, |v:oldfiles|, etc.) - will be overwritten {not in Vi} + will be overwritten. *:wv* *:wviminfo* *E137* *E138* *E574* *E886* :wv[iminfo][!] [file] Write to viminfo file [file] (default: see above). @@ -1216,15 +1183,12 @@ most of the information will be restored). check that no old temp files were left behind (e.g. ~/.viminf*) and that you can write in the directory of the .viminfo file. - {not in Vi} *:ol* *:oldfiles* :ol[dfiles] List the files that have marks stored in the viminfo file. This list is read on startup and only changes afterwards with ":rviminfo!". Also see |v:oldfiles|. The number can be used with |c_#<|. - {not in Vi, only when compiled with the |+eval| - feature} :bro[wse] ol[dfiles][!] List file names as with |:oldfiles|, and then prompt @@ -1233,6 +1197,5 @@ most of the information will be restored). If you get the |press-enter| prompt you can press "q" and still get the prompt to enter a file number. Use ! to abandon a modified buffer. |abandon| - {not when compiled with tiny or small features} vim:tw=78:ts=8:ft=help:norl: |