updated for version 7.0017
diff --git a/runtime/doc/pi_netrw.txt b/runtime/doc/pi_netrw.txt
index 991c9a4..47d0d7e 100644
--- a/runtime/doc/pi_netrw.txt
+++ b/runtime/doc/pi_netrw.txt
@@ -1,4 +1,4 @@
-*pi_netrw.txt For Vim version 6.2. Last change: Sep 10, 2004
+*pi_netrw.txt For Vim version 6.2. Last change: Sep 13, 2004
VIM REFERENCE MANUAL by Charles E. Campbell, Jr.
@@ -587,10 +587,14 @@
"directories" and "files" in the
listing. This pattern is used to
remove such embedded messages.
- g:netrw_keepdir keep current directory immune from the
- browsing directory. The browsing
- directory is contained in b:netrw_curdir
+ g:netrw_keepdir =1 (default) keep current directory
+ immune from the browsing directory.
+ =0 keep the current directory the
+ same as the browsing directory.
+ The browsing directory is contained in
+ b:netrw_curdir
g:netrw_list_cmd command for listing remote directories
+ g:netrw_longlist if =1, then long listing will be default
g:netrw_ftp_list_cmd options for passing along to ftp for
directory listing. Defaults:
unix or g:netrw_cygwin set: : "ls -lF"
@@ -601,6 +605,12 @@
g:netrw_local_rmdir remove directory command (rmdir)
g:netrw_local_rename rename file/directory command
unix-default: rm win32-default: ren
+ g:netrw_maxfilenamelen =32 by default, selected so as to make
+ long listings fit on 80 column displays.
+ If your screen is wider, and you have
+ file/directory names longer than 32 bytes,
+ you may set this option to keep listings
+ columnar.
g:netrw_mkdir_cmd command for making a remote directory
g:netrw_rm_cmd command for removing files
g:netrw_rmdir_cmd command for removing directories
@@ -825,22 +835,26 @@
file with mozilla.
-MAKING THE BROWSING DIRECTORY THE CURRENT DIRECTORY *netrw-c*
+MAKING THE BROWSING DIRECTORY THE CURRENT DIRECTORY *netrw-c* *netrw-curdir*
-By default, g:netrw_keepdir is 0. This setting means that the current
-directory will track the browsing directory. However, setting g:netrw_keepdir
-to 1 (say, in your <.vimrc>) will keep the current directory independent
-of the browsing directory. In that case, in order to make the two
-directories the same, use the "c" map (just type c).
+By default, g:netrw_keepdir is 1. This setting means that the current
+directory will not track the browsing directory. However, setting
+g:netrw_keepdir to 0 (say, in your <.vimrc>) will tell netrw to have the
+currently browsed directory be the current directory.
+
+With the default setting for g:netrw_keepdir, in order to make the two
+directories the same, use the "c" map (just type c). That map will set
+the current directory to the current browsing directory.
-BOOKMARKING A DIRECTORY *netrw-b*
+BOOKMARKING A DIRECTORY *netrw-b* *netrw-bookmark* *netrw-bookmarks*
One may easily "bookmark" a directory by using
{cnt}b
-Any count may be used.
+Any count may be used. One may use viminfo's "!" option to retain bookmarks
+between vim sessions.
CHANGING TO A BOOKMARKED DIRECTORY *netrw-B*
@@ -913,7 +927,10 @@
P4. I would like long listings to be the default.
- let g:netrw_longlist=1
+ let g:netrw_longlist=1
+
+ Check out |netrw-browse-var| for more customizations that
+ you can set.
P5. My times come up oddly in local browsing
@@ -923,10 +940,10 @@
your <.vimrc>:
let g:netrw_timefmt= "%X" (where X is the option)
- P6. I don't want my current directory changing just because I'm
- browsing somewhere.
+ P6. I want my current directory to track my browsing.
+ How do I do that?
- let g:netrw_keepdir= 1
+ let g:netrw_keepdir= 0
==============================================================================
@@ -979,60 +996,65 @@
==============================================================================
10. History *netrw-history*
- v48: * One may use ftp to do remote host file browsing
+ v50: * directories now displayed using buftype=nofile; should keep the
+ directory names as-is
+ * attempts to remove empty "[No File]" buffers leftover
+ from :file ..name.. commands
+ * bugfix: a "caps-lock" editing difficulty left in v49 was fixed
+ * syntax highlighting for "Showing:" the hiding list included
+ * bookmarks can now be retained if "!" is in the viminfo option
+ v49: * will use ftp for http://.../ browsing v48: * One may use ftp to
+ do remote host file browsing
* (windows and !cygwin) remote browsing with ftp can now use
the "dir" command internally to provide listings
* g:netrw_keepdir now allows one to keep the initial current
- directory as the current directory (normally the local
- file browser makes the currently viewed directory the
- current directory)
+ directory as the current directory (normally the local file
+ browser makes the currently viewed directory the current
+ directory)
* g:netrw_alto and g:netrw_altv now support alternate placement
of windows started with o or v
* Nread ? and Nwrite ? now uses echomsg (instead of echo) so
:messages can repeat showing the help
* bugfix: avoids problems with partial matches of directory names
to prior buffers with longer names
- * one can suppress error messages with g:netrw_quiet
- * ctrl-h used instead of <Leader>h for editing hiding list
- * one may edit the sorting sequence with the S map
- * now allows confirmation of deletion with [y(es) n(o) a(ll) q(uit)]
- * the "x" map now handles special file viewing with:
- (windows) rundll32 url.dll
- (gnome) gnome-open
- (kde) kfmclient
- If none of these are on the executable path, then
+ * one can suppress error messages with g:netrw_quiet ctrl-h used
+ * instead of <Leader>h for editing hiding list one may edit the
+ * sorting sequence with the S map now allows confirmation of
+ * deletion with [y(es) n(o) a(ll) q(uit)] the "x" map now handles
+ * special file viewing with:
+ (windows) rundll32 url.dll (gnome) gnome-open (kde)
+ kfmclient If none of these are on the executable path, then
NetrwFileHandlers.vim is used.
* directory bookmarking during both local and remote browsing
implemented
* one may view all, use the hiding list to suppress, or use the
- hiding list to show-only remote and local file/directory listings
- * improved unusual file and directory name handling
- * preview window support
- v47: * now handles local directory browsing.
- v46: * now handles remote directory browsing
+ hiding list to show-only remote and local file/directory
+ listings
+ * improved unusual file and directory name handling preview
+ * window support
+ v47: * now handles local directory browsing. v46: * now handles
+ remote directory browsing
* g:netrw_silent (if 1) will cause all transfers to be silent'd
- v45: * made the [user@]hostname:path form a bit more restrictive
- to better handle errors in using protocols
- (e.g. scp:usr@host:file was being recognized as an rcp request)
- v44: * changed from "rsync -a" to just "rsync"
+ v45: * made the [user@]hostname:path form a bit more restrictive to
+ better handle errors in using protocols (e.g. scp:usr@host:file
+ was being recognized as an rcp request) v44: * changed from
+ "rsync -a" to just "rsync"
* somehow an editing error messed up the test to recognize
use of the fetch method for NetRead.
* more debugging statements included
- v43: * moved "Explanation" comments to <pi_netrw.txt> help file
- as "Network Reference" (|netrw-ref|)
+ v43: * moved "Explanation" comments to <pi_netrw.txt> help file as
+ "Network Reference" (|netrw-ref|)
* <netrw.vim> now uses Dfunc() Decho() and Dret() for debugging
* removed superfluous NetRestorePosn() calls
- v42: * now does BufReadPre and BufReadPost events on file:///*
- and file://localhost/*
- v41: * installed file:///* and file://localhost/* handling
- v40: * prevents redraw when a protocol error occurs so that the
- user may see it
- v39: * sftp support
- v38: * Now uses NetRestorePosn() calls with Nread/Nwrite commands
+ v42: * now does BufReadPre and BufReadPost events on file:///* and
+ file://localhost/* v41: * installed file:///* and
+ file://localhost/* handling v40: * prevents redraw when a
+ protocol error occurs so that the user may see it v39: * sftp
+ support v38: * Now uses NetRestorePosn() calls with
+ Nread/Nwrite commands
* Temporary files now removed via bwipe! instead of bwipe
- (thanks to Dave Roberts)
- v37: * Claar's modifications which test if ftp is successful, otherwise
- give an error message
+ (thanks to Dave Roberts) v37: * Claar's modifications which
+ test if ftp is successful, otherwise give an error message
* After a read, the alternate file was pointing to the temp file.
The temp file buffer is now wiped out.
* removed silent from transfer methods so user can see what's