diff options
Diffstat (limited to 'runtime')
| -rw-r--r-- | runtime/doc/change.txt | 12 | ||||
| -rw-r--r-- | runtime/doc/index.txt | 3 | ||||
| -rw-r--r-- | runtime/doc/options.txt | 20 | ||||
| -rw-r--r-- | runtime/doc/quickfix.txt | 63 | ||||
| -rw-r--r-- | runtime/doc/tags | 5 | ||||
| -rw-r--r-- | runtime/doc/todo.txt | 43 | ||||
| -rw-r--r-- | runtime/doc/version7.txt | 11 | ||||
| -rw-r--r-- | runtime/optwin.vim | 5 |
8 files changed, 120 insertions, 42 deletions
diff --git a/runtime/doc/change.txt b/runtime/doc/change.txt index 08fdc1d54..4ed7200ff 100644 --- a/runtime/doc/change.txt +++ b/runtime/doc/change.txt @@ -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 diff --git a/runtime/doc/index.txt b/runtime/doc/index.txt index 9350cf860..a0bc07b63 100644 --- a/runtime/doc/index.txt +++ b/runtime/doc/index.txt @@ -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 diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index c9baebe85..a43e24ee8 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -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". diff --git a/runtime/doc/quickfix.txt b/runtime/doc/quickfix.txt index 4f8174b07..23a714661 100644 --- a/runtime/doc/quickfix.txt +++ b/runtime/doc/quickfix.txt @@ -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. diff --git a/runtime/doc/tags b/runtime/doc/tags index ee4d28feb..51755a18b 100644 --- a/runtime/doc/tags +++ b/runtime/doc/tags @@ -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* diff --git a/runtime/doc/todo.txt b/runtime/doc/todo.txt index 426bef60b..7abbd5bdc 100644 --- a/runtime/doc/todo.txt +++ b/runtime/doc/todo.txt @@ -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 diff --git a/runtime/doc/version7.txt b/runtime/doc/version7.txt index 41706e9ab..39d094657 100644 --- a/runtime/doc/version7.txt +++ b/runtime/doc/version7.txt @@ -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: diff --git a/runtime/optwin.vim b/runtime/optwin.vim index c16f5fafc..adf9fdf8a 100644 --- a/runtime/optwin.vim +++ b/runtime/optwin.vim @@ -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)") |