diff options
author | Bram Moolenaar <Bram@vim.org> | 2011-06-19 05:09:16 +0200 |
---|---|---|
committer | Bram Moolenaar <Bram@vim.org> | 2011-06-19 05:09:16 +0200 |
commit | 251e19127170e7387da1f10b9c99c957b16477fc (patch) | |
tree | b286383f88539796b7ce8d724cf9872f8910bf72 /runtime/doc | |
parent | d6761c3cdf9d15c0f64253dcd8049ff9f25aa987 (diff) |
Updated runtime files.
Diffstat (limited to 'runtime/doc')
-rw-r--r-- | runtime/doc/autocmd.txt | 2 | ||||
-rw-r--r-- | runtime/doc/change.txt | 34 | ||||
-rw-r--r-- | runtime/doc/eval.txt | 63 | ||||
-rw-r--r-- | runtime/doc/filetype.txt | 7 | ||||
-rw-r--r-- | runtime/doc/if_cscop.txt | 21 | ||||
-rw-r--r-- | runtime/doc/indent.txt | 32 | ||||
-rw-r--r-- | runtime/doc/map.txt | 23 | ||||
-rw-r--r-- | runtime/doc/motion.txt | 4 | ||||
-rw-r--r-- | runtime/doc/options.txt | 22 | ||||
-rw-r--r-- | runtime/doc/os_win32.txt | 15 | ||||
-rw-r--r-- | runtime/doc/pattern.txt | 5 | ||||
-rw-r--r-- | runtime/doc/pi_getscript.txt | 46 | ||||
-rw-r--r-- | runtime/doc/pi_netrw.txt | 80 | ||||
-rw-r--r-- | runtime/doc/pi_tar.txt | 18 | ||||
-rw-r--r-- | runtime/doc/pi_vimball.txt | 22 | ||||
-rw-r--r-- | runtime/doc/pi_zip.txt | 15 | ||||
-rw-r--r-- | runtime/doc/quickref.txt | 5 | ||||
-rw-r--r-- | runtime/doc/spell.txt | 4 | ||||
-rw-r--r-- | runtime/doc/tags | 62 | ||||
-rw-r--r-- | runtime/doc/todo.txt | 135 | ||||
-rw-r--r-- | runtime/doc/usr_41.txt | 4 | ||||
-rw-r--r-- | runtime/doc/various.txt | 4 |
22 files changed, 393 insertions, 230 deletions
diff --git a/runtime/doc/autocmd.txt b/runtime/doc/autocmd.txt index 145ecf624b..40949bb1ec 100644 --- a/runtime/doc/autocmd.txt +++ b/runtime/doc/autocmd.txt @@ -1,4 +1,4 @@ -*autocmd.txt* For Vim version 7.3. Last change: 2011 Apr 26 +*autocmd.txt* For Vim version 7.3. Last change: 2011 May 19 VIM REFERENCE MANUAL by Bram Moolenaar diff --git a/runtime/doc/change.txt b/runtime/doc/change.txt index 33599380db..1f92224cf1 100644 --- a/runtime/doc/change.txt +++ b/runtime/doc/change.txt @@ -1,4 +1,4 @@ -*change.txt* For Vim version 7.3. Last change: 2011 May 17 +*change.txt* For Vim version 7.3. Last change: 2011 Jun 19 VIM REFERENCE MANUAL by Bram Moolenaar @@ -717,11 +717,13 @@ Otherwise it works on whole lines anyway. *sub-replace-special* *:s\=* When the {string} starts with "\=" it is evaluated as an expression, see -|sub-replace-expression|. You can use that for any special characters. +|sub-replace-expression|. You can use that for complex replacement or special +characters. + Otherwise these characters in {string} have a special meaning: *:s%* When {string} is equal to "%" and '/' is included with the 'cpoptions' option, -then the {string} of the previous substitute command is used. |cpo-/| +then the {string} of the previous substitute command is used, see |cpo-/| magic nomagic action ~ & \& replaced with the whole matched pattern *s/\&* @@ -756,6 +758,14 @@ magic nomagic action ~ \x where x is any character not mentioned above: Reserved for future expansion +The special meaning is also used inside the third argument {sub} of +the |substitute()| function with the following exceptions: + - A % inserts a percent literally without regard to 'cpoptions'. + - magic is always set without regard to 'magic'. + - A ~ inserts a tilde literally. + - <CR> and \r inserts a carriage-return (CTRL-M). + - \<CR> does not have a special meaning. it's just one of \x. + Examples: > :s/a\|b/xxx\0xxx/g modifies "a b" to "xxxaxxx xxxbxxx" :s/\([abc]\)\([efg]\)/\2\1/g modifies "af fa bg" to "fa fa gb" @@ -787,17 +797,19 @@ either the first or second pattern in parentheses did not match, so either Substitute with an expression *sub-replace-expression* *sub-replace-\=* When the substitute string starts with "\=" the remainder is interpreted as an -expression. This does not work recursively: a substitute() function inside +expression. This does not work recursively: a |substitute()| function inside the expression cannot use "\=" for the substitute string. The special meaning for characters as mentioned at |sub-replace-special| does -not apply except for "<CR>", "\<CR>" and "\\". Thus in the result of the -expression you need to use two backslashes to get one, put a backslash before a -<CR> you want to insert, and use a <CR> without a backslash where you want to -break the line. - -For convenience a <NL> character is also used as a line break. Prepend a -backslash to get a real <NL> character (which will be a NUL in the file). +not apply except for "<CR>". A <NL> character is used as a line break, you +can get one with a double-quote string: "\n". Prepend a backslash to get a +real <NL> character (which will be a NUL in the file). + +The "\=" notation can also be used inside the third argument {sub} of +|substitute()| function. In this case, the special meaning for characters as +mentioned at |sub-replace-special| does not apply at all. Especially, <CR> and +<NL> are interpreted not as a line break but as a carriage-return and a +new-line respectively. When the result is a |List| then the items are joined with separating line breaks. Thus each item becomes a line, except that they can contain line diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index 01a59bf82f..bcc7fa3519 100644 --- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -1,4 +1,4 @@ -*eval.txt* For Vim version 7.3. Last change: 2011 May 17 +*eval.txt* For Vim version 7.3. Last change: 2011 Jun 19 VIM REFERENCE MANUAL by Bram Moolenaar @@ -721,7 +721,8 @@ if it evaluates to true. *expr-<#* *expr-<=#* *expr-=~#* *expr-!~#* *expr-==?* *expr-!=?* *expr->?* *expr->=?* *expr-<?* *expr-<=?* *expr-=~?* *expr-!~?* - *expr-is* + *expr-is* *expr-isnot* *expr-is#* *expr-isnot#* + *expr-is?* *expr-isnot?* use 'ignorecase' match case ignore case ~ equal == ==# ==? not equal != !=# !=? @@ -731,8 +732,8 @@ smaller than < <# <? smaller than or equal <= <=# <=? regexp matches =~ =~# =~? regexp doesn't match !~ !~# !~? -same instance is -different instance isnot +same instance is is# is? +different instance isnot isnot# isnot? Examples: "abc" ==# "Abc" evaluates to 0 @@ -753,12 +754,14 @@ recursively. Ignoring case means case is ignored when comparing item values. A |Funcref| can only be compared with a |Funcref| and only "equal" and "not equal" can be used. Case is never ignored. -When using "is" or "isnot" with a |List| this checks if the expressions are -referring to the same |List| instance. A copy of a |List| is different from -the original |List|. When using "is" without a |List| it is equivalent to -using "equal", using "isnot" equivalent to using "not equal". Except that a -different type means the values are different. "4 == '4'" is true, "4 is '4'" -is false. +When using "is" or "isnot" with a |List| or a |Dictionary| this checks if the +expressions are referring to the same |List| or |Dictionary| instance. A copy +of a |List| is different from the original |List|. When using "is" without +a |List| or a |Dictionary| it is equivalent to using "equal", using "isnot" +equivalent to using "not equal". Except that a different type means the +values are different: "4 == '4'" is true, "4 is '4'" is false and "0 is []" is +false and not a error. "is#"/"isnot#" and "is?"/"isnot?" can be used to match +and ignore case. When comparing a String with a Number, the String is converted to a Number, and the comparison is done on Numbers. This means that "0 == 'x'" is TRUE, @@ -1293,7 +1296,7 @@ v:beval_winnr The number of the window, over which the mouse pointer is. Only *v:char* *char-variable* v:char Argument for evaluating 'formatexpr' and used for the typed character when using <expr> in an abbreviation |:map-<expr>|. - It is also used by the |InsertPreChar| event. + It is also used by the |InsertCharPre| event. *v:charconvert_from* *charconvert_from-variable* v:charconvert_from @@ -1943,7 +1946,7 @@ strridx( {haystack}, {needle} [, {start}]) Number last index of {needle} in {haystack} strtrans( {expr}) String translate string to make it printable strwidth( {expr}) Number display cell length of the String {expr} -submatch( {nr}) String specific match in ":substitute" +submatch( {nr}) String specific match in ":s" or substitute() substitute( {expr}, {pat}, {sub}, {flags}) String all {pat} in {expr} replaced with {sub} synID( {lnum}, {col}, {trans}) Number syntax ID at {lnum} and {col} @@ -5557,9 +5560,11 @@ strwidth({expr}) *strwidth()* Also see |strlen()|, |strdisplaywidth()| and |strchars()|. submatch({nr}) *submatch()* - Only for an expression in a |:substitute| command. Returns - the {nr}'th submatch of the matched text. When {nr} is 0 - the whole matched text is returned. + Only for an expression in a |:substitute| command or + substitute() function. + Returns the {nr}'th submatch of the matched text. When {nr} + is 0 the whole matched text is returned. + Also see |sub-replace-expression|. Example: > :s/\d\+/\=submatch(0) + 1/ < This finds the first number in the line and adds one to it. @@ -5567,27 +5572,32 @@ submatch({nr}) *submatch()* substitute({expr}, {pat}, {sub}, {flags}) *substitute()* The result is a String, which is a copy of {expr}, in which - the first match of {pat} is replaced with {sub}. This works - like the ":substitute" command (without any flags). But the - matching with {pat} is always done like the 'magic' option is - set and 'cpoptions' is empty (to make scripts portable). - 'ignorecase' is still relevant. 'smartcase' is not used. - See |string-match| for how {pat} is used. - And a "~" in {sub} is not replaced with the previous {sub}. + the first match of {pat} is replaced with {sub}. + When {flags} is "g", all matches of {pat} in {expr} are + replaced. Otherwise {flags} should be "". + + This works like the ":substitute" command (without any flags). + But the matching with {pat} is always done like the 'magic' + option is set and 'cpoptions' is empty (to make scripts + portable). 'ignorecase' is still relevant. 'smartcase' is + not used. See |string-match| for how {pat} is used. + + A "~" in {sub} is not replaced with the previous {sub}. Note that some codes in {sub} have a special meaning |sub-replace-special|. For example, to replace something with "\n" (two characters), use "\\\\n" or '\\n'. + When {pat} does not match in {expr}, {expr} is returned unmodified. - When {flags} is "g", all matches of {pat} in {expr} are - replaced. Otherwise {flags} should be "". + Example: > :let &path = substitute(&path, ",\\=[^,]*$", "", "") < This removes the last component of the 'path' option. > :echo substitute("testing", ".*", "\\U\\0", "") < results in "TESTING". - The {sub} argument can start with \=, just like with - |:substitute|. Example: > + + When {sub} starts with "\=", the remainder is interpreted as + an expression. See |sub-replace-expression|. Example: > :echo substitute(s, '%\(\x\x\)', \ '\=nr2char("0x" . submatch(1))', 'g') @@ -6226,7 +6236,6 @@ netbeans_enabled Compiled with support for |netbeans| and connected. netbeans_intg Compiled with support for |netbeans|. ole Compiled with OLE automation support for Win32. os2 OS/2 version of Vim. -osfiletype Compiled with support for osfiletypes |+osfiletype| path_extra Compiled with up/downwards search in 'path' and 'tags' perl Compiled with Perl interface. persistent_undo Compiled with support for persistent undo history. diff --git a/runtime/doc/filetype.txt b/runtime/doc/filetype.txt index c76adfc77e..67a5c147fb 100644 --- a/runtime/doc/filetype.txt +++ b/runtime/doc/filetype.txt @@ -1,4 +1,4 @@ -*filetype.txt* For Vim version 7.3. Last change: 2008 Jul 15 +*filetype.txt* For Vim version 7.3. Last change: 2011 Jun 19 VIM REFERENCE MANUAL by Bram Moolenaar @@ -270,6 +270,9 @@ directories! *autocmd-osfiletypes* +NOTE: this code is currently disabled, as the RISC OS implementation was +removed. In the future this will use the 'filetype' option. + On operating systems which support storing a file type with the file, you can specify that an autocommand should only be executed if the file is of a certain type. @@ -296,8 +299,6 @@ must both match): > This will match files of type "&fff" whose names start with "diff". -Note that osfiletype checking is skipped if Vim is compiled without the -|+osfiletype| feature. *plugin-details* The "plugin" directory can be in any of the directories in the 'runtimepath' diff --git a/runtime/doc/if_cscop.txt b/runtime/doc/if_cscop.txt index f3f1a49702..5adb1e77f8 100644 --- a/runtime/doc/if_cscop.txt +++ b/runtime/doc/if_cscop.txt @@ -1,4 +1,4 @@ -*if_cscop.txt* For Vim version 7.3. Last change: 2010 Sep 29 +*if_cscop.txt* For Vim version 7.3. Last change: 2011 Jun 12 VIM REFERENCE MANUAL by Andy Kahn @@ -264,19 +264,20 @@ seems to be useful: > :set cscopequickfix=s-,c-,d-,i-,t-,e- < *cscopetag* *cst* -If 'cscopetag' set, the commands ":tag" and CTRL-] as well as "vim -t" will -always use |:cstag| instead of the default :tag behavior. Effectively, by -setting 'cst', you will always search your cscope databases as well as your -tag files. The default is off. Examples: > +If 'cscopetag' is set, the commands ":tag" and CTRL-] as well as "vim -t" +will always use |:cstag| instead of the default :tag behavior. Effectively, +by setting 'cst', you will always search your cscope databases as well as +your tag files. The default is off. Examples: > :set cst :set nocst < *cscoperelative* *csre* -If 'cscoperelative' set, then in absence of a prefix given to cscope (prefx -is the argument to -P option of cscope), basename of cscope.out location -(usually the project root directory) will be used as the prefix to construt -absolute path.The default is off. Note: This option is only effective when -cscope (cscopeprg) is initialized without a prefix path (-P). Examples: > +If 'cscoperelative' is set, then in absence of a prefix given to cscope +(prefix is the argument of -P option of cscope), basename of cscope.out +location (usually the project root directory) will be used as the prefix +to construct an absolute path. The default is off. Note: This option is +only effective when cscope (cscopeprg) is initialized without a prefix +path (-P). Examples: > :set csre :set nocsre < diff --git a/runtime/doc/indent.txt b/runtime/doc/indent.txt index f2600d3ce2..44c76c2d9f 100644 --- a/runtime/doc/indent.txt +++ b/runtime/doc/indent.txt @@ -1,4 +1,4 @@ -*indent.txt* For Vim version 7.3. Last change: 2011 Apr 25 +*indent.txt* For Vim version 7.3. Last change: 2011 May 31 VIM REFERENCE MANUAL by Bram Moolenaar @@ -561,13 +561,15 @@ REMARKS ABOUT SPECIFIC INDENT FILES ~ FORTRAN *ft-fortran-indent* -Block if, select case, and where constructs are indented. Comments, labelled -statements and continuation lines are indented if the Fortran is in free -source form, whereas they are not indented if the Fortran is in fixed source -form because of the left margin requirements. Hence manual indent corrections -will be necessary for labelled statements and continuation lines when fixed -source form is being used. For further discussion of the method used for the -detection of source format see |ft-fortran-syntax|. +Block if, select case, where, and forall constructs are indented. So are +type, interface, associate, block, and enum constructs. The indenting of +subroutines, functions, modules, and program blocks is optional. Comments, +labelled statements and continuation lines are indented if the Fortran is in +free source form, whereas they are not indented if the Fortran is in fixed +source form because of the left margin requirements. Hence manual indent +corrections will be necessary for labelled statements and continuation lines +when fixed source form is being used. For further discussion of the method +used for the detection of source format see |ft-fortran-syntax|. Do loops ~ All do loops are left unindented by default. Do loops can be unstructured in @@ -594,6 +596,20 @@ autocommand such as > to get do loops indented in .f90 files and left alone in Fortran files with other extensions such as .for. +Program units ~ +The indenting of program units (subroutines, functions, modules, and program +blocks) is enabled by default but can be suppressed if a lighter, screen-width +preserving indent style is desired. To suppress the indenting of program +units for all fortran files set the global fortran_indent_less variable in +your .vimrc as follows > + + let fortran_indent_less=1 + +A finer level of suppression can be achieved by setting the corresponding +buffer-local variable as follows > + + let b:fortran_indent_less=1 + PHP *ft-php-indent* *php-indent* *php-indenting* diff --git a/runtime/doc/map.txt b/runtime/doc/map.txt index ceb29013d0..103cb54bbe 100644 --- a/runtime/doc/map.txt +++ b/runtime/doc/map.txt @@ -1,4 +1,4 @@ -*map.txt* For Vim version 7.3. Last change: 2011 May 10 +*map.txt* For Vim version 7.3. Last change: 2011 Jun 13 VIM REFERENCE MANUAL by Bram Moolenaar @@ -107,6 +107,8 @@ modes. :cmapc[lear] |mapmode-c| *:cmapc* *:cmapclear* Remove ALL mappings for the modes where the map command applies. {not in Vi} + Use the <buffer> argument to remove buffer-local + mappings |:map-<buffer>| Warning: This also removes the default mappings. :map |mapmode-nvo| @@ -934,11 +936,12 @@ See |:verbose-cmd| for more information. avoid that a typed {lhs} is expanded, since command-line abbreviations apply here. -:ab[breviate] [<expr>] {lhs} {rhs} +:ab[breviate] [<expr>] [<buffer>] {lhs} {rhs} add abbreviation for {lhs} to {rhs}. If {lhs} already existed it is replaced with the new {rhs}. {rhs} may contain spaces. See |:map-<expr>| for the optional <expr> argument. + See |:map-<buffer>| for the optional <buffer> argument. *:una* *:unabbreviate* :una[bbreviate] {lhs} Remove abbreviation for {lhs} from the list. If none @@ -948,12 +951,12 @@ See |:verbose-cmd| for more information. expansion insert a CTRL-V (type it twice). *:norea* *:noreabbrev* -:norea[bbrev] [<expr>] [lhs] [rhs] +:norea[bbrev] [<expr>] [<buffer>] [lhs] [rhs] same as ":ab", but no remapping for this {rhs} {not in Vi} *:ca* *:cabbrev* -:ca[bbrev] [<expr>] [lhs] [rhs] +:ca[bbrev] [<expr>] [<buffer>] [lhs] [rhs] same as ":ab", but for Command-line mode only. {not in Vi} @@ -962,12 +965,12 @@ See |:verbose-cmd| for more information. in Vi} *:cnorea* *:cnoreabbrev* -:cnorea[bbrev] [<expr>] [lhs] [rhs] +:cnorea[bbrev] [<expr>] [<buffer>] [lhs] [rhs] same as ":ab", but for Command-line mode only and no remapping for this {rhs} {not in Vi} *:ia* *:iabbrev* -:ia[bbrev] [<expr>] [lhs] [rhs] +:ia[bbrev] [<expr>] [<buffer>] [lhs] [rhs] same as ":ab", but for Insert mode only. {not in Vi} *:iuna* *:iunabbrev* @@ -975,18 +978,18 @@ See |:verbose-cmd| for more information. Vi} *:inorea* *:inoreabbrev* -:inorea[bbrev] [<expr>] [lhs] [rhs] +:inorea[bbrev] [<expr>] [<buffer>] [lhs] [rhs] same as ":ab", but for Insert mode only and no remapping for this {rhs} {not in Vi} *:abc* *:abclear* -:abc[lear] Remove all abbreviations. {not in Vi} +:abc[lear] [<buffer>] Remove all abbreviations. {not in Vi} *:iabc* *:iabclear* -:iabc[lear] Remove all abbreviations for Insert mode. {not in Vi} +:iabc[lear] [<buffer>] Remove all abbreviations for Insert mode. {not in Vi} *:cabc* *:cabclear* -:cabc[lear] Remove all abbreviations for Command-line mode. {not +:cabc[lear] [<buffer>] Remove all abbreviations for Command-line mode. {not in Vi} *using_CTRL-V* diff --git a/runtime/doc/motion.txt b/runtime/doc/motion.txt index 04d77feff6..d8a8906223 100644 --- a/runtime/doc/motion.txt +++ b/runtime/doc/motion.txt @@ -1,4 +1,4 @@ -*motion.txt* For Vim version 7.3. Last change: 2010 May 14 +*motion.txt* For Vim version 7.3. Last change: 2011 Jun 02 VIM REFERENCE MANUAL by Bram Moolenaar @@ -344,6 +344,8 @@ gg Goto line [count], default first line, on the first last number in it used as the byte count. End-of-line characters are counted depending on the current 'fileformat' setting. + Also see the |line2byte()| function, and the 'o' + option in 'statusline'. {not in Vi} {not available when compiled without the |+byte_offset| feature} diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index 5759760a1c..91623c10fe 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 7.3. Last change: 2011 May 17 +*options.txt* For Vim version 7.3. Last change: 2011 Jun 12 VIM REFERENCE MANUAL by Bram Moolenaar @@ -2933,8 +2933,6 @@ A jump table for the options with a short description can be found at |Q_op|. This will use the "c" filetype first, then the "doxygen" filetype. This works both for filetype plugins and for syntax files. More than one dot may appear. - Do not confuse this option with 'osfiletype', which is for the file - type that is actually stored with the file. This option is not copied to another buffer, independent of the 's' or 'S' flag in 'cpoptions'. Only normal file name characters can be used, "/\*?[|<>" are illegal. @@ -3405,7 +3403,7 @@ A jump table for the options with a short description can be found at |Q_op|. :highlight Cursor gui=NONE guifg=bg guibg=fg < *'guifont'* *'gfn'* - *E235* *E596* *E610* *E611* + *E235* *E596* 'guifont' 'gfn' string (default "") global {not in Vi} @@ -5123,20 +5121,12 @@ A jump table for the options with a short description can be found at |Q_op|. security reasons. - *'osfiletype'* *'oft'* *E366* -'osfiletype' 'oft' string (RISC-OS default: "Text", - others default: "") + *'osfiletype'* *'oft'* +'osfiletype' 'oft' string (default: "") local to buffer {not in Vi} - {only available when compiled with the |+osfiletype| - feature} - Some operating systems store extra information about files besides - name, datestamp and permissions. This option contains the extra - information, the nature of which will vary between systems. - The value of this option is usually set when the file is loaded, and - is used to set the operating system file type when file is written. - It can affect the pattern matching of the automatic commands. - |autocmd-osfiletypes| + This option was supported on RISC OS, which has been removed. + *'paragraphs'* *'para'* 'paragraphs' 'para' string (default "IPLPPPQPP TPHPLIPpLpItpplpipbp") diff --git a/runtime/doc/os_win32.txt b/runtime/doc/os_win32.txt index 7f224f82af..92e85c77bc 100644 --- a/runtime/doc/os_win32.txt +++ b/runtime/doc/os_win32.txt @@ -1,4 +1,4 @@ -*os_win32.txt* For Vim version 7.3. Last change: 2010 Dec 19 +*os_win32.txt* For Vim version 7.3. Last change: 2011 May 28 VIM REFERENCE MANUAL by George Reilly @@ -321,13 +321,14 @@ A. When using :! to run an external command, you can run it with "start": > Q. How do I avoid getting a window for programs that I run asynchronously? A. You have two possible solutions depending on what exactly do you want: - 1) You may use the /min flag that would run program in minimized state with - no other changes. It will work equally for console and GUI applications. - 2) You can use /b flag to run console applications without creating a + 1) You may use the /min flag in order to run program in a minimized state + with no other changes. It will work equally for console and GUI + applications. + 2) You can use the /b flag to run console applications without creating a console window for them (GUI applications are not affected). But you - should use this flag only if application you run doesn't require any - input. Otherwise it will get an EOF error because it's input stream - (stdin) would be redirected to \\.\NUL (stdour and stderr too). + should use this flag only if the application you run doesn't require any + input. Otherwise it will get an EOF error because its input stream + (stdin) would be redirected to \\.\NUL (stdoud and stderr too). Example for a console application, run Exuberant ctags: > :!start /min ctags -R . diff --git a/runtime/doc/pattern.txt b/runtime/doc/pattern.txt index 84cd7360a0..9930a3b80b 100644 --- a/runtime/doc/pattern.txt +++ b/runtime/doc/pattern.txt @@ -1,4 +1,4 @@ -*pattern.txt* For Vim version 7.3. Last change: 2011 Apr 28 +*pattern.txt* For Vim version 7.3. Last change: 2011 May 25 VIM REFERENCE MANUAL by Bram Moolenaar @@ -635,7 +635,8 @@ overview. Like '(?!pattern)" in Perl. Example matches ~ foo\(bar\)\@! any "foo" not followed by "bar" - a.\{-}p\@! "a", "ap", "app", etc. not followed by a "p" + a.\{-}p\@! "a", "ap", "aap", "app", etc. not immediately + followed by a "p" if \(\(then\)\@!.\)*$ "if " not followed by "then" Using "\@!" is tricky, because there are many places where a pattern diff --git a/runtime/doc/pi_getscript.txt b/runtime/doc/pi_getscript.txt index 8d4e4719c0..86e3cdd0ce 100644 --- a/runtime/doc/pi_getscript.txt +++ b/runtime/doc/pi_getscript.txt @@ -1,11 +1,11 @@ -*pi_getscript.txt* For Vim version 7.3. Last change: 2009 Oct 14 +*pi_getscript.txt* For Vim version 7.0. Last change: 2011 May 31 > GETSCRIPT REFERENCE MANUAL by Charles E. Campbell, Jr. < Authors: Charles E. Campbell, Jr. <NdrOchip@ScampbellPfamilyA.Mbiz> (remove NOSPAM from the email address) *GetLatestVimScripts-copyright* -Copyright: (c) 2004-2009 by Charles E. Campbell, Jr. *glvs-copyright* +Copyright: (c) 2004-2010 by Charles E. Campbell, Jr. *glvs-copyright* The VIM LICENSE applies to getscript.vim and pi_getscript.txt (see |copyright|) except use "getscript" instead of "Vim". No warranty, express or implied. @@ -77,7 +77,9 @@ Your computer needs to have wget or curl for GetLatestVimScripts to do its work. 3. GetLatestVimScripts Usage *glvs-usage* *:GLVS* Unless it has been defined elsewhere, > + :GLVS + will invoke GetLatestVimScripts(). If some other plugin has defined that command, then you may type > @@ -127,7 +129,8 @@ click on the script's link, you'll see a line resembling http://vim.sourceforge.net/scripts/script.php?script_id=40 The "40" happens to be a ScriptID that GetLatestVimScripts needs to -download the associated page. +download the associated page, and is assigned by vim.sf.net itself +during initial uploading of the plugin. The second number on each line gives the script's SourceID. The SourceID records the count of uploaded scripts as determined by vim.sf.net; hence it @@ -151,19 +154,39 @@ This comment line tells getscript.vim to check vimscript #884 and that the script is automatically installable. Getscript will also use this line to help build the GetLatestVimScripts.dat file, by including a line such as: > - 884 1 AutoAlign.vim + 884 1 :AutoInstall: AutoAlign.vim < -in it an AutoAlign.vim line isn't already in GetLatestVimScripts.dat file. +assuming that such a line isn't already in GetLatestVimScripts.dat file. See |glvs-plugins| for more. Thus, GetLatestVimScripts thus provides a comprehensive ability to keep your plugins up-to-date! +In summary: + + * Optionally tell getscript that it is allowed to build/append a + GetLatestVimScripts.dat file based upon already installed plugins: > + let g:GetLatestVimScripts_allowautoinstall=1 +< + * A line such as > + " GetLatestVimScripts: 884 1 :AutoInstall: AutoAlign.vim +< in an already-downloaded plugin constitutes the concurrence of the + plugin author that getscript may do AutoInstall. Not all plugins + may be AutoInstall-able, and the plugin's author is best situated + to know whether or not his/her plugin will AutoInstall properly. + + * A line such as > + 884 1 :AutoInstall: AutoAlign.vim +< in your GetLatestVimScripts.dat file constitutes your permission + to getscript to do AutoInstall. AutoInstall requires both your + and the plugin author's permission. See |GetLatestVimScripts_dat|. + + *GetLatestVimScripts_dat* As an example of a <GetLatestVimScripts.dat> file: > ScriptID SourceID Filename -------------------------- - 294 1 Align.vim - 120 2 decho.vim + 294 1 :AutoInstall: Align.vim + 120 2 Decho.vim 40 3 DrawIt.tar.gz 451 4 EasyAccents.vim 195 5 engspchk.vim @@ -201,8 +224,8 @@ are, then you may include :AutoInstall: just before "yourscriptname": ^ scriptid < -NOTE: :AutoInstall: is a plugin-author option, not a GetLatestVimScripts.dat~ - entry!~ +NOTE: The :AutoInstall: feature requires both the plugin author's and~ + the user's permission to operate!~ GetLatestVimScripts commands for those scripts are then appended, if not already present, to the user's GetLatest/GetLatestVimScripts.dat file. It is @@ -210,7 +233,7 @@ a relatively painless way to automate the acquisition of any scripts your plugins depend upon. Now, as an author, you probably don't want GetLatestVimScripts to download -your own scripts for you yourself, thereby overwriting your not-yet-released +your own scripts atop your own copy, thereby overwriting your not-yet-released hard work. GetLatestVimScripts provides a solution for this: put > 0 0 yourscriptname @@ -351,6 +374,9 @@ The AutoInstall process will: ============================================================================== 9. GetLatestVimScripts History *getscript-history* *glvs-hist* {{{1 +v33 May 31, 2011 : * using fnameescape() instead of escape() + * *.xz support +v32 Jun 19, 2010 : * (Jan Steffens) added support for xz compression v31 Jun 29, 2008 : * (Bill McCarthy) fixed having hls enabled with getscript * (David Schaefer) the acd option interferes with vimballs Solution: bypass the acd option diff --git a/runtime/doc/pi_netrw.txt b/runtime/doc/pi_netrw.txt index ae4a870507..1ee4b6a525 100644 --- a/runtime/doc/pi_netrw.txt +++ b/runtime/doc/pi_netrw.txt @@ -1,4 +1,4 @@ -*pi_netrw.txt* For Vim version 7.3. Last change: 2011 Apr 01 +*pi_netrw.txt* For Vim version 7.3. Last change: 2011 May 31 ----------------------------------------------------- NETRW REFERENCE MANUAL by Charles E. Campbell, Jr. @@ -273,7 +273,7 @@ SOURCING *netrw-source* {{{2 :Nsource "scp://[user@]machine[[:#]port]/path" uses scp :Nsource "sftp://[user@]machine/path" uses sftp -DIRECTORY LISTING *netrw-dirlist* {{{2 +DIRECTORY LISTING *netrw-trailingslash* *netrw-dirlist* {{{2 One may browse a directory to get a listing by simply attempting to edit the directory: > @@ -281,14 +281,15 @@ DIRECTORY LISTING *netrw-dirlist* {{{2 :e scp://[user]@hostname/path/ :e ftp://[user]@hostname/path/ < - For remote directories (ie. those using scp or ftp), that trailing - "/" is necessary (the slash tells netrw to treat the argument as a - directory to browse instead of a file to download). + For remote directory listings (ie. those using scp or ftp), that + trailing "/" is necessary (the slash tells netrw to treat the argument + as a directory to browse instead of as a file to download). - However, the Nread command can also be used to accomplish this: - - :Nread [protocol]://[user]@hostname/path/ + The Nread command may also be used to accomplish this (again, that + trailing slash is necessary): > + :Nread [protocol]://[user]@hostname/path/ +< *netrw-login* *netrw-password* CHANGING USERID AND PASSWORD *netrw-chgup* *netrw-userpass* {{{2 @@ -2158,8 +2159,8 @@ your browsing preferences. (see also: |netrw-settings|) *g:netrw_mkdir_cmd* command for making a remote directory default: "ssh USEPORT HOSTNAME mkdir" - *g:netrw_mousemaps* =1 (default) enables the mouse buttons - while browsing: + *g:netrw_mousemaps* =1 (default) enables mouse buttons while + browsing to: leftmouse : open file/directory shift-leftmouse : mark file middlemouse : same as P @@ -2274,8 +2275,11 @@ your browsing preferences. (see also: |netrw-settings|) *g:netrw_winsize* specify initial size of new windows made with "o" (see |netrw-o|), "v" (see |netrw-v|), - |:Hexplore| or |:Vexplore|. - default: "" + |:Hexplore| or |:Vexplore|. The g:netrw_winsize + is an integer describing the percentage of the + current netrw buffer's window to be used for + the new window. + default: 50 (for 50%) *g:netrw_xstrlen* Controls how netrw computes string lengths, including multi-byte characters' string @@ -2660,7 +2664,7 @@ Associated setting variables: |g:netrw_chgwin| *netrw-p11* P11. I want to have two windows; a thin one on the left and my editing - window on the right. How can I do this? + window on the right. How may I accomplish this? * Put the following line in your <.vimrc>: let g:netrw_altv = 1 @@ -2706,7 +2710,45 @@ Associated setting variables: |g:netrw_chgwin| "let g:netrw_sftp_cmd = "d:\\dev\\putty\\PSFTP.exe" "let g:netrw_scp_cmd = "d:\\dev\\putty\\PSCP.exe" < + *netrw-p14* + P14. I'd would like to speed up writes using Nwrite and |