summaryrefslogtreecommitdiff
path: root/runtime/doc/starting.txt
diff options
context:
space:
mode:
authorBram Moolenaar <Bram@vim.org>2016-08-23 23:51:21 +0200
committerBram Moolenaar <Bram@vim.org>2016-08-23 23:51:21 +0200
commit7b668e83d0635d082b7ec90d7d2aa30a9d7d8928 (patch)
tree5a766b46ad4395652cfe4d2545ee809047384fc9 /runtime/doc/starting.txt
parent1b58cdd160c2e0ada0f638679a2aa27e4665fc48 (diff)
downloadvim-git-7b668e83d0635d082b7ec90d7d2aa30a9d7d8928.tar.gz
patch 7.4.2244v7.4.2244
Problem: Adding pattern to ":oldfiles" is not a generic solution. Solution: Add the ":filter /pat/ cmd" command modifier. Only works for some commands right now.
Diffstat (limited to 'runtime/doc/starting.txt')
-rw-r--r--runtime/doc/starting.txt44
1 files changed, 28 insertions, 16 deletions
diff --git a/runtime/doc/starting.txt b/runtime/doc/starting.txt
index 015f68ea5..aaa487606 100644
--- a/runtime/doc/starting.txt
+++ b/runtime/doc/starting.txt
@@ -1,4 +1,4 @@
-*starting.txt* For Vim version 7.4. Last change: 2016 Aug 06
+*starting.txt* For Vim version 7.4. Last change: 2016 Aug 23
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -923,7 +923,8 @@ accordingly. Vim proceeds in this order:
The $MYVIMRC or $MYGVIMRC file will be set to the first found vimrc and/or
gvimrc file.
-Some hints on using initializations:
+
+Some hints on using initializations ~
Standard setup:
Create a vimrc file to set the default settings and mappings for all your edit
@@ -946,27 +947,37 @@ want to set the defaults for all users. Create a vimrc file with commands
for default settings and mappings and put it in the place that is given with
the ":version" command.
-Saving the current state of Vim to a file:
+
+Saving the current state of Vim to a file ~
+
Whenever you have changed values of options or when you have created a
mapping, then you may want to save them in a vimrc file for later use. See
|save-settings| about saving the current state of settings to a file.
-Avoiding setup problems for Vi users:
+
+Avoiding setup problems for Vi users ~
+
Vi uses the variable EXINIT and the file "~/.exrc". So if you do not want to
interfere with Vi, then use the variable VIMINIT and the file "vimrc" instead.
-Amiga environment variables:
+
+Amiga environment variables ~
+
On the Amiga, two types of environment variables exist. The ones set with the
DOS 1.3 (or later) setenv command are recognized. See the AmigaDos 1.3
manual. The environment variables set with the old Manx Set command (before
version 5.0) are not recognized.
-MS-DOS line separators:
+
+MS-DOS line separators ~
+
On MS-DOS-like systems (MS-DOS itself, Win32, and OS/2), Vim assumes that all
the vimrc files have <CR> <NL> pairs as line separators. This will give
problems if you have a file with only <NL>s and have a line like
":map xx yy^M". The trailing ^M will be ignored.
+
+Vi compatible default value ~
*compatible-default*
When Vim starts, the 'compatible' option is on. This will be used when Vim
starts its initializations. But as soon as:
@@ -999,6 +1010,8 @@ encountered. This makes a difference when using things like "<CR>". If the
mappings depend on a certain value of 'compatible', set or reset it before
giving the mapping.
+
+Defaults without a .vimrc file ~
*defaults.vim*
If Vim is started normally and no user vimrc file is found, the
$VIMRUTIME/defaults.vim script is loaded. This will set 'compatible' off,
@@ -1018,7 +1031,8 @@ revert individual settings. See the defaults.vim file for hints on how to
revert each item.
-Avoiding trojan horses: *trojan-horse*
+Avoiding trojan horses ~
+ *trojan-horse*
While reading the "vimrc" or the "exrc" file in the current directory, some
commands can be disabled for security reasons by setting the 'secure' option.
This is always done when executing the command from a tags file. Otherwise it
@@ -1041,6 +1055,8 @@ Be careful!
part of the line in the tags file) is always done in secure mode. This works
just like executing a command from a vimrc/exrc in the current directory.
+
+If Vim startup is slow ~
*slow-start*
If Vim takes a long time to start up, use the |--startuptime| argument to find
out what happens. There are a few common causes:
@@ -1055,6 +1071,8 @@ out what happens. There are a few common causes:
moment (use the Vim argument "-i NONE", |-i|). Try reducing the number of
lines stored in a register with ":set viminfo='20,<50,s10". |viminfo-file|.
+
+Intro message ~
*:intro*
When Vim starts without a file name, an introductory message is displayed (for
those who don't know what Vim is). It is removed as soon as the display is
@@ -1613,18 +1631,12 @@ most of the information will be restored).
file. This list is read on startup and only changes
afterwards with `:rviminfo!`. Also see |v:oldfiles|.
The number can be used with |c_#<|.
+ The output can be filtered with |:filter|, e.g.: >
+ filter /\\.vim/ oldfiles
+< The filtering happens on the file name.
{not in Vi, only when compiled with the |+eval|
feature}
-:ol[dfiles] {pat}
-:ol[dfiles] /{pat}/
- Like `:oldfiles` but only files matching {pat} will
- be included. {pat} is a Vim search pattern. Instead
- of enclosing it in / any non-ID character (see
- |'isident'|) can be used, so long as it does not
- appear in {pat}. Without the enclosing character the
- pattern cannot include the bar character.
-
:bro[wse] ol[dfiles][!]
List file names as with |:oldfiles|, and then prompt
for a number. When the number is valid that file from