diff options
author | Bram Moolenaar <Bram@vim.org> | 2004-06-20 12:51:53 +0000 |
---|---|---|
committer | Bram Moolenaar <Bram@vim.org> | 2004-06-20 12:51:53 +0000 |
commit | 69a7cb473ceae109b61fae9aa04ee0c29afba5d9 (patch) | |
tree | 04bd3292cc6c2317842d7a46ae3ab11e9956ed99 /runtime/doc | |
parent | ed20346f0b81d1d89c22c9616abe8e47b4c17f08 (diff) |
updated for version 7.0002v7.0002
Diffstat (limited to 'runtime/doc')
-rw-r--r-- | runtime/doc/change.txt | 11 | ||||
-rw-r--r-- | runtime/doc/editing.txt | 7 | ||||
-rw-r--r-- | runtime/doc/eval.txt | 25 | ||||
-rw-r--r-- | runtime/doc/farsi.txt | 6 | ||||
-rw-r--r-- | runtime/doc/index.txt | 6 | ||||
-rw-r--r-- | runtime/doc/insert.txt | 4 | ||||
-rw-r--r-- | runtime/doc/mbyte.txt | 6 | ||||
-rw-r--r-- | runtime/doc/motion.txt | 35 | ||||
-rw-r--r-- | runtime/doc/netbeans.txt | 6 | ||||
-rw-r--r-- | runtime/doc/os_mac.txt | 17 | ||||
-rw-r--r-- | runtime/doc/os_vms.txt | 4 | ||||
-rw-r--r-- | runtime/doc/pi_netrw.txt | 322 | ||||
-rw-r--r-- | runtime/doc/quickfix.txt | 4 | ||||
-rw-r--r-- | runtime/doc/recover.txt | 4 | ||||
-rw-r--r-- | runtime/doc/sponsor.txt | 9 | ||||
-rw-r--r-- | runtime/doc/starting.txt | 4 | ||||
-rw-r--r-- | runtime/doc/syntax.txt | 6 | ||||
-rw-r--r-- | runtime/doc/todo.txt | 177 | ||||
-rw-r--r-- | runtime/doc/usr_21.txt | 4 | ||||
-rw-r--r-- | runtime/doc/usr_22.txt | 4 | ||||
-rw-r--r-- | runtime/doc/various.txt | 8 | ||||
-rw-r--r-- | runtime/doc/version5.txt | 14 | ||||
-rw-r--r-- | runtime/doc/version6.txt | 26 |
23 files changed, 409 insertions, 300 deletions
diff --git a/runtime/doc/change.txt b/runtime/doc/change.txt index 63461ee1ae..93c554f33d 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 Jun 15 +*change.txt* For Vim version 7.0aa. Last change: 2004 Jun 16 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1048,7 +1048,7 @@ operation. When something has been dropped onto Vim, the "~ register is filled in and the <Drop> pseudo key is sent for notification. You can remap this key if you want; the default action (for all modes) is to insert the contents of the "~ register at the cursor position. {not in Vi} -{only available when compiled with the |+dnd| feature, curently only with the +{only available when compiled with the |+dnd| feature, currently only with the GTK GUI} Note: The "~ register is only used when dropping plain text onto Vim. @@ -1138,6 +1138,13 @@ gw{motion} Format the lines that {motion} moves over. Similar to the text. However, 'formatprg' is not used. {not in Vi} +gwgw *gwgw* *gww* +gww Format the current line as with "gw". {not in Vi} + + *v_gw* +{Visual}gw Format the highlighted text as with "gw". (for + {Visual} see |Visual-mode|). {not in Vi} + Example: To format the current paragraph use: *gqap* > gqap diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt index 827f78031e..4feef4148b 100644 --- a/runtime/doc/editing.txt +++ b/runtime/doc/editing.txt @@ -1,4 +1,4 @@ -*editing.txt* For Vim version 7.0aa. Last change: 2004 Jun 14 +*editing.txt* For Vim version 7.0aa. Last change: 2004 Jun 17 VIM REFERENCE MANUAL by Bram Moolenaar @@ -340,10 +340,11 @@ directly before the first or just after the last backtick. *`=* You can have the backticks expanded as a Vim expression, instead of -an external command, by using the syntax `={expr}` e.g. > +an external command, by using the syntax `={expr}` e.g.: > :let foo='bar' :e `=foo . ".c" ` -edits "bar.c". Note that the expression cannot contain a backtick. +This will edit "bar.c". The expression can contain just about anything, thus +this can also be used to avoid the special meaning of '"', '|', '%' and '#'. *++opt* *[++opt]* The [++opt] argument can be used to force the value of 'fileformat' or diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index 4685ff5e6a..462d66bd9b 100644 --- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -1,4 +1,4 @@ -*eval.txt* For Vim version 7.0aa. Last change: 2004 May 18 +*eval.txt* For Vim version 7.0aa. Last change: 2004 Jun 20 VIM REFERENCE MANUAL by Bram Moolenaar @@ -515,7 +515,7 @@ Another example that does the same: > command Tick let s:counter = s:counter + 1 | echo s:counter When calling a function and invoking a user-defined command, the context for -script varialbes is set to the script where the function or command was +script variables is set to the script where the function or command was defined. The script variables are also available when a function is defined inside a @@ -972,9 +972,13 @@ browse({save}, {title}, {initdir}, {default}) bufexists({expr}) *bufexists()* The result is a Number, which is non-zero if a buffer called {expr} exists. + If the {expr} argument is a number, buffer numbers are used. If the {expr} argument is a string it must match a buffer name - exactly. - If the {expr} argument is a number buffer numbers are used. + exactly. The name can be: + - Relative to the current directory. + - A full path. + - The name of a buffer with 'filetype' set to "nofile". + - A URL name. Unlisted buffers will be found. Note that help files are listed by their short name in the output of |:buffers|, but bufexists() requires using their @@ -987,12 +991,12 @@ bufexists({expr}) *bufexists()* buflisted({expr}) *buflisted()* The result is a Number, which is non-zero if a buffer called {expr} exists and is listed (has the 'buflisted' option set). - The {expr} argument is used like with bufexists(). + The {expr} argument is used like with |bufexists()|. bufloaded({expr}) *bufloaded()* The result is a Number, which is non-zero if a buffer called {expr} exists and is loaded (shown in a window or hidden). - The {expr} argument is used like with bufexists(). + The {expr} argument is used like with |bufexists()|. bufname({expr}) *bufname()* The result is the name of a buffer, as it is displayed by the @@ -1233,6 +1237,9 @@ executable({expr}) *executable()* This function checks if an executable with the name {expr} exists. {expr} must be the name of the program without any arguments. executable() uses the normal $PATH. + On MS-DOS and MS-Windows the ".exe", ".bat", etc. must be + included. It only checks if the file exists and is not a + directory, not if it's really executable. The result is a Number: 1 exists 0 does not exist @@ -1910,7 +1917,7 @@ line({expr}) The result is a Number, which is the line number of the file This autocommand jumps to the last known position in a file just after opening it, if the '" mark is set: > :au BufReadPost * if line("'\"") > 0 && line("'\"") <= line("$") | exe "normal g'\"" | endif -< + line2byte({lnum}) *line2byte()* Return the byte count from the start of the buffer for line {lnum}. This includes the end-of-line character, depending on @@ -2746,7 +2753,7 @@ fork Compiled to use fork()/exec() instead of system(). gettext Compiled with message translation |multi-lang| gui Compiled with GUI enabled. gui_athena Compiled with Athena GUI. -gui_beos Compiled with BeOs GUI. +gui_beos Compiled with BeOS GUI. gui_gtk Compiled with GTK+ GUI (any version). gui_gtk2 Compiled with GTK+ 2 GUI (gui_gtk is also defined). gui_mac Compiled with Macintosh GUI. @@ -2801,7 +2808,7 @@ scrollbind Compiled with 'scrollbind' support. showcmd Compiled with 'showcmd' support. signs Compiled with |:sign| support. smartindent Compiled with 'smartindent' support. -sniff Compiled with SniFF interface support. +sniff Compiled with SNiFF interface support. statusline Compiled with support for 'statusline', 'rulerformat' and special formats of 'titlestring' and 'iconstring'. sun_workshop Compiled with support for Sun |workshop|. diff --git a/runtime/doc/farsi.txt b/runtime/doc/farsi.txt index 9902709da5..6f32f6e83f 100644 --- a/runtime/doc/farsi.txt +++ b/runtime/doc/farsi.txt @@ -1,4 +1,4 @@ -*farsi.txt* For Vim version 7.0aa. Last change: 2002 Oct 29 +*farsi.txt* For Vim version 7.0aa. Last change: 2004 Jun 16 VIM REFERENCE MANUAL by Mortaza Ghassab Shiran @@ -66,7 +66,7 @@ If the "extra" archive has been unpacked, the following files are found in the subdirectories of the '$VIM/farsi' directory: + far-a01.pcf X Windows fonts for Unix including Linux systems - + far-a01.bf X Windows fonts for SunOs + + far-a01.bf X Windows fonts for SunOS + far-a01.f16 a screen fonts for Unix including Linux systems + far-a01.fon a monospaced fonts for Windows NT/95/98 + far-a01.com a screen fonts for DOS @@ -92,7 +92,7 @@ o Installation of fonts for X Window systems (Unix/Linux) > mkfontdir > xset +fp path_name_of_farsi_fonts_directory -o Installation of fonts for X Window systems (SunOs) +o Installation of fonts for X Window systems (SunOS) Copy far-a01.bf font into a directory of your choice. Change to the directory containing the far-a01.fb fonts and diff --git a/runtime/doc/index.txt b/runtime/doc/index.txt index 791e5ba363..77fe085b5b 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 May 24 +*index.txt* For Vim version 7.0aa. Last change: 2004 Jun 16 VIM REFERENCE MANUAL by Bram Moolenaar @@ -130,8 +130,8 @@ tag char action ~ |i_<C-Home>| <C-Home> cursor to start of file |i_<End>| <End> cursor past end of line |i_<C-End>| <C-End> cursor past end of file -|i_<PageUp>| <PageUp> one screenfull backward -|i_<PageDown>| <PageDown> one screenfull forward +|i_<PageUp>| <PageUp> one screenful backward +|i_<PageDown>| <PageDown> one screenful forward |i_<F1>| <F1> same as <Help> |i_<Help>| <Help> stop insert mode and display help window |i_<Insert>| <Insert> toggle Insert/Replace mode diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt index 1439dbeaf9..8028b661f9 100644 --- a/runtime/doc/insert.txt +++ b/runtime/doc/insert.txt @@ -1,4 +1,4 @@ -*insert.txt* For Vim version 7.0aa. Last change: 2004 Apr 09 +*insert.txt* For Vim version 7.0aa. Last change: 2004 Jun 16 VIM REFERENCE MANUAL by Bram Moolenaar @@ -908,7 +908,7 @@ gi Insert text in the same position as where Insert mode The position is corrected for inserted/deleted lines, but NOT for inserted/deleted characters. When the |:keepjumps| command modifier is used the |'^| - mark wont be changed. + mark won't be changed. {not in Vi} *o* diff --git a/runtime/doc/mbyte.txt b/runtime/doc/mbyte.txt index 52c3b24063..9e96c3ea49 100644 --- a/runtime/doc/mbyte.txt +++ b/runtime/doc/mbyte.txt @@ -1,4 +1,4 @@ -*mbyte.txt* For Vim version 7.0aa. Last change: 2004 Jun 07 +*mbyte.txt* For Vim version 7.0aa. Last change: 2004 Jun 16 VIM REFERENCE MANUAL by Bram Moolenaar et al. @@ -141,7 +141,7 @@ There are several ways to enter multi-byte characters: - For all systems keymaps can be used. See |mbyte-keymap|. The options 'iminsert', 'imsearch' and 'imcmdline' can be used to chose -the different input medhods or disable them temporarily. +the different input methods or disable them temporarily. ============================================================================== 2. Locale *mbyte-locale* @@ -906,7 +906,7 @@ IME status to that memorized automatically. This works on not only insert-normal mode, but also search-command input and replace mode. The options 'iminsert', 'imsearch' and 'imcmdline' can be used to chose -the different input medhods or disable them temporarily. +the different input methods or disable them temporarily. WHAT IS IME IME is a part of East asian version Windows. That helps you to input diff --git a/runtime/doc/motion.txt b/runtime/doc/motion.txt index b22413a84e..b2f6858bbe 100644 --- a/runtime/doc/motion.txt +++ b/runtime/doc/motion.txt @@ -1,4 +1,4 @@ -*motion.txt* For Vim version 7.0aa. Last change: 2004 May 13 +*motion.txt* For Vim version 7.0aa. Last change: 2004 Jun 17 VIM REFERENCE MANUAL by Bram Moolenaar @@ -672,11 +672,12 @@ m[ or m] Set the |'[| or |']| mark. Useful when an operator is the cursor, this is not a motion command). *:ma* *:mark* *E191* -:[range]ma[rk] {a-zA-Z} Set mark {a-zA-Z} at last line number in [range], +:[range]ma[rk] {a-zA-Z'} + Set mark {a-zA-Z'} at last line number in [range], column 0. Default is cursor line. *:k* -:[range]k{a-zA-Z} Same as :mark, but the space before the mark name can +:[range]k{a-zA-Z'} Same as :mark, but the space before the mark name can be omitted. *'* *'a* *`* *`a* @@ -692,7 +693,9 @@ g'{mark} g`{mark} jumping within the current buffer. Example: > g`" < jumps to the last known position in a file. See - $VIMRUNTIME/vimrc_example.vim. {not in Vi} + $VIMRUNTIME/vimrc_example.vim. + Also see |:keepjumps|. + {not in Vi} *:marks* :marks List all the current marks (not a motion command). @@ -868,7 +871,7 @@ These commands are not marks themselves, but jump to a mark: or larger than before, all marks are kept at the same line number. - When the number of lines decreases, the marks in the - ilnes that disappeared are deleted. + lines that disappeared are deleted. In any case the marks below the filtered text have their line numbers adjusted, thus stick to the text, as usual. @@ -877,12 +880,22 @@ These commands are not marks themselves, but jump to a mark: *:keepj* *:keepjumps* :keepj[umps] {command} - Do not change the |''|, |'.| and |'^| marks, the - |jumplist| or the |changelist|. Useful when making a - change or inserting text automatically and the user - doesn't want to go to this position. E.g., when - updating a "Last change" timestamp: > - autocmd BufWritePre,FileWritePre *.abc keepjumps call SetLastChange() + Moving around in {command} does not change the |''|, + |'.| and |'^| marks, the |jumplist| or the + |changelist|. + Useful when making a change or inserting text + automatically and the user doesn't want to go to this + position. E.g., when updating a "Last change" + timestamp in the first line: > + + :let lnum = getline(".") + :keepjumps normal gg + :call SetLastChange() + :keepjumps exe "normal " . lnum . "G" +< + Note that ":keepjumps" must be used for every command. + When invoking a function the commands in that function + can still change the jumplist. ============================================================================== 8. Jumps *jump-motions* diff --git a/runtime/doc/netbeans.txt b/runtime/doc/netbeans.txt index 55725e15e3..ee6adea44a 100644 --- a/runtime/doc/netbeans.txt +++ b/runtime/doc/netbeans.txt @@ -1,4 +1,4 @@ -*netbeans.txt* For Vim version 7.0aa. Last change: 2004 May 01 +*netbeans.txt* For Vim version 7.0aa. Last change: 2004 Jun 16 VIM REFERENCE MANUAL by Gordon Prieur @@ -180,7 +180,7 @@ Region is guarded, cannot modify change. *E656* -NetBeans dissallows writes of unmodified buffers +NetBeans disallows writes of unmodified buffers NetBeans does not support writes of unmodified buffers that were opened from NetBeans. @@ -245,7 +245,7 @@ could cause confusion. The netbeans_saved() function sent a "save" protocol command. In protocol version 2.1 and earlier this was incorrectly interpreted as a notification that a write had taken place. In reality, it told NetBeans to save the file so multiple writes were being done. This caused various -problems and has been fixed in 2.2. To decrease the likelyhood of this +problems and has been fixed in 2.2. To decrease the likelihood of this confusion happening again, netbeans_saved() has been renamed to netbeans_save_buffer(). diff --git a/runtime/doc/os_mac.txt b/runtime/doc/os_mac.txt index c2102bfc02..f242552453 100644 --- a/runtime/doc/os_mac.txt +++ b/runtime/doc/os_mac.txt @@ -1,4 +1,4 @@ -*os_mac.txt* For Vim version 7.0aa. Last change: 2004 Apr 27 +*os_mac.txt* For Vim version 7.0aa. Last change: 2004 Jun 19 VIM REFERENCE MANUAL by Bram Moolenaar et al. @@ -74,11 +74,16 @@ A: Under Window Settings, Emulation, make sure that "Escape non-ASCII ============================================================================== 4. Mac Lack *mac-lack* --The filenames containing both ":" and "/" are sometimes misinterpreted. - (just re-execute the command) --Scrollbar are not scrolling live, and when only the arrow or scroll area, - a limit of 32 line or page is scrolled. --Syntax highlighting works on 68k Macs but is _really_ slow. +The filenames containing both ":" and "/" are sometimes misinterpreted. (just +re-execute the command) + +Scrollbar are not scrolling live, and when only the arrow or scroll area, a +limit of 32 line or page is scrolled. + +Syntax highlighting works on 68k Macs but is _really_ slow. + +In a terminal CTRL-^ needs to be entered as Shift-Control-6. CTRL-@ as +Shift-Control-2. ============================================================================== 5. Mac Bug Report *mac-bug* diff --git a/runtime/doc/os_vms.txt b/runtime/doc/os_vms.txt index 834b35b167..aab5a2407a 100644 --- a/runtime/doc/os_vms.txt +++ b/runtime/doc/os_vms.txt @@ -1,4 +1,4 @@ -*os_vms.txt* For Vim version 7.0aa. Last change: 2004 May 16 +*os_vms.txt* For Vim version 7.0aa. Last change: 2004 Jun 16 VIM REFERENCE MANUAL @@ -280,7 +280,7 @@ For more information type $help set disp in VMS prompt. You need to set up one X server and run Vim as in point 2. For MS Windows there are available free X servers as MIX , Omni X etc. as well as excellent commercial products as eXcursion or ReflectionX with - buit in DEC support. + built in DEC support. Please note, that executables without GUI are slightly faster during startup then with enabled GUI in character mode. Therefore, if you do not use GUI diff --git a/runtime/doc/pi_netrw.txt b/runtime/doc/pi_netrw.txt index abfa8ce2ff..0a13dc2510 100644 --- a/runtime/doc/pi_netrw.txt +++ b/runtime/doc/pi_netrw.txt @@ -1,11 +1,11 @@ -*pi_netrw.txt* For Vim version 7.0aa. Last change: Apr 21, 2004 +*pi_netrw.txt* For Vim version 6.2. Last change: Jun 15, 2004 VIM REFERENCE MANUAL by Charles E. Campbell, Jr. -*dav* *http* *network* *rcp* *scp* -*fetch* *netrw* *Nread* *rsync* *sftp* -*ftp* *netrw.vim* *Nwrite* *netrw-file* +*dav* *http* *network* *rcp* *scp* +*fetch* *netrw* *Nread* *rsync* *sftp* +*ftp* *netrw.vim* *Nwrite* *netrw-file* ============================================================================== 0. Contents *netrw-contents* @@ -16,15 +16,16 @@ 4. Transparent File Transfer...........................|netrw-transparent| 5. Ex Commands.........................................|netrw-ex| 6. Variables and Options...............................|netrw-var| -7. Debugging...........................................|netrw-debug| -8. New Stuff...........................................|netrw-new| -9. Credits.............................................|netrw-credits| +7. Remote Directory Listing............................|netrw-dir| +8. Debugging...........................................|netrw-debug| +9. History.............................................|netrw-history| +10. Credits.............................................|netrw-credits| The functionality mentioned here is done via using |standard-plugin| techniques. This plugin is only available if - set nocp " 'compatible' is not set - filetype plugin on " plugins are enabled + set nocp " 'compatible' is not set + filetype plugin on " plugins are enabled You can avoid loading this plugin by setting the "loaded_netrw" variable in your <.vimrc> file: > @@ -49,16 +50,16 @@ in your <.vimrc> file: > Controlling External Applications - Protocol Variable Default Value - -------- ---------------- ------------- - dav: g:netrw_dav_cmd = "cadaver" - fetch: g:netrw_fetch_cmd = "fetch -o" - ftp: g:netrw_ftp_cmd = "ftp" - http: g:netrw_http_cmd = "fetch -o" else if fetch is available - http: g:netrw_http_cmd = "wget -q -O" If wget is available - rcp: g:netrw_rcp_cmd = "rcp" - rsync: g:netrw_rsync_cmd = "rsync -a" - scp: g:netrw_scp_cmd = "scp -q" + Protocol Variable Default Value + -------- ---------------- ------------- + dav: g:netrw_dav_cmd = "cadaver" + fetch: g:netrw_fetch_cmd = "fetch -o" + ftp: g:netrw_ftp_cmd = "ftp" + http: g:netrw_http_cmd = "fetch -o" if fetch is available + http: g:netrw_http_cmd = "wget -q -O" If wget is available + rcp: g:netrw_rcp_cmd = "rcp" + rsync: g:netrw_rsync_cmd = "rsync -a" + scp: g:netrw_scp_cmd = "scp -q" sftp: g:netrw_sftp_cmd = "sftp" READING @@ -76,7 +77,7 @@ in your <.vimrc> file: > :Nread "sftp://[user@]machine/file" uses sftp WRITING - :Nwrite ? give help + :Nwrite ? give help :Nwrite "machine:file" uses rcp :Nwrite "machine file" uses ftp with <.netrc> :Nwrite "machine id password file" uses ftp @@ -88,6 +89,9 @@ in your <.vimrc> file: > :Nwrite "sftp://[user@]machine/file" uses sftp http: not supported! + DIRECTORY LISTING + :Nread [protocol]://[user]@hostname/path/ + USER AND PASSWORD CHANGING Attempts to use ftp will prompt you for a user-id and a password. These will be saved in g:netrw_uid and g:netrw_passwd Subsequent uses @@ -148,7 +152,7 @@ transfer/protocol. Files are read from/written to a temporary file clean up. One may modify any protocol's implementing external application -by setting a variable (ex. scp uses the variable g:netrw_scp_cmd, +by settinbg a variable (ex. scp uses the variable g:netrw_scp_cmd, which is defaulted to "scp -q"). Ftp, an old protocol, seems to be blessed by numerous implementations. @@ -181,57 +185,57 @@ additional prompting. *netrw-urls* +=================================+============================+============+ - | Reading | Writing | Uses | + | Reading | Writing | Uses | +=================================+============================+============+ - | DAV: | | | - | dav://host/path | | cadaver | - | :Nread dav://host/path | :Nwrite dav://host/path | cadaver | + | DAV: | | | + | dav://host/path | | cadaver | + | :Nread dav://host/path | :Nwrite dav://host/path | cadaver | +---------------------------------+----------------------------+------------+ - | FETCH: | | | - | fetch://[user@]host/path | | | - | fetch://[user@]host:http/path | Not Available | fetch | - | :Nread fetch://[user@]host/path| | | + | FETCH: | | | + | fetch://[user@]host/path | | | + | fetch://[user@]host:http/path | Not Available | fetch | + | :Nread fetch://[user@]host/path| | | +---------------------------------+----------------------------+------------+ - | FILE: | | | - | file:///* | file:///* | | - | file://localhost/* | file://localhost/* | | + | FILE: | | | + | file:///* | file:///* | | + | file://localhost/* | file://localhost/* | | +---------------------------------+----------------------------+------------+ - | FTP: (*3) | (*3) | | - | ftp://[user@]host/path | ftp://[user@]host/path | ftp (*2) | - | :Nread ftp://host/path | :Nwrite ftp://host/path | ftp+.netrc | - | :Nread host path | :Nwrite host path | ftp+.netrc | - | :Nread host uid pass path | :Nwrite host uid pass path | ftp | + | FTP: (*3) | (*3) | | + | ftp://[user@]host/path | ftp://[user@]host/path | ftp (*2) | + | :Nread ftp://host/path | :Nwrite ftp://host/path | ftp+.netrc | + | :Nread host path | :Nwrite host path | ftp+.netrc | + | :Nread host uid pass path | :Nwrite host uid pass path | ftp | +---------------------------------+----------------------------+------------+ - | HTTP: wget is executable: (*4) | | | - | http://[user@]host/path | Not Available | wget | + | HTTP: wget is executable: (*4) | | | + | http://[user@]host/path | Not Available | wget | +---------------------------------+----------------------------+------------+ - | HTTP: fetch is executable (*4) | | | - | http://[user@]host/path | Not Available | fetch | + | HTTP: fetch is executable (*4) | | | + | http://[user@]host/path | Not Available | fetch | +---------------------------------+----------------------------+------------+ - | RCP: | | | - | rcp://[user@]host/path | rcp://[user@]host/path | rcp | + | RCP: | | | + | rcp://[user@]host/path | rcp://[user@]host/path | rcp | +---------------------------------+----------------------------+------------+ - | RSYNC: | | | - | rsync://[user@]host/path | rsync://[user@]host/path | rsync | - | :Nread rsync://host/path | :Nwrite rsync://host/path | rsync | - | :Nread rcp://host/path | :Nwrite rcp://host/path | rcp | + | RSYNC: | | | + | rsync://[user@]host/path | rsync://[user@]host/path | rsync | + | :Nread rsync://host/path | :Nwrite rsync://host/path | rsync | + | :Nread rcp://host/path | :Nwrite rcp://host/path | rcp | +---------------------------------+----------------------------+------------+ - | SCP: | | | - | scp://[user@]host/path | scp://[user@]host/path | scp | - | :Nread scp://host/path | :Nwrite scp://host/path | scp (*1) | + | SCP: | | | + | scp://[user@]host/path | scp://[user@]host/path | scp | + | :Nread scp://host/path | :Nwrite scp://host/path | scp (*1) | +---------------------------------+----------------------------+------------+ - | SFTP: | | | - | sftp://[user@]host/path | sftp://[user@]host/path | sftp | - | :Nread sftp://host/path | :Nwrite sftp://host/path | sftp (*1) | + | SFTP: | | | + | sftp://[user@]host/path | sftp://[user@]host/path | sftp | + | :Nread sftp://host/path | :Nwrite sftp://host/path | sftp (*1) | +=================================+============================+============+ (*1) For an absolute path use scp://machine//path. (*2) if <.netrc> is present, it is assumed that it will work with your ftp client. Otherwise the script will - prompt for user-id and password. + prompt for user-id and pasword. - (*3) for ftp, "machine" may be machine#port or machine:port + (*3) for ftp, "machine" may be machine#port or machine:port if a different port is needed than the standard ftp port (*4) for http:..., if wget is available it will be used. Otherwise, @@ -327,67 +331,88 @@ additional commands available. ============================================================================== -6. Variables and Options *netrw-options* *netrw-var* +6. Variables and Options *netrw-options* *netrw-var* The script <netrw.vim> uses several variables which can affect <netrw.vim>'s behavior. These variables typically may be set in the user's <.vimrc> file: - - g:netrw_uid Holds current user-id for ftp. - g:netrw_passwd Holds current password for ftp. - b:netrw_lastfile Holds latest method/machine/path. - b:netrw_line Holds current line number (during NetWrite) - b:netrw_col Holds current cursor position (during NetWrite) - g:netrw_ftp =0 use default ftp (uid password) - =1 use alternate ftp (user uid password) - (see |netrw-options|) - g:netrw_ftpmode ="binary" (default) - ="ascii" (your choice) - g:netrw_ignorenetrc =1 (default) - if you have a <.netrc> file but you don't +> + ------------- + Netrw Options + ------------- + Option Meaning + -------------- ----------------------------------------------- +< + b:netrw_col Holds current cursor position (during NetWrite) + g:netrw_cygwin =1 assume scp under windows is from cygwin + (default/windows) + =0 assume scp under windows accepts windows + style paths (default/else) + g:netrw_ftp =0 use default ftp (uid password) + g:netrw_ftpmode ="binary" (default) + ="ascii" (your choice) + g:netrw_ignorenetrc =1 (default) + if you have a <.netrc> file but you don't want it used, then set this variable. Its mere existence is enough to cause <.netrc> to be ignored. - g:netrw_win95ftp =0 use unix-style ftp even if win95/98/ME/etc - =1 use default method to do ftp - g:netrw_cygwin =1 assume scp under windows is from cygwin - (default/windows) - =0 assume scp under windows accepts windows - style paths (default/else) - g:netrw_use_nt_rcp =0 don't use WinNT/2K/XP's rcp (default) - =1 use WinNT/2K/XP's rcp, binary mode - - + b:netrw_lastfile Holds latest method/machine/path. + b:netrw_line Holds current line number (during NetWrite) + g:netrw_passwd Holds current password for ftp. + g:netrw_silent =0 transfers done normally + =1 transfers done silently + g:netrw_uid Holds current user-id for ftp. + =1 use alternate ftp (user uid password) + (see |netrw-options|) + g:netrw_use_nt_rcp =0 don't use WinNT/2K/XP's rcp (default) + =1 use WinNT/2K/XP's rcp, binary mode + g:netrw_win95ftp =0 use unix-style ftp even if win95/98/ME/etc + =1 use default method to do ftp > + ----------------------------------------------------------------------- +< The script will also make use of the following variables internally, albeit temporarily. - +> + ------------------- + Temporary Variables + ------------------- + Variable Meaning + -------- ------------------------------------ +< g:netrw_method Index indicating rcp/ftp+.netrc/ftp g:netrw_machine Holds machine name parsed from input - g:netrw_fname Holds filename being accessed - + g:netrw_fname Holds filename being accessed > + ------------------------------------------------------------ +< *netrw-protocol* + +Netrw supports a number of protocols. These protocols are invoked using the +variables listed below, and may be modified by the user. > ------------------------ - Protocol Control Options + Protocol Control Options ------------------------ - Option Type Setting Meaning ~ - --------- -------- -------------- --------------------------- > - netrw_ftp variable =doesn't exist userid set by "user userid" - =0 userid set by "user userid" - =1 userid set by "userid" - NetReadFixup function =doesn't exist no change - =exists Allows user to have files - read via ftp automatically - transformed however they wish - by NetReadFixup() + Option Type Setting Meaning + --------- -------- -------------- --------------------------- +< + netrw_ftp variable =doesn't exist userid set by "user userid" + =0 userid set by "user userid" + =1 userid set by "userid" + NetReadFixup function =doesn't exist no change + =exists Allows user to have files + read via ftp automatically + transformed however they wish + by NetReadFixup() g:netrw_dav_cmd variable ="cadaver" g:netrw_fetch_cmd variable ="fetch -o" g:netrw_ftp_cmd variable ="ftp" g:netrw_http_cmd variable ="fetch -o" else if fetch is executable g:netrw_http_cmd variable ="wget -O" if wget is executable + g:netrw_list_cmd variable ="ssh HOSTNAME ls -Fa" g:netrw_rcp_cmd variable ="rcp" g:netrw_rsync_cmd variable ="rsync -a" g:netrw_scp_cmd variable ="scp -q" - g:netrw_sftp_cmd variable ="sftp" + g:netrw_sftp_cmd variable ="sftp" > + ------------------------------------------------------------------------- < The first two options both help |