updated for version 7.0025
This commit is contained in:
@ -1,4 +1,4 @@
|
||||
*change.txt* For Vim version 7.0aa. Last change: 2004 Dec 17
|
||||
*change.txt* For Vim version 7.0aa. Last change: 2004 Dec 24
|
||||
|
||||
|
||||
VIM REFERENCE MANUAL by Bram Moolenaar
|
||||
@ -1332,10 +1332,12 @@ a Automatic formatting of paragraphs. Every time text is inserted or
|
||||
deleted the paragraph will be reformatted. See |auto-format|.
|
||||
When the 'c' flag is present this only happens for recognized
|
||||
comments.
|
||||
n When formatting text, recognize numbered lists. The indent of the
|
||||
text after the number is used for the next line. The number may
|
||||
optionally be followed by '.', ':', ')', ']' or '}'. Note that
|
||||
'autoindent' must be set too. Doesn't work well together with "2".
|
||||
n When formatting text, recognize numbered lists. This actually uses
|
||||
the 'formatlistpat' option, thus any kind of list can be used. The
|
||||
indent of the text after the number is used for the next line. The
|
||||
default is to find a number, optionally be followed by '.', ':', ')',
|
||||
']' or '}'. Note that 'autoindent' must be set too. Doesn't work
|
||||
well together with "2".
|
||||
Example: >
|
||||
1. the first item
|
||||
wraps
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
*index.txt* For Vim version 7.0aa. Last change: 2004 Dec 23
|
||||
*index.txt* For Vim version 7.0aa. Last change: 2004 Dec 24
|
||||
|
||||
|
||||
VIM REFERENCE MANUAL by Bram Moolenaar
|
||||
@ -1059,6 +1059,7 @@ The commands are sorted on the non-optional part of their name.
|
||||
|:cabclear| :cabc[lear] clear all abbreviations for Command-line mode
|
||||
|:call| :cal[l] call a function
|
||||
|:catch| :cat[ch] part of a :try command
|
||||
|:cbuffer| :cb[uffer] parse error messages and jump to first error
|
||||
|:cc| :cc go to specific error
|
||||
|:cclose| :ccl[ose] close quickfix window
|
||||
|:cd| :cd change directory
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
*options.txt* For Vim version 7.0aa. Last change: 2004 Dec 21
|
||||
*options.txt* For Vim version 7.0aa. Last change: 2004 Dec 24
|
||||
|
||||
|
||||
VIM REFERENCE MANUAL by Bram Moolenaar
|
||||
@ -2728,6 +2728,20 @@ A jump table for the options with a short description can be found at |Q_op|.
|
||||
NOTE: This option is set to the Vi default value when 'compatible' is
|
||||
set and to the Vim default value when 'compatible' is reset.
|
||||
|
||||
*'formatlistpat'* *'flp'*
|
||||
'formatlistpat' 'flp' string (default: "^\s*\d\+[\]:.)}\t ]\s*")
|
||||
local to buffer
|
||||
{not in Vi}
|
||||
A pattern that is used to recognize a list header. This is used for
|
||||
the "n" flag in 'formatoptions'.
|
||||
The pattern must match exactly the text that will be the indent for
|
||||
the line below it. You can use |\ze| to mark the end of the match
|
||||
while still checking more characters. There must be a character
|
||||
following the pattern, when it matches the whole line it is handled
|
||||
like there is no match.
|
||||
The default recognizes a number, followed by an optional punctuation
|
||||
character and white space.
|
||||
|
||||
*'formatprg'* *'fp'*
|
||||
'formatprg' 'fp' string (default "")
|
||||
global
|
||||
@ -2795,7 +2809,9 @@ A jump table for the options with a short description can be found at |Q_op|.
|
||||
When your "grep" accepts the "-H" argument, use this to make ":grep"
|
||||
also work well with a single file: >
|
||||
:set grepprg=grep\ -nH
|
||||
< See also the section |:make_makeprg|, since most of the comments there
|
||||
< Special value: When 'grepprg' is set to "internal" the ":grep" works
|
||||
like ":vimgrep".
|
||||
See also the section |:make_makeprg|, since most of the comments there
|
||||
apply equally to 'grepprg'.
|
||||
For Win32, the default is "findstr /n" if "findstr.exe" can be found,
|
||||
otherwise it's "grep -n".
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
*quickfix.txt* For Vim version 7.0aa. Last change: 2004 Jun 16
|
||||
*quickfix.txt* For Vim version 7.0aa. Last change: 2004 Dec 27
|
||||
|
||||
|
||||
VIM REFERENCE MANUAL by Bram Moolenaar
|
||||
@ -105,6 +105,14 @@ The following quickfix commands can be used:
|
||||
Read the error file. Just like ":cfile" but don't
|
||||
jump to the first error.
|
||||
|
||||
*:cb* *:cbuffer* *E681*
|
||||
:cb[uffer] [bufnr] Read the error list from the current buffer.
|
||||
When [bufnr] is given it must be the number of a
|
||||
loaded buffer. That buffer will then be used instead
|
||||
of the current buffer.
|
||||
A range can be specified for the lines to be used.
|
||||
Otherwise all lines in the buffer are used.
|
||||
|
||||
*:cl* *:clist*
|
||||
:cl[ist] [from] [, [to]]
|
||||
List all errors that are valid |quickfix-valid|.
|
||||
@ -266,7 +274,37 @@ If 'shellpipe' is empty, the {errorfile} part will be omitted. This is useful
|
||||
for compilers that write to an errorfile themselves (e.g., Manx's Amiga C).
|
||||
|
||||
==============================================================================
|
||||
5. Using :grep *grep* *lid*
|
||||
5. Using :vimgrep and :grep *grep* *lid*
|
||||
|
||||
Vim has two ways to find matches for a pattern: Internal and external. The
|
||||
advantage of the internal grep is that it works on all systems and uses the
|
||||
powerful Vim search patterns. An external grep program can be used when the
|
||||
Vim grep does not do what you want.
|
||||
|
||||
The internal method may be a bit slower, because files are read into memory.
|
||||
The advantage is that line separators and encoding are automatically
|
||||
recognized, as if a file is being edited. And multi-line patterns can be
|
||||
used.
|
||||
|
||||
|
||||
5.1 using Vim's internal grep
|
||||
|
||||
*:vim* *:vimgrep*
|
||||
:vim[grep][!] /{pattern}/ {file} ...
|
||||
Search for {pattern} in the files {file} ... and set
|
||||
the error list to the matches.
|
||||
{pattern} if a Vim search pattern. Instead of
|
||||
enclosing it in / any character can be used, so long
|
||||
as it does not appear in {pattern}.
|
||||
|
||||
*:vimgrepa* *:vimgrepadd*
|
||||
:vimgrepa[dd][!] /{pattern}/ {file} ...
|
||||
Just like ":vimgrep", but instead of making a new list
|
||||
of errors the matches are appended to the current
|
||||
list.
|
||||
|
||||
|
||||
5.2 External grep
|
||||
|
||||
Vim can interface with "grep" and grep-like programs (such as the GNU
|
||||
id-utils) in a similar way to its compiler integration (see |:make| above).
|
||||
@ -277,6 +315,9 @@ id-utils) in a similar way to its compiler integration (see |:make| above).
|
||||
*:gr* *:grep*
|
||||
:gr[ep][!] [arguments] Just like ":make", but use 'grepprg' instead of
|
||||
'makeprg' and 'grepformat' instead of 'errorformat'.
|
||||
When 'grepprg' is "internal" this works like
|
||||
|:vimgrep|. Note that the pattern needs to be
|
||||
enclosed in separator characters then.
|
||||
*:grepa* *:grepadd*
|
||||
:grepa[dd][!] [arguments]
|
||||
Just like ":grep", but instead of making a new list of
|
||||
@ -290,7 +331,7 @@ id-utils) in a similar way to its compiler integration (see |:make| above).
|
||||
":grepadd" jumps to the first error, which is not
|
||||
allowed with |:bufdo|.
|
||||
|
||||
5.1 Setting up grep
|
||||
5.3 Setting up external grep
|
||||
|
||||
If you have a standard "grep" program installed, the :grep command may work
|
||||
well with the defaults. The syntax is very similar to the standard command: >
|
||||
@ -322,7 +363,7 @@ error in |quickfix| mode. You can then use the |:cnext|, |:clist|, etc.
|
||||
commands to see the other matches.
|
||||
|
||||
|
||||
5.2 Using :grep with id-utils
|
||||
5.4 Using :grep with id-utils
|
||||
|
||||
You can set up :grep to work with the GNU id-utils like this: >
|
||||
|
||||
@ -336,31 +377,31 @@ works just as you'd expect.
|
||||
(provided you remembered to mkid first :)
|
||||
|
||||
|
||||
5.3 Browsing source code with :grep
|
||||
5.5 Browsing source code with :vimgrep or :grep
|
||||
|
||||
Using the stack of error lists that Vim keeps, you can browse your files to
|
||||
look for functions and the functions they call. For example, suppose that you
|
||||
have to add an argument to the read_file() function. You enter this command: >
|
||||
|
||||
:grep read_file *.c
|
||||
:vimgrep /\<read_file\>/ *.c
|
||||
|
||||
You use ":cn" to go along the list of matches and add the argument. At one
|
||||
place you have to get the new argument from a higher level function msg(), and
|
||||
need to change that one too. Thus you use: >
|
||||
|
||||
:grep msg *.c
|
||||
:vimgrep /\<msg\>/ *.c
|
||||
|
||||
While changing the msg() functions, you find another function that needs to
|
||||
get the argument from a higher level. You can again use ":grep" to find these
|
||||
functions. Once you are finished with one function, you can use >
|
||||
get the argument from a higher level. You can again use ":vimgrep" to find
|
||||
these functions. Once you are finished with one function, you can use >
|
||||
|
||||
:colder
|
||||
|
||||
to go back to the previous one.
|
||||
|
||||
This works like browsing a tree: ":grep" goes one level deeper, creating a
|
||||
This works like browsing a tree: ":vimgrep" goes one level deeper, creating a
|
||||
list of branches. ":colder" goes back to the previous level. You can mix
|
||||
this use of ":grep" and "colder" to browse all the locations in a tree-like
|
||||
this use of ":vimgrep" and "colder" to browse all the locations in a tree-like
|
||||
way. If you do this consistently, you will find all locations without the
|
||||
need to write down a "todo" list.
|
||||
|
||||
|
||||
@ -210,6 +210,7 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME*
|
||||
'fkmap' options.txt /*'fkmap'*
|
||||
'fl' vi_diff.txt /*'fl'*
|
||||
'flash' vi_diff.txt /*'flash'*
|
||||
'flp' options.txt /*'flp'*
|
||||
'fml' options.txt /*'fml'*
|
||||
'fmr' options.txt /*'fmr'*
|
||||
'fo' options.txt /*'fo'*
|
||||
@ -226,6 +227,7 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME*
|
||||
'foldnestmax' options.txt /*'foldnestmax'*
|
||||
'foldopen' options.txt /*'foldopen'*
|
||||
'foldtext' options.txt /*'foldtext'*
|
||||
'formatlistpat' options.txt /*'formatlistpat'*
|
||||
'formatoptions' options.txt /*'formatoptions'*
|
||||
'formatprg' options.txt /*'formatprg'*
|
||||
'fp' options.txt /*'fp'*
|
||||
@ -1723,6 +1725,8 @@ $VIMRUNTIME starting.txt /*$VIMRUNTIME*
|
||||
:call eval.txt /*:call*
|
||||
:cat eval.txt /*:cat*
|
||||
:catch eval.txt /*:catch*
|
||||
:cb quickfix.txt /*:cb*
|
||||
:cbuffer quickfix.txt /*:cbuffer*
|
||||
:cc quickfix.txt /*:cc*
|
||||
:ccl quickfix.txt /*:ccl*
|
||||
:cclose quickfix.txt /*:cclose*
|
||||
@ -3559,6 +3563,7 @@ E678 pattern.txt /*E678*
|
||||
E679 syntax.txt /*E679*
|
||||
E68 pattern.txt /*E68*
|
||||
E680 autocmd.txt /*E680*
|
||||
E681 quickfix.txt /*E681*
|
||||
E69 pattern.txt /*E69*
|
||||
E70 pattern.txt /*E70*
|
||||
E71 pattern.txt /*E71*
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
*todo.txt* For Vim version 7.0aa. Last change: 2004 Dec 24
|
||||
*todo.txt* For Vim version 7.0aa. Last change: 2004 Dec 27
|
||||
|
||||
|
||||
VIM REFERENCE MANUAL by Bram Moolenaar
|
||||
@ -30,6 +30,16 @@ be worked on, but only if you sponsor Vim development. See |sponsor|.
|
||||
*known-bugs*
|
||||
-------------------- Known bugs and current work -----------------------
|
||||
|
||||
Python 2.4 breaks uploading with rsync, 2.3 is OK.
|
||||
|
||||
- Use a builtin grep command for ":grep"? Makes it possible to add the
|
||||
column number.
|
||||
Patch from Yegappan Lakshmanan, Nov 4.
|
||||
Don't expand wildcards in pattern (first arg)
|
||||
completion for all files after first arg.
|
||||
Use a buffer to load the file, so that gzip files can be searched and long
|
||||
lines work.
|
||||
|
||||
Patch for mch_FullName() also in Vim 6.3? os_mswin.c
|
||||
|
||||
Win32: "gvim -V100" should use dialog with scrollbar. Using
|
||||
@ -50,25 +60,6 @@ Included NetBeans patches (Gordon Prieur, Oct 20)
|
||||
|
||||
PLANNED FOR VERSION 7.0:
|
||||
|
||||
- Include many PATCHES:
|
||||
- VimResized - When the Vim window has been resized (SIGWINCH)
|
||||
patch from Yakov Lerner, 2003 July 24.
|
||||
- Patch for specifying an expression for numbered lists. (Hugo Haas,
|
||||
2004 Aug 7)
|
||||
- Add the ":cbuffer" command: read list of errors from a buffer instead
|
||||
of from a file. (Yegappan Lakshmanan, Oct 31, but avoid the temp file)
|
||||
Perhaps ":cexpr" could read from a list?
|
||||
Add %b to 'errorformat': buffer number. (Yegappan Lakshmanan / Suresh
|
||||
Govindachar)
|
||||
- Use a builtin grep command for ":grep"? Makes it possible to add the
|
||||
column number. Can use the code of ":helpgrep".
|
||||
Patch from Yegappan Lakshmanan, Nov 4. Or use ":grep" and set 'grepprg'
|
||||
to something special? Could also do both.
|
||||
Also support using "**" in filename, so that a directory tree can be
|
||||
searched.
|
||||
Also see the "minigrep.vim" script on www.vim.org.
|
||||
|
||||
|
||||
- Drop the kvim support? There is no maintenance and "yzis" is supposed to
|
||||
replace it.
|
||||
- In the kvim/KDE source files fix the formatting.
|
||||
@ -77,8 +68,6 @@ PLANNED FOR VERSION 7.0:
|
||||
- KDE GUI Input method patch. (Yasuhiro Matsumoto) (upd. Oct 25 2004)
|
||||
|
||||
After including patches:
|
||||
- Change ga_room into ga_maxlen, so that it doesn't need to be
|
||||
incremented/decremented each time.
|
||||
- For string variables, use length instead of NUL termination?
|
||||
+ can include NUL characters
|
||||
- setline() will have problems with NL vs NUL.
|
||||
@ -105,6 +94,8 @@ After including patches:
|
||||
- Improve the interface between the generic GUI code and the system-specific
|
||||
code. Generic code handles text window with scrollbars, system-specific
|
||||
code menu, toolbar, etc.
|
||||
- Support using "**" in filename for ":next", ":vimgrep", etc., so that a
|
||||
directory tree can be searched.
|
||||
- Store messages to allow SCROLLING BACK for all commands. And other "less"
|
||||
like commands.
|
||||
- "INTELLISENSE". First cleanup the Insert-mode completion.
|
||||
@ -180,6 +171,11 @@ After including patches:
|
||||
"foldcolumn". (Benji Fisher, 2004 Jun 21)
|
||||
- FileChangedShellPost autocommand event: after (not) reloading a changed
|
||||
file. Can be used to update statusline oslt.
|
||||
- VimResized autocmd event: When the Vim window has been resized (SIGWINCH)
|
||||
patch from Yakov Lerner, 2003 July 24.
|
||||
It's not clear that this doesn't cause problems when the executed
|
||||
commands do something like changing 'lines'. Esp. because the
|
||||
screen has not yet been allocated with the new size.
|
||||
- Running a shell command from the GUI still has limitations. Look into how
|
||||
the Vim shell project can help: http://vimshell.wana.at
|
||||
8 When a file is change outside of Vim and unmodified in Vim there is no
|
||||
@ -3067,6 +3063,9 @@ Debug mode:
|
||||
Various improvements:
|
||||
8 Add ":rename" command: rename the file of the current buffer and rename
|
||||
the buffer. Buffer may be modified.
|
||||
- Perhaps ":cexpr" could read errors from a list?
|
||||
Add %b to 'errorformat': buffer number. (Yegappan Lakshmanan / Suresh
|
||||
Govindachar)
|
||||
6 In the quickfix window statusline add the command used to get the list of
|
||||
errors, e.g. ":make foo", ":grep something *.c".
|
||||
7 Add a ":cstring" command. Works like ":cfile" but reads from a string
|
||||
|
||||
@ -158,6 +158,9 @@ Options: ~
|
||||
'wildoptions' "tagfile" value enables listing the file name of
|
||||
matching tags for CTRL-D command line completion.
|
||||
(based on an idea from Yegappan Lakshmanan)
|
||||
'formatlistpat' pattern to recognize a numbered list for formatting.
|
||||
(idea by Hugo Haas)
|
||||
|
||||
|
||||
Ex commands: ~
|
||||
|
||||
@ -180,6 +183,8 @@ Win32: The ":winpos" command now also works in the console. (Vipin Aravind)
|
||||
|
||||
|:viusage| Help for Vi commands (Nvi command).
|
||||
|
||||
|:cbuffer| Read error lines from a buffer. (partly by Yegappan
|
||||
Lakshmanan)
|
||||
|
||||
New functions: ~
|
||||
|
||||
@ -354,6 +359,9 @@ in a Vim server to "utf-8", and using "vim --remote fname" in a console,
|
||||
"fname" is converted from the console encoding to utf-8. Also allows Vims
|
||||
with different 'encoding' settings to exchange messages.
|
||||
|
||||
Internal: Changed ga_room into ga_maxlen, so that it doesn't need to be
|
||||
incremented/decremented each time.
|
||||
|
||||
==============================================================================
|
||||
COMPILE TIME CHANGES *compile-changes-7*
|
||||
|
||||
@ -582,4 +590,7 @@ message for the next buffer. Temporarily clear 'shortmess' to avoid that.
|
||||
Win32: Cannot edit a file starting with # with --remote. Do escape % and #
|
||||
when building the ":drop" command.
|
||||
|
||||
A comment or | just after a expresion-backtick argument was not recognized.
|
||||
E.g. in :e `="foo"`"comment.
|
||||
|
||||
vim:tw=78:ts=8:ft=help:norl:
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
" These commands create the option window.
|
||||
"
|
||||
" Maintainer: Bram Moolenaar <Bram@vim.org>
|
||||
" Last Change: 2004 Dec 20
|
||||
" Last Change: 2004 Dec 24
|
||||
|
||||
" If there already is an option window, jump to that one.
|
||||
if bufwinnr("option-window") > 0
|
||||
@ -667,6 +667,9 @@ call <SID>OptionL("com")
|
||||
call append("$", "formatoptions\tlist of flags that tell how automatic formatting works")
|
||||
call append("$", "\t(local to buffer)")
|
||||
call <SID>OptionL("fo")
|
||||
call append("$", "formatlistpat\tpattern to recognize a numbered list")
|
||||
call append("$", "\t(local to buffer)")
|
||||
call <SID>OptionL("flp")
|
||||
if has("insert_expand")
|
||||
call append("$", "complete\tspecifies how Insert mode completion works")
|
||||
call append("$", "\t(local to buffer)")
|
||||
|
||||
Reference in New Issue
Block a user