Updated runtime files.
diff --git a/runtime/doc/pi_netrw.txt b/runtime/doc/pi_netrw.txt
index 7635af2..9f0955b 100644
--- a/runtime/doc/pi_netrw.txt
+++ b/runtime/doc/pi_netrw.txt
@@ -1,4 +1,4 @@
-*pi_netrw.txt* For Vim version 7.2. Last change: 2009 Dec 28
+*pi_netrw.txt* For Vim version 7.2. Last change: 2010 May 14
-----------------------------------------------------
NETRW REFERENCE MANUAL by Charles E. Campbell, Jr.
@@ -6,7 +6,7 @@
Author: Charles E. Campbell, Jr. <NdrOchip@ScampbellPfamily.AbizM>
(remove NOSPAM from Campbell's email first)
-Copyright: Copyright (C) 2009 Charles E Campbell, Jr *netrw-copyright*
+Copyright: Copyright (C) 1999-2010 Charles E Campbell, Jr *netrw-copyright*
Permission is hereby granted to use and distribute this code, with
or without modifications, provided that this copyright notice is
copied with it. Like anything else that's free, netrw.vim,
@@ -19,9 +19,9 @@
use of this software.
-*dav* *ftp* *netrw-file* *Nread* *rcp* *scp*
-*davs* *http* *netrw.vim* *Nsource* *rsync* *sftp*
-*fetch* *netrw* *network* *Nwrite*
+ *dav* *ftp* *netrw-file* *rcp* *scp*
+ *davs* *http* *netrw.vim* *rsync* *sftp*
+ *fetch* *netrw* *network*
==============================================================================
1. Contents *netrw-contents* {{{1
@@ -158,7 +158,7 @@
next section, |netrw-externapp|, on how to use these external applications with
netrw and vim.
-PREVENTING LOADING
+PREVENTING LOADING *netrw-noload*
If you want to use plugins, but for some reason don't wish to use netrw, then
you need to avoid loading both the plugin and the autoload portions of netrw.
@@ -169,7 +169,7 @@
<
==============================================================================
-3. Netrw Reference *netrw-ref* {{{1
+3. Netrw Reference *netrw-ref* {{{1
Netrw supports several protocols in addition to scp and ftp as mentioned
in |netrw-start|. These include dav, fetch, http,... well, just look
@@ -642,18 +642,22 @@
instead, as appropriate) -- see |netrw-urls|. In the explanations
below, a {netfile} is an url to a remote file.
+ *:Nwrite* *:Nw*
:[range]Nw[rite] Write the specified lines to the current
file as specified in b:netrw_lastfile.
+ (related: |netrw-nwrite|)
:[range]Nw[rite] {netfile} [{netfile}]...
Write the specified lines to the {netfile}.
+ *:Nread* *:Nr*
:Nr[ead] Read the lines from the file specified in b:netrw_lastfile
- into the current buffer.
+ into the current buffer. (related: |netrw-nread|)
:Nr[ead] {netfile} {netfile}...
Read the {netfile} after the current line.
+ *:Nsource* *:Ns*
:Ns[ource] {netfile}
Source the {netfile}.
To start up vim using a remote .vimrc, one may use
@@ -661,20 +665,24 @@
vim -u NORC -N
--cmd "runtime plugin/netrwPlugin.vim"
--cmd "source scp://HOSTNAME/.vimrc"
-< *netrw-uidpass*
-:call NetUserPass()
+< (related: |netrw-source|)
+
+:call NetUserPass() *NetUserPass()*
If g:netrw_uid and s:netrw_passwd don't exist,
this function will query the user for them.
+ (related: |netrw-userpass|)
:call NetUserPass("userid")
This call will set the g:netrw_uid and, if
the password doesn't exist, will query the user for it.
+ (related: |netrw-userpass|)
:call NetUserPass("userid","passwd")
This call will set both the g:netrw_uid and s:netrw_passwd.
The user-id and password are used by ftp transfers. One may
effectively remove the user-id and password by using empty
strings (ie. "").
+ (related: |netrw-userpass|)
:NetrwSettings This command is described in |netrw-settings| -- used to
display netrw settings and change netrw behavior.
@@ -688,9 +696,7 @@
The <netrw.vim> script provides several variables which act as options to
affect <netrw.vim>'s file transfer behavior. These variables typically may be
set in the user's <.vimrc> file: (see also |netrw-settings| |netrw-protocol|)
-
>
-
-------------
Netrw Options
-------------
@@ -1025,6 +1031,8 @@
to the netrw browser window. See |g:netrw_retmap|.
<s-leftmouse> (gvim only) like mf, will mark files
+ (to disable mouse buttons while browsing: |g:netrw_mousemaps|)
+
*netrw-quickcom* *netrw-quickcoms*
QUICK REFERENCE: COMMANDS *netrw-explore-cmds* *netrw-browse-cmds* {{{2
:NetrwClean[!] ...........................................|netrw-clean|
@@ -1202,7 +1210,7 @@
|netrw-qb| how to list bookmarks
-CHANGING TO A PREDECESSOR DIRECTORY *netrw-u* *netrw-updir* {{{2
+CHANGING TO A PREDECESSOR DIRECTORY *netrw-u* *netrw-updir* {{{2
Every time you change to a new directory (new for the current session),
netrw will save the directory in a recently-visited directory history
@@ -2022,7 +2030,8 @@
unix or g:netrw_cygwin set: : "ls -tlF"
otherwise "dir"
- *g:netrw_glob_escape* ='[]*?`{~$'
+ *g:netrw_glob_escape* ='[]*?`{~$' (unix)
+ ='[]*?`{$' (windows
These characters in directory names are
escaped before applying glob()
@@ -2293,6 +2302,18 @@
By default, the split will be taken horizontally; one may use vertical
splitting if one has set |g:netrw_preview| first.
+An interesting set of netrw settings is: >
+
+ let g:netrw_preview = 1
+ let g:netrw_liststyle = 3
+ let g:netrw_winsize = 30
+
+These will:
+ 1. Make vertical splitting the default for previewing files
+ 2. Make the default listing style "tree"
+ 3. When a vertical preview window is opened, the directory listing
+ will use only 30 columns; the rest of the window is used for the
+ preview window.
PREVIOUS WINDOW *netrw-P* *netrw-prvwin* {{{2
@@ -2597,6 +2618,29 @@
Multibyte encodings use two (or more) bytes per character.
You may need to change |g:netrw_sepchr| and/or |g:netrw_xstrlen|.
+ *netrw-p13*
+ P13. I'm a Windows + putty + ssh user, and when I attempt to browse,
+ the directories are missing trailing "/"s so netrw treats them
+ as file transfers instead of as attempts to browse
+ subdirectories. How may I fix this?
+
+ (mikeyao) If you want to use vim via ssh and putty under Windows,
+ try combining the use of pscp/psftp with plink. pscp/psftp will
+ be used to connect and plink will be used to execute commands on
+ the server, for example: list files and directory using 'ls'.
+
+ These are the settings I use to do this:
+>
+ " list files, it's the key setting, if you haven't set,
+ " you will get a blank buffer
+ let g:netrw_list_cmd = "plink HOSTNAME ls -Fa"
+ " if you haven't add putty directory in system path, you should
+ " specify scp/sftp command. For examples:
+ "let g:netrw_sftp_cmd = "d:\\dev\\putty\\PSFTP.exe"
+ "let g:netrw_scp_cmd = "d:\\dev\\putty\\PSCP.exe"
+<
+
+
==============================================================================
11. Debugging Netrw Itself *netrw-debug* {{{1
@@ -2651,6 +2695,35 @@
==============================================================================
12. History *netrw-history* {{{1
+ v138: May 01, 2010 * added the bomb setting to the Save-Set-Restore
+ option handling (for Tony M)
+ * (Bram Moolenaar) netrw optionally sets cursorline
+ (and sometimes cursorcolumn) for its display.
+ This option setting was leaking through with
+ remote file handling.
+ v137: Dec 28, 2009 * modified the preview window handling for
+ vertically split windows. The preview
+ window will take up all but g:netrw_winsize
+ columns of the original window; those
+ g:netrw_winsize columns will be used for
+ the netrw listing.
+ * (Simon Dambe) removed "~" from
+ |g:netrw_glob_escape| under Windows
+ * (Bram Moolenaar) modified test for status bar
+ click with leftmouse. Moved code to
+ s:NetrwLeftmouse().
+ Feb 24, 2010 * (for Jean Johner) added insert-mode maps; one
+ can get into insert mode with netrw via
+ ctrl-o :e .
+ Mar 15, 2010 * (Dominique Pellé) Directory with backslashes such
+ as foo\bar were not being entered/left properly
+ Mar 15, 2010 * Using :Explore .. and causing two FocusGained
+ events caused the directory to change. Fixed.
+ Mar 22, 2010 * Last fix caused problems for *//pat and */filepat
+ searches.
+ Mar 30, 2010 * With :set hidden and changing listing styles 8
+ times, the tree listing buffer was being marked
+ as modified upon exit. Fixed.
v136: Jan 14, 2009 * extended |g:Netrw_funcref| to also handle lists
of function references
Jan 14, 2009 * (reported by Marvin Renich) with spell check