Skip to content

Commit

Permalink
updated for version 7.0024
Browse files Browse the repository at this point in the history
  • Loading branch information
vimboss committed Dec 24, 2004
1 parent 06b0422 commit 8aeea83
Show file tree
Hide file tree
Showing 43 changed files with 887 additions and 311 deletions.
4 changes: 3 additions & 1 deletion Filelist
Original file line number Diff line number Diff line change
Expand Up @@ -159,6 +159,8 @@ SRC_UNIX = \
src/integration.c \
src/integration.h \
src/link.sh \
src/installman.sh \
src/installml.sh \
src/mkinstalldirs \
src/os_unix.c \
src/os_unix.h \
Expand Down Expand Up @@ -449,7 +451,6 @@ RT_ALL = \
runtime/doc/vimdiff.1 \
runtime/doc/vimtutor.1 \
runtime/doc/xxd.1 \
runtime/doc/*-it.1 \
runtime/ftoff.vim \
runtime/gvimrc_example.vim \
runtime/macros/README.txt \
Expand Down Expand Up @@ -660,6 +661,7 @@ EXTRA = \
# generic language files
LANG_GEN = \
README_lang.txt \
runtime/doc/*-it.1 \
runtime/lang/README.txt \
runtime/lang/menu_*.vim \
runtime/keymap/README.txt \
Expand Down
82 changes: 74 additions & 8 deletions runtime/doc/autocmd.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*autocmd.txt* For Vim version 7.0aa. Last change: 2004 Dec 16
*autocmd.txt* For Vim version 7.0aa. Last change: 2004 Dec 24


VIM REFERENCE MANUAL by Bram Moolenaar
Expand All @@ -14,9 +14,10 @@ For a basic explanation, see section |40.3| in the user manual.
4. Listing autocommands |autocmd-list|
5. Events |autocmd-events|
6. Patterns |autocmd-patterns|
7. Groups |autocmd-groups|
8. Executing autocommands |autocmd-execute|
9. Using autocommands |autocmd-use|
7. Buffer-local autocommands |autocmd-buflocal|
8. Groups |autocmd-groups|
9. Executing autocommands |autocmd-execute|
10. Using autocommands |autocmd-use|

{Vi does not have any of these commands}
{only when the |+autocmd| feature has not been disabled at compile time}
Expand Down Expand Up @@ -62,6 +63,9 @@ Note: The ":autocmd" command cannot be followed by another command, since any
order in which they were given. See |autocmd-nested|
for [nested].

The special pattern <buffer> or <buffer=N> defines a buffer-local autocommand.
See |autocmd-buflocal|.

Note that special characters (e.g., "%", "<cword>") in the ":autocmd"
arguments are not expanded when the autocommand is defined. These will be
expanded when the Event is recognized, and the {cmd} is executed. The only
Expand Down Expand Up @@ -148,6 +152,9 @@ If you provide the [group] argument, Vim lists only the autocommands for
[group]; otherwise, Vim lists the autocommands for ALL groups. Note that this
argument behavior differs from that for defining and removing autocommands.

In order to list buffer-local autocommands, use a pattern in the form <buffer>
or <buffer=N>. See |autocmd-buflocal|.

==============================================================================
5. Events *autocmd-events* *E215* *E216*

Expand Down Expand Up @@ -553,6 +560,10 @@ two ways:
both short file name (as you typed it) and the full file name (after
expanding it to a full path and resolving symbolic links).

The special pattern <buffer> or <buffer=N> is used for buffer-local
autocommands |autocmd-buflocal|. This pattern is not matched against the name
of a buffer.

Examples: >
:autocmd BufRead *.txt set et
Set the 'et' option for all text files. >
Expand Down Expand Up @@ -608,7 +619,7 @@ Note that for all systems the '/' character is used for path separator (even
MS-DOS and OS/2). This was done because the backslash is difficult to use
in a pattern and to make the autocommands portable across different systems.


*autocmd-changes*
Matching with the pattern is done when an event is triggered. Changing the
buffer name in one of the autocommands, or even deleting the buffer, does not
change which autocommands will be executed. Example: >
Expand All @@ -621,8 +632,62 @@ the current buffer instead. Vim doesn't take into account that "*.foo"
doesn't match with that buffer name. It matches "*.foo" with the name of the
buffer at the moment the event was triggered.

However, buffer-local autocommands will not be executed for a buffer that has
been wiped out with |:bwipe|. After deleting the buffer with |:bdel| the
buffer actually still exists (it becomes unlisted), thus the autocommands are
still executed.

==============================================================================
7. Buffer-local autocommands *autocmd-buflocal* *autocmd-buffer-local*
*<buffer=N>* *<buffer=abuf>* *E680*

Buffer-local autocommands are attached to a specific buffer. They are useful
if the buffer does not have a name and when the name does not match a specific
pattern. But it also means they must be explicitly added to each buffer.

Instead of a pattern buffer-local autocommands use one of these forms:
<buffer> current buffer
<buffer=99> buffer number 99
<buffer=abuf> using <abuf> (only when executing autocommands)
|<abuf>|

Examples: >
:au CursorHold <buffer> echo 'hold'
:au CursorHold <buffer=33> echo 'hold'
:au CursorHold <buffer=abuf> echo 'hold'
All the commands for autocommands also work with buffer-local autocommands,
simply use the special string instead of the pattern. Examples: >
:au! * <buffer> " remove buffer-local autotommands for
" current buffer
:au! * <buffer=33> " remove buffer-local autotommands for
" buffer #33
:dobuf :au! CursorHold <buffer> " remove autocmd for given event for all
" buffers
:au * <buffer> " list buffer-local autocommands for
" current buffer
Note that when an autocommand is defined for the current buffer, it is stored
with the buffer number. Thus it uses the form "<buffer=12>", where 12 is the
number of the current buffer. You will see this when listing autocommands,
for example.

To test for presence of buffer-local autocommands use the |exists()| function
as follows: >
:if exists("#CursorHold#<buffer=12>") | ... | endif
:if exists("#CursorHold#<buffer>") | ... | endif " for current buffer
When a buffer is wiped out its buffer-local autocommands are also gone, of
course. Note that when deleting a buffer, e.g., with ":bdel", it is only
unlisted, the autocommands are still present. In order to see the removal of
buffer-local autocommands: >
:set verbose=6
It is not possible to define buffer-local autocommands for a non-existent
buffer.

==============================================================================
7. Groups *autocmd-groups*
8. Groups *autocmd-groups*

Autocommands can be put together in a group. This is useful for removing or
executing a group of autocommands. For example, all the autocommands for
Expand Down Expand Up @@ -670,7 +735,7 @@ This prevents having the autocommands defined twice (e.g., after sourcing the
.vimrc file again).

==============================================================================
8. Executing autocommands *autocmd-execute*
9. Executing autocommands *autocmd-execute*

Vim can also execute Autocommands non-automatically. This is useful if you
have changed autocommands, or when Vim has executed the wrong autocommands
Expand Down Expand Up @@ -713,7 +778,7 @@ option will not cause any commands to be executed.
options, change highlighting, and things like that.

==============================================================================
9. Using autocommands *autocmd-use*
10. Using autocommands *autocmd-use*

For WRITING FILES there are four possible sets of events. Vim uses only one
of these sets for a write command:
Expand Down Expand Up @@ -926,4 +991,5 @@ The |v:cmdbang| variable is one when "!" was used, zero otherwise.

See the $VIMRUNTIME/plugin/netrw.vim for examples.


vim:tw=78:ts=8:ft=help:norl:
4 changes: 3 additions & 1 deletion runtime/doc/cmdline.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*cmdline.txt* For Vim version 7.0aa. Last change: 2004 Jul 14
*cmdline.txt* For Vim version 7.0aa. Last change: 2004 Dec 20


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -355,6 +355,8 @@ CTRL-D List names that match the pattern in front of the cursor.
When showing file names, directories are highlighted (see
'highlight' option). Names where 'suffixes' matches are moved
to the end.
The 'wildoptions' option can be set to "tagfile" to list the
file of matching tags.
*c_CTRL-I* *c_wildchar* *c_<Tab>*
'wildchar' option
A match is done on the pattern in front of the cursor. The
Expand Down
4 changes: 3 additions & 1 deletion runtime/doc/index.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*index.txt* For Vim version 7.0aa. Last change: 2004 Nov 30
*index.txt* For Vim version 7.0aa. Last change: 2004 Dec 23


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -1141,6 +1141,7 @@ The commands are sorted on the non-optional part of their name.
|:ex| :ex same as ":edit"
|:execute| :exe[cute] execute result of expressions
|:exit| :exi[t] same as ":xit"
|:exusage| :exu[sage] overview of Ex commands
|:file| :f[ile] show or set the current file name
|:files| :files list all files in the buffer list
|:filetype| :filet[ype] switch file type detection on/off
Expand Down Expand Up @@ -1399,6 +1400,7 @@ The commands are sorted on the non-optional part of their name.
|:verbose| :verb[ose] execute command with 'verbose' set
|:vertical| :vert[ical] make following command split vertically
|:visual| :vi[sual] same as ":edit", but turns off "Ex" mode
|:viusage| :viu[sage] overview of Normal mode commands
|:view| :vie[w] edit a file read-only
|:vmap| :vm[ap] like ":map" but for Visual mode
|:vmapclear| :vmapc[lear] remove all mappings for Visual mode
Expand Down
2 changes: 1 addition & 1 deletion runtime/doc/insert.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*insert.txt* For Vim version 7.0aa. Last change: 2004 Nov 18
*insert.txt* For Vim version 7.0aa. Last change: 2004 Dec 21


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down
28 changes: 22 additions & 6 deletions runtime/doc/options.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*options.txt* For Vim version 7.0aa. Last change: 2004 Dec 19
*options.txt* For Vim version 7.0aa. Last change: 2004 Dec 21


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -291,10 +291,11 @@ For buffer-local and window-local options:

Global options with a local value *global-local*

Options are global when you mostly use one value for all buffers. For some
global options it's useful to sometimes have a different local value. You can
set the local value with ":setlocal". That buffer will then use the local
value, while other buffers continue using the global value.
Options are global when you mostly use one value for all buffers and windows.
For some global options it's useful to sometimes have a different local value.
You can set the local value with ":setlocal". That buffer or window will then
use the local value, while other buffers and windows continue using the global
value.

For example, you have two windows, both on C source code. They use the global
'makeprg' option. If you do this in one of the two windows: >
Expand Down Expand Up @@ -5486,7 +5487,7 @@ A jump table for the options with a short description can be found at |Q_op|.

*'statusline'* *'stl'* *E540* *E541* *E542*
'statusline' 'stl' string (default empty)
global
global or local to window |global-local|
{not in Vi}
{not available when compiled without the |+statusline|
feature}
Expand Down Expand Up @@ -6670,6 +6671,21 @@ A jump table for the options with a short description can be found at |Q_op|.
:set wildmode=longest,list
< Complete longest common string, then list alternatives.

*'wildoptions'* *'wop'*
'wildoptions' 'wop' string (default "")
global
{not in Vi}
{not available when compiled without the |+wildignore|
feature}
A list of words that change how command line completion is done.
Currently only one word is allowed:
tagfile When using CTRL-D to list matching tags, the kind of
tag and the file of the tag is listed. Only one match
is displayed per line. Often used tag kinds are:
d #define
f function
Also see |cmdline-completion|.

*'winaltkeys'* *'wak'*
'winaltkeys' 'wak' string (default "menu")
global
Expand Down
11 changes: 1 addition & 10 deletions runtime/doc/russian.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*russian.txt* For Vim version 7.0aa. Last change: 2004 Jun 09
*russian.txt* For Vim version 7.0aa. Last change: 2004 Dec 22


VIM REFERENCE MANUAL by Vassily Ragosin
Expand Down Expand Up @@ -70,14 +70,5 @@ In order to use the Russian documentation, make sure you have set the
is related to a bug in GNU gettext library and may be fixed in the future
releases of gettext.

-- When using the Win32 console version of Vim you may experience a problem
with many Cyrillic glyphs being replaced by whitespaces for some unknown
reason. Sergey Khorev suggested a registry hack to avoid this:

REGEDIT4

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage]
"1252"="c_1251.nls"

===============================================================================
vim:tw=78:ts=8:ft=help:norl:
13 changes: 13 additions & 0 deletions runtime/doc/tags
Original file line number Diff line number Diff line change
Expand Up @@ -948,6 +948,7 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME*
'wildignore' options.txt /*'wildignore'*
'wildmenu' options.txt /*'wildmenu'*
'wildmode' options.txt /*'wildmode'*
'wildoptions' options.txt /*'wildoptions'*
'wim' options.txt /*'wim'*
'winaltkeys' options.txt /*'winaltkeys'*
'window' vi_diff.txt /*'window'*
Expand All @@ -962,6 +963,7 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME*
'wmh' options.txt /*'wmh'*
'wmnu' options.txt /*'wmnu'*
'wmw' options.txt /*'wmw'*
'wop' options.txt /*'wop'*
'wrap' options.txt /*'wrap'*
'wrapmargin' options.txt /*'wrapmargin'*
'wrapscan' options.txt /*'wrapscan'*
Expand Down Expand Up @@ -1892,6 +1894,8 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME*
:execute eval.txt /*:execute*
:exi editing.txt /*:exi*
:exit editing.txt /*:exit*
:exu various.txt /*:exu*
:exusage various.txt /*:exusage*
:f editing.txt /*:f*
:fi editing.txt /*:fi*
:file editing.txt /*:file*
Expand Down Expand Up @@ -2514,6 +2518,8 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME*
:view editing.txt /*:view*
:visual editing.txt /*:visual*
:visual_example visual.txt /*:visual_example*
:viu various.txt /*:viu*
:viusage various.txt /*:viusage*
:vm map.txt /*:vm*
:vmap map.txt /*:vmap*
:vmap_l map.txt /*:vmap_l*
Expand Down Expand Up @@ -2698,6 +2704,8 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME*
<amatch> cmdline.txt /*<amatch>*
<args> map.txt /*<args>*
<bang> map.txt /*<bang>*
<buffer=N> autocmd.txt /*<buffer=N>*
<buffer=abuf> autocmd.txt /*<buffer=abuf>*
<cfile> cmdline.txt /*<cfile>*
<character> intro.txt /*<character>*
<count> map.txt /*<count>*
Expand Down Expand Up @@ -3550,6 +3558,7 @@ E677 eval.txt /*E677*
E678 pattern.txt /*E678*
E679 syntax.txt /*E679*
E68 pattern.txt /*E68*
E680 autocmd.txt /*E680*
E69 pattern.txt /*E69*
E70 pattern.txt /*E70*
E71 pattern.txt /*E71*
Expand Down Expand Up @@ -3995,6 +4004,9 @@ auto-format change.txt /*auto-format*
auto-setting options.txt /*auto-setting*
auto-shortname editing.txt /*auto-shortname*
autocmd-<> tips.txt /*autocmd-<>*
autocmd-buffer-local autocmd.txt /*autocmd-buffer-local*
autocmd-buflocal autocmd.txt /*autocmd-buflocal*
autocmd-changes autocmd.txt /*autocmd-changes*
autocmd-define autocmd.txt /*autocmd-define*
autocmd-events autocmd.txt /*autocmd-events*
autocmd-execute autocmd.txt /*autocmd-execute*
Expand Down Expand Up @@ -4269,6 +4281,7 @@ cp-default version5.txt /*cp-default*
cpo-! options.txt /*cpo-!*
cpo-$ options.txt /*cpo-$*
cpo-% options.txt /*cpo-%*
cpo-+ options.txt /*cpo-+*
cpo-< options.txt /*cpo-<*
cpo-A options.txt /*cpo-A*
cpo-B options.txt /*cpo-B*
Expand Down
Loading

0 comments on commit 8aeea83

Please sign in to comment.