-----------------------------------------------------
NETRW REFERENCE MANUAL by Charles E. Campbell, Jr.
-----------------------------------------------------
*g:netrw_cygwin* =1 windows で cygwin 付属の scp を想定する。また、ネッ
トワークブラウジングで ls を使っての時間とサイズに
よるソートを可能にする (windowsでの初期設定)。
=0 Windows の scp が Windows 形式のパスを扱えると想定
する。ネットワークブラウジングでは ls ではなく dir
を使用する。
このオプションは unix では無視されます。
Vim におけるネットワークファイルの転送機能は Vim スクリプトで実装されたプラグ
インで提供されています (<netrw.vim>)。これは rcp、ftp or ftp+<.netrc>、scp、
fetch、dav/cadaver、rsync、sftp などを使ってネットワークファイルの読み書きを実
現しています。
open machine [port] open machine [port]
user userid password userid password
[g:netrw_ftpmode] password
[g:netrw_extracmd] [g:netrw_ftpmode]
get filename tempfile [g:netrw_extracmd]
get filename tempfile ---------------------------------------------------------------------
* Windows 32 or 64 では、url と FileProtocolHandler dll が使われます。 * Gnome (with gnome-open): gnome-open が使われます。 * KDE (with kfmclient) : kfmclient が使われます。 * Mac OS X : open が使われます。 * その他では netrwFileHandler プラグインが使われます。
(Vim メーリングリストでの Wu Yongwei 氏による回答)
問題は確認できました。936 以外のコードページを使っていません
か？ Windows の Unicode版 API に対応していない他のアプリケー
ション同様、どうやら Vim ではカレントコードページの文字以外は
使えないようです。これは OS の問題です。最近の Linux ディスト
リビューションのような UTF-8 ロケールが使えるシステムではこの
ような問題は起こらないでしょう。
(こういうのが utf-8 が推奨される理由の一つです)
*netrw-p8*
P8. "ssh is not executable on your system" (ssh という実行可能ファイル
がない) って表示されるんだけど、どうすればいいの？
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
enabled, some filenamess will still being
displayed as spelling errors.
v135: Oct 29, 2008 * using |simplify()| on directory names
(supporting handling ".."s in directory names)
Oct 31, 2008 * added special file highlighting for core dumps
under Unix/Linux. The default sorting sequence
now also gives core dumps priority.
Nov 10, 2008 * uses a call to netrw#Nread() instead of Nread
to avoid having to use fnameescape()
* fixed a tree redrawing problem (open directory,
open subdir, close subdir, close dir)
Nov 19, 2008 * sprinked some histdel("/",-1)s through the code
in an attempt to prevent netrw from changing
the search history.
Jan 02, 2009 * |g:Netrw_funcref| included
Jan 05, 2009 * Explore */ **/ *// **// all clear explorer
variables
Jan 05, 2009 * (Panagiotis Louridas) extended s:WinPath()
to remove cygdrive from non-cygwin Windows
paths. Improved the determination as to
whether or not to do so.
Jan 13, 2009 * included contains=@NoSpell in every syntax
group for syntax/netrw.vim .
v134: Sep 30, 2008 * (Sander Marechal) provided a bugfix involving
the use of the |netrw-t| command with a remote
directory.
Sep 30, 2008 * using "x" on a remote jpg was failing; fixed.
Oct 03, 2008 * bookmarks now go on a list and are stored to
the first directory on the |'runtimepath'| in
the hopes of making their retention reliable.
History now also goes to that directory.
Oct 07, 2008 * Included check that vim 7.0 or later is in use.
Oct 07, 2008 * Improved |g:netrw_retmap| handling.
Oct 12, 2008 * Based upon Sébastien Migniot's suggestion, if
cadaver isn't available then netrw will try to
use curl for the dav://... protocol.
Oct 13, 2008 * added @*/ to netrw buffers' |'iskeyword'|setting
This lets mf (|netrw-mf|) mark directories, links
and executables.
Oct 13, 2008 * avoids a second NetrwBrowse() refresh when
g:netrw_fastbrowse is <= 1 (slow, medium speed)
Oct 22, 2008 * |g:netrw_http_xcmd| may now be overridden
independently of |g:netrw_http_cmd|.
Oct 23, 2008 * [N] added to the various Explore commands to
let users specify the width/height of new
explorer windows, overriding |g:netrw_winsize|.
v133: Aug 10, 2008 * NetReadFixup() for win95 was missing some "a:"s
Aug 12, 2008 * (Jan Minář) an error condition in NetrwMethod()
wasn't being used, resulting in "b:netrw_fname
undefined" errors
Aug 12, 2008 * (François Ingeirest) asked that "hi link" be
changed to hi default link in the netrw syntax
files.
Aug 12, 2008 * using s:NetrwUnmarkList() more often. Filenames
were being left on the global list when removed
from the buffer-local lists.
Aug 14, 2008 * (Joshua Clayton) an errant extra ")" was left in
the rcp-handling portion of NetRead().
Sep 03, 2008 * added |'cursorline'| highlighting to thin, long,
and tree displays.
v132: Aug 06, 2008 * Fixed marked file-based obtain
Aug 08, 2008 * sourcing a file via ftp from a netrw-generated
buffer (or any buffer with |'nobl'|) left an
empty no-name buffer in its wake. Fixed.
v130: Jul 31, 2008 * trying out elinks/links for http://host/
requests. One problem: in-page links
(such as with ...#LABEL) are not supported
* verified that Bram's modified netrwPlugin works
Aug 01, 2008 * fixed a bug: when sourcing a file via ftp, the
"filter window" was left behind.
v129: Jul 31, 2008 * bug found in non-mouse enabled vim and some
local maps
v128: Jul 30, 2008 * much work done in using shellescape() and
fnameescape()
v126: Jun 30, 2008 * after having gone to a remote directory, <f1> was no longer taking one to the correct
entry in the help (|netrw-quickhelp|). Fixed.
Jul 01, 2008 * extracting the last filename from a wide listing
missed the last letter when |'virtualedit'| not
enabled.
Jul 01, 2008 * vim foo/bar was creating [Scratch] buffers,
where bar was also a directory
Jul 01, 2008 * numerous additional changes were made to netrw
to use fnameescape() and shellescape() instead
of escape(). Not all changes have been tested
as yet...
Jul 01, 2008 * (James Vega reported) some problems with
:NetrwSettings (due to no longer used setting
variables).
Jul 07, 2008 * Additional numerous changes to support security;
shellescape(arg,1), etc.
v125: Apr 07, 2008 * (Cristian Rigamonti) CR provides a patch; he
noted that gx was failing since its call to
netrw#NetBrowseX() wasn't updated to
netrw#NetrwBrowseX().
* (Stanis Trendelenburg) ST provides a patch to
supports davs: (dav + ssl)
* (Rick Choi) noted that directory names comprised
of three digits were not being displayed by
the internal browser. Fixed.
* (Erik Falor) provided a patch to handle problems
with changing directory and |'acd'| option.
* (James Vega, Teemu Likonen) noted that netrw
wasn't handling multi-byte filenames/directories
correctly. Fixed.
* (Rick) found problem with g:netrw_maxfilenamelen
being overridden.
* (James Vega) pointed out that netrw was
misidentifying all files in a symbolically linked
directory as being symbolically linked
themselves. This particular problem was fixed;
however, there are now situations where
symbolically linked files will not be detected.
Really need an internal vim function to do this
identification.
Apr 17, 2008 * When g:netrw_keepdir==0, current directory
doesn't necessarily equal b:netrw_curdir
initially. Problem is due to the patch directly
above.
* Fixed qf to handle case where b:netrw_curdir
isn't the same as the current directory under
linux/macosx.
* New: |netrw-mg| (apply vimgrep to marked files)
May 05, 2008 * (Rick) pointed out that a "setlocal ts=32" was
interfering with g:netrw_maxfilenamelen
May 05, 2008 * (James Vega) a file inside a linked directory
was showing up as a symbolic link itself.
May 22, 2008 * symbolic links, fifos, and sockets are now
indicated by a trailing @, |, or =, respectively.
Jun 06, 2008 * Removed numerous bugs from the marked file
move and copy. Tested these changes under
Unix only thus far.
* :Rexplore returns to the screen position in the
netrw listing from whence the file was edited
v124: Apr 02, 2008 * (Adrian Rollett) change the line supporting the
"x" action for mac to use g:netrw_shq
v123: Feb 27, 2008 * Marked files now keeps a "global" marked file
list. The global marked file list is used to
support tag processing and vimdiff'ing
(|netrw-md||netrw-mt|)
* Been insuring that mm and mc works with various
combinations of local and remote directories
* (Stefan Bittner) http://.../ should always have
filetype "html" -- fixed.
* (Stefan Bittner) a "?" in a http://.../ request
wasn't being handled correctly. Fixed by
removing ? from default |g:netrw_tmpfile_escape|.
* (Nico Weber) % codes in http://.../ requests
weren't being handled correctly. Fixed by
including % in default |g:netrw_fname_escape|.
* (Stefan Bittner) attempts to update Buffers.Refresh
were failing because locale use changed the menu
names. I implemented a workaround.
v122: Feb 12, 2008 * bugfix - first sorting sequence match now has
priority
Feb 14, 2008 * bugfix - sorting sequence was effectively ignoring
sequencing priority of anything following '*'
* toggling a marked file was showing incorrect list
(list was correct, but displayed matches weren't)
* |g:netrw_special_syntax| implemented
v121: Feb 11, 2008 * Bram M reported that :e file ... :e . would not
retain the alternate file. Fixed -- I hope!
* bugfix -- apparently v120 broke an explicit
:Explore dirname
v120: Jan 21, 2008 * |netrw-mt| changed to allow for target selection
based on whether or not word under cursor is a
directory or file, or if cursor is in banner
area.
* |netrw-mh| included (hiding by marked-file suffix)
* functions moved about a bit (improved
categorization)
* executable files now displayed with trailing (*)
* symbolically linked files now displayed with
trailing (@)
* Somewhen, s:NetrwMarkFileMove() got damaged. It's
now restored (missing an endif, for example).
* |netrw-mu| implemented (unmarking marked files)
* many bugs have been removed from the marked file
system (tnx to Mark S. for feedback)
* |netrw-ms| implemented (sourcing marked files)
* fixed use of P with tree listing style
* multiple tree listing now supported
* ./ suppressed
* changed q -> qb (query bookmarks)
* implemented |netrw-qf|
* Explore now has four special list-generation
modes: */filepat **/filepat
*//pattern **//pattern
* gh (|netrw-gh|) is a shortcut for toggling the
hiding of files and directories beginning with a
dot
v119: Jan 10, 2008 * When g:netrw_keepdir is false,
NetrwOptionsRestore() had a problem
(Bill McCarthy)
Jan 11, 2008 * Netrw now shows symbolic links with a trailing
"@" and special highlighting.
Jan 15, 2008 * Changed g:netrw_noretmap -> |g:netrw_retmap|.
Changed: disabled by default at Bram's
preference.
v118: Jan 02, 2008 * Fixed a problem with Windows;
:Explore c:/path/ would not work,
but :Explore c:/path would.
* Fixed a bug in s:NetrwOptionRestore() - lcd's
argument wasn't being properly escaped so it
wouldn't handle spaces in directory names.
(Gary Johnson)
v117: Jan 02, 2008 * Fixed a problem with P; had to include
a b:netrw_curdir bypass (Bram Moolenaar)
v116: Nov 27, 2007 * netrw#LocalBrowseCheck() has &ft=="netrw"
check to prevent doing a directory listing
(was getting unexpected directory refreshes
in the middle of some function calls)
* NetrwOptionRestore moved after e! filename
in order to retain user options for editing
in s:NetrwBrowseChgDir()
Dec 12, 2007 * Bug fix -- netrw does a better job of retaining
user options when editing files under the aegis
of the browser
v115: Oct 04, 2007 * Erik Remmelzwaal pointed out that the use of
shellslash in s:GetTempfile() was incorrect
Oct 11, 2007 * Tracked down and eliminated a bug with editing
remote *.tar.gz and *.tar.bz2 files
Oct 11, 2007 * g:netrw_localmovecmd wasn't being initialized
properly, and g:netrw_localcopycmd was being
overwritten.
Oct 12, 2007 * Placed all :Rexplore and <2-leftmouse> setup
in a new support function (s:SetRexDir()).
Oct 15, 2007 * new: g:netrw_browse_split == 4; means <cr>
based selection will use previous window
Oct 20, 2007 * also checks on |'shellxquote'| to set g:netrw_shq
Oct 24, 2007 * Explore handles path/**/filename
Oct 27, 2007 * sourcing remote files often didn't work with ftp,
turns out that b:netrw_method was undefined, so
s:SaveBufVars and s:RestoreBufVars() fixed it.
v114: Sep 28, 2007 * mT, the map that invokes tags, has been improved
to support use of remote tags files.
Oct 02, 2007 * changed Netrw menu to use more submenus
v113: Sep 07, 2007 * worked out why the cursor position wasn't being
saved and restored as intended after doing such
things as deleting and renaming files.
Sep 11, 2007 * Fixed bug which effectively disabled <c-l> and <c-h> maps
Sep 18, 2007 * there used to be one NetrwOptionRestore() call at
the end of the s:NetrwBrowseChgDir() function;
they're now at the end of every if..elseif..else
block. The edit-a-file one is not quite at the end
of its block; instead, it's just before the edit.
Restores user options, then this new placement
allows ftplugins, autocmds, etc to change settings
(ex. ftplugin/cpp.vim sets cindent).
Sep 19, 2007 * changed all strlen() calls to use s:Strlen(), a
function which handles utf-8 wide characters
correctly.
Sep 20, 2007 * (Nico Weber) the "x" command has been extended
to Mac's OS/X (macunix); it now uses open to
handle |netrw-x| browsing with special files.
Sep 22, 2007 * Added g:netrw_noretmap to netrw at Tony M's
request.
* Included path to NetrwRemoteRmFile()
v112: Aug 18, 2007 * added mx (|netrw-mx|) for executing arbitrary
commands on marked files
Aug 22, 2007 * more option save/restore work for
s:NetrwBrowseChgDir(); s:NetrwOptionSave()
and s:NetrwOptionRestore() now take a parameter
specifying the type of variables to be used for
saving and restoring (either "w:" or "s:")
Sep 04, 2007 * added the :NetrwClean[!] command
v111: Jul 25, 2007 * using Windows but not using Cygwin, netrw does a
"file bufname" where the bufname uses /s
instead of \s; Vim "fixes" it by changing the
bufname to use \s anyway. This meant that
NetrwGetBuffer() didn't find the appropriately
named buffer, and so would generate a new
buffer listing; hence the cursor would appear
to have been moved when doing a preview.
* added <2-leftmouse> map to return to netrw's
browser display
Aug 16, 2007 * added the mark-file system, including
maps for mf mp mt mz and mu. Modifications
made to maps for a D O and R to support
marked files.
v110: May 10, 2007 * added [ and ] maps to NetrwTreeListing
May 25, 2007 * |g:netrw_preview| included
May 29, 2007 * modifed netrw#NetBrowseX to consistently use
g:netrw_shq instead of hardcoded quotes,
and modified the snippet that sets up redir
so Windows machines use "nul" instead of
"/dev/null".
Jun 01, 2007 * fixed bug -- NetGetBuffer() wasn't always
recognizing a buffer name match when it should,
thus resulting in [Scratch] buffers.
Jun 04, 2007 * Gary Johnson found a bugfix for the "c" mapping
when the directory is to be made current but
the name contains spaces.
v109: Mar 26, 2007 * if a directory name includes a "$" character,
Explore() will use expand() in an attempt to
decipher the name.
May 07, 2007 * g:netrw_use_errorwindow now allows one to
have error messages go to a reliable window
or to use a less reliable but recallable
echoerr method
May 07, 2007 * g:netrw_scpport and g:netrw_sshport support
use of -P and -p, respectively, to set port
for scp/ssh.
v108: Jan 03, 2007 * included preview map (|netrw-p|), supporting
remote browsing
* netrw can now source remote files
Jan 26, 2007 * Colton Jamieson noted that remote directory
browsing did not support alternate port
selection. This feature has now been extended
to apply to all remote browsing commands via ssh.
(list, remove/delete, rename)
Jan 31, 2007 * Luis Florit reported that @* was an invalid
register. The @* register is now only saved and
restored if |'guioptions'| contains "a".
Feb 02, 2007 * Fixed a bug that cropped up when writing files
via scp using cygwin
Feb 08, 2007 * tree listing mode managed to stop working again;
fixed again!
Feb 15, 2007 * Guido Van Hoecke reported that netrw didn't
handle browsing well with M$ ftp servers. He even
set up a temporary account for me to test with
(thanks!). Netrw now can browse M$ ftp servers.
v107: Oct 12, 2006 * bypassed the autowrite option
Oct 24, 2006 * handles automatic decompression of *.gz and *.bz2
files
Nov 03, 2006 * Explore will highlight matching files when
**/pattern is used (and if the |'hls'| option
is set)
Nov 09, 2006 * a debugging line, when enabled, was inadvertently
bringing up help instead of simply reporting on
list contents
Nov 21, 2006 * tree listing improved (cursor remains put)
Nov 27, 2006 * fixed b:netrw_curdir bug when repeated "i"s were
pressed.
Dec 15, 2006 * considerable qty of changes, mostly to share more
code between local and remote browsing. Includes
support for tree-style listing for both remote
and local browsing.
Dec 15, 2006 * Included Peter Bengtsson's modifications to
support the Amiga.
v106: Sep 21, 2006 * removed old v:version<700 code as netrw now
requires vim 7.0
* worked around a bug where register * was
overwritten during local browsing
v104: Sep 05, 2006 * as suggested by Rodolfo Borges, :Explore and
variants will position the cursor on the file
just having been edited
* changed default |g:netrw_sort_sequence| order
* changed b, Nb to simply mb (see |netrw-mb|)
* changed B, NB to simply gb (see |netrw-gb|)
* tree listing style (see |g:netrw_liststyle|)
* attempts to retain the alternate file
v103: Jul 26, 2006 * used Yakov Lerner's tip#1289 to improve netrw
error message display
* wide listings didn't handle files with backslashes
in their names properly. A symptom was an
inability to open files.
Aug 09, 2006 * included "t" mapping for opening tabbed windows,
both for remote and local browsing
* changed netrw_longlist to netrw_liststyle
Aug 15, 2006 * fixed one of the NB maps
Aug 22, 2006 * changed *Explore commands to use -nargs=* instead
of -nargs=?. Allows both -complete=dir _and_ the
starstar arguments to work (-nargs=? seems to
require one or the other).
Aug 23, 2006 * copied all w:.. variables across splits to
new windows
Aug 25, 2006 * when g:netrw_browsex_viewer was '-'
(see |g:netrw_browsex_viewer|) it wasn't causing
netrwFileHandlers#Invoke() to be called as it
was expected to. (tnx Steve Dugaro)
Aug 29, 2006 * changed NetBrowseX() to use "setlocal ... noswf"
instead of "set ... noswf" (tnx Benji Fisher)
Aug 31, 2006 * tabs and fastbrowse<=1 didn't work together.
v102: Jun 15, 2006 * chgd netrwPlugin to call netrw#LocalBrowseCheck()
* bugfix: g:netrw_keepdir==0 had stopped working
Jul 06, 2006 * bugfix: NetOptionSave/Restore now saves/restores
the unnamed register (|registers|)
Jul 07, 2006 * |g:netrw_menu| support included
Jul 13, 2006 * :Texplore command implemented
Jul 17, 2006 * NetSplit and (Local|Net)BrowseChgDir() were both
splitting windows. This affected o, v, and
g:netrw_browse_split.
Jul 20, 2006 * works around wildignore setting (was causing
netrw's local browser not to list wildignore'd
files)
Jul 24, 2006 * <leftmouse> acts as a <cr> for selecting a file <rightmouse> acts as a <del> for deleting a file
v100: May 14, 2006 * when using Windows and shell==cmd.exe, the
default for g:netrw_ignorenetrc is now 1
* bugfix: unwanted ^Ms now removed
(affected shell==cmd.exe - Windows)
* added Bookmarks and History to the menu
* an error message about non-existing
w:netrw_longlist was appearing during attempts to
Explore (fixed)
* g:netrw_shq now available to make netrw use
specified style of quotes for commands
May 29, 2006 * user NFH_*() functions were inadvertently being
ignored
* fixed a Windows non-cygwin ftp handling problem.
* hiding pattern candidate separators included some
characters it shouldn't have (tnx to Osei Poku)
Jun 01, 2006 * for browsing, netrw was supposed to use "dir"
instead of "ls -lF" when using
ftp+non-cygwin+windows. Fixed.
* an inadvertently left-in-place debugging statement
was preventing use of the "x" key with browsing.
Jun 05, 2006 * g:netrw_nogx available to prevent making the gx
map (see |g:netrw_nogx|)
* bugfix, Explore wouldn't change directory
properly (vim ., :Explore subdirname)
Jun 06, 2006 * moved history to 2nd line in Netrw menu
* fixed delete for unix-based systems
Jun 07, 2006 * x key now works for windows-noncygwin-ftp
Jun 08, 2006 * Explore */pat and **//pat now wraps
v99: May 09, 2006 * g:netrw_browse_split=3 for opening files in new
tabs implemented.
May 12, 2006 * deletes temporary file at end of NetRead()
* visual mode based Obtain implemented
* added -complete=dir to the various Explore
commands
v98: May 02, 2006 * the "p" key didn't work properly when the browsing
directory name had spaces in it.
v97: May 01, 2006 * exists("&acd") now used to determine if
the 'acd' option exists
* "obtain" now works again under Windows
v96: * bugfix - the |'acd'| option is not always defined
but is now bypassed only when it is
v95: * bugfix - Hiding mode worked correctly (don't show
any file matching any of the g:netrw_hide
patterns), but showing mode was showing only those
files that didn't match any of the g:netrw_hide
patterns. Instead, it now shows all files that
match any of the g:netrw_hide patterns (the
difference between a logical and and logical or).
v94: * bugfix - a Decho() had a missing quote; only
affects things when debugging was enabled.
v93: * bugfix - removed FocusGained event from causing a
slow-browser refresh for Windows
v92: * :Explore **//pattern implemented
(**/filepattern was already taken)
v91: * :Explore */pattern implemented
* |'acd'| option bypassed
v90: * mark ', as suggested by Yegappan Lakshmanan, used
to help guarantee entry into the jump list when
appropriate.
* <s-down> and <s-up> are no longer defined until a
:Explore **/pattern is used (if the user already
has a map for them). They will be defined for new
browser windows from that point forward.
v89: * A <s-down>, <s-up>, :Nexplore, or a :Pexplore
without having first done an :Explore **/pattern
(see |netrw-starstar|) caused
a lot of unhelpful error messages to appear
v88: * moved DrChip.Netrw menu to Netrw. Now has
priority 80 by default.
g:NetrwTopLvlMenu == "Netrw" and can be changed
by the user to suit. The priority is given by
g:NetrwMenuPriority.
* Changed filetype for browser displays from
netrwlist to netrw.
v87: * bug fix -- menus were partially disappearing
v85: * bug fix -- missing an endif
* bug fix -- handles spaces in names and directories
when using ftp-based browsing
v83: * disabled stop-acd handling; the change in directory
handling may allow acd to be used again.
* D was refusing to delete remote files/directories
in wide listing mode.
v81: * FocusGained also used to refresh/wipe local browser
directory buffers
* (bugfix) netrw was leaving [Scratch] buffers behind
when the user had the "hidden" option set. The 'hidden' option is now bypassed.
v80: * ShellCmdPost event used in conjunction with
g:netrw_fastbrowse to refresh/wipe local browser
directory buffers.
v79: * directories are now displayed with nowrap
* (bugfix) if the column width was smaller than the
largest file's name, then netrw would hang when
using wide-listing mode - fixed
* g:netrw_fastbrowse introduced
v78: * progress has been made on allowing spaces inside
directory names for remote work (reading, writing,
browsing). (scp)
v77: * Mikolaj Machowski fixed a bug in a substitute cmd
* g:netrw_browsex_viewer implemented
* Mikolaj Machowski pointed out that gnome-open is
often executable under KDE systems, although it is
effectively not functional. NetBrowseX now looks
for "kicker" as a running process to determine if
KDE is actually running.
* Explorer's O functionality was inadvertently left
out. Netrw now does the same thing, but with the
"P" key.
* added g:netrw_browse_split option
* fixed a bug where the directory contained a "." but
the file didn't (was treating the dirname from "."
onwards as a suffix)
v76: * "directory is missing" error message now restores
echo highlighting
v75: * file://... now conforms to RFC2396 (thanks to
S. Zacchiroli)
* if the binary option is set, then NetWrite() will
only write the whole file (line numbers don't make
sense with this). Supports writing of tar and zip
files.
v74: * bugfix (vim, then :Explore) now works
* ctrl-L keeps cursor at same screen location (both
local and remote browsing)
* netrw now can read remote zip and tar files
* Obtain now uses WinXP ftp+.netrc successfully
v73: * bugfix -- scp://host/path/file was getting named
incorrectly
* netrw detects use of earlier-than-7.0 version of
vim and issues a pertinent error message.
* netrwSettings.vim is now uses autoloading. Only
<netrwPlugin.vim> is needed as a pure plugin
(ie. always loaded).
v72: * bugfix -- formerly, one could prevent the loading
of netrw by "let g:loaded_netrw=1"; when
autoloading became supported, this feature was
lost. It is now restored.
v71: * bugfix -- made some "set nomodifiable"s into
setlocal variants (allows :e somenewfile to be
modifiable as usual)
* NetrwSettings calls a netrw function, thereby
assuring that netrw has loaded. However, if netrw
does not load for whatever reason, then
NetrwSettings will now issue a warning message.
* For what reason I don't recall, when wget and fetch
are both not present, and an attempt to read a http://... url is made, netrw exited. It now only
returns.
* When ch=1, on the second and subsequent uses of
browsing Netrw would issue a blank line to clear
the echo'd messages. This caused an annoying
"Hit-Enter" prompt; now a blank line message
is echo'd only if &ch>1.
v70: * when using |netrw-O|, the "Obtaining filename"
message is now shown using |hl-User9|. If User9
has not been defined, netrw itself will define it.
v69: * Bugfix: win95/98 machines were experiencing a
"E121: Undefined variable: g:netrw_win95ftp"
message
v68: * double-click-leftmouse selects word under mouse
v67: * Passwords which contain blanks will now be
surrounded by double-quotes automatically (Yongwei)
v66: * Netrw now seems to work with a few more Windows
situations
* O now obtains a file: remote browsing
file -> local copy, locally browsing
file -> current directory (see :pwd)
* i now cycles between thin, long, and wide listing
styles
* NB and Nb are maps that are always available;
corresponding B and b maps are only available when
not using wide listing in order to allow them to
be used for motions
v65: * Browser functions now use NetOptionSave/Restore; in
particular, netrw now works around the report
setting
v64: * Bugfix - browsing a "/" directory (Unix) yielded
buffers named "[Scratch]" instead of "/"
* Bugfix - remote browsing with ftp was omitting
the ./ and ../
v63: * netrw now takes advantage of autoload (needs 7.0)
* Bugfix - using r (to reverse sort) working again
v62: * Bugfix - spaces allowed again in directory names
with g:netrw_keepdir=0. In fact, I've tested netrw
with most ANSI punctuation marks for directory
names.
* Bugfix - NetrwSettings gave errors when
g:netrw_silent had not be set.
v61: * Document upgrade -- netrw variable-based settings
all should have tags. Supports NetrwSettings cmd.
* Several important variables are window-oriented.
Netrw has to transfer these across a window split.
See s:BufWinVars() and s:UseBufWinVars().
v60: * When using the i map to switch between long and
short listings, netrw will now keep cursor on same
line
* "Match # of #" now uses status line
* :Explore **/*.c will now work from a
non-netrw-browser window
* :Explore **/patterns can now be run in separate
browser windows
* active banner (hit <cr> will cause various things
to happen)
v59: * bugfix -- another keepalt work-around installed
(for vim6.3)
* "Match # of #" for Explore **/pattern matches
v58: * Explore and relatives can now handle
**/somefilepattern (v7)
* Nexplore and Pexplore introduced (v7). shift-down
and shift-up cursor keys will invoke Nexplore and
Pexplore, respectively.
* bug fixed with o and v
* autochdir only worked around for vim when it has
been compiled with either |+netbeans_intg| or |+sun_workshop|
* Under Windows, all directories and files were
being preceded with a "/" when local browsing.
Fixed.
* When: syntax highlighting is off, laststatus=2, and
remote browsing is used, sometimes the laststatus
highlighting bleeds into the entire display. Work
around - do an extra redraw in that case.
* Bugfix: when g:netrw_keepdir=0, due to re-use of
buffers, netrw didn't change the directory when it
should've
* Bugfix: D and R commands work again
v57: * Explore and relatives can now handle RO files
* reverse sort restored with vim7's sort command
* g:netrw_keepdir now being used to keep the current
directory unchanged as intended (sense change)
* vim 6.3 still supported
v56: * LocalBrowse now saves autochdir setting, unsets it,
and restores it before returning.
* using vim's rename() instead of system +
local_rename variable
* avoids changing directory when g:netrw_keepdir is
false
v55: * -bar used with :Explore :Sexplore etc to allow
multiple commands to be separated by |s
* browser listings now use the "nowrap" option
* browser: some unuseful error messages now
suppressed
v54: * For backwards compatibility, Explore and Sexplore
have been implemented. In addition, Hexplore and
Vexplore commands are available, too.
* <amatch> used instead of <afile> in the
transparency support (BufReadCmd, FileReadCmd,
FileWriteCmd)
* ***netrw*** prepended to various error messages
netrw may emit
* g:netrw_port used instead of b:netrw_port for scp
* any leading [:#] is removed from port numbers
v53: * backslashes as well as slashes placed in various
patterns (ex. g:netrw_sort_sequence) to better
support Windows
v52: * nonumber'ing now set for browsing buffers
* when the hiding list hid all files, error messages
ensued. Fixed
* when browsing, swf is set, but directory is not
set, when netrw was attempting to restore options,
vim wanted to save a swapfile to a local directory
using an url-style path. Fixed
v51: * cygwin detection now automated
(using windows and &shell is bash)
* customizable browser "file" rejection patterns
* directory history
* :[range]w url now supported (ie. netrw uses a
FileWriteCmd event)
* error messages have a "Press <cr> to continue" to
allow them to be seen
* directory browser displays no longer bother the
swapfile
* u/U commands to go up and down the history stack
* history stack may be saved with viminfo with it's
"!" option
* bugfixes associated with unwanted [No Files]
entries
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)
* 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, which
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 browsing.
v46: * now handles remote browsing
* g:netrw_silent (if 1) will cause all transfers to
be silent
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|)
* <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
* 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
* 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 happening
Vim editor by Bram Moolenaar (Thanks, Bram!)
dav support by C Campbell
fetch support by Bram Moolenaar and C Campbell
ftp support by C Campbell <NdrOchip@ScampbellPfamily.AbizM>
http support by Bram Moolenaar <bram@moolenaar.net>
rcp
rsync support by C Campbell (suggested by Erik Warendorph)
scp support by raf <raf@comdyn.com.au>
sftp support by C Campbell
inputsecret(), BufReadCmd, BufWriteCmd contributed by C Campbell
Jérôme Augé -- also using new buffer method with ftp+.netrc
Bram Moolenaar -- obviously vim itself, :e and v:cmdarg use,
fetch,...
Yasuhiro Matsumoto -- pointing out undo+0r problem and a solution
Erik Warendorph -- for several suggestions (g:netrw_..._cmd
variables, rsync etc)
Doug Claar -- modifications to test for success with ftp
operation
==============================================================================
Modelines: {{{1
vim:tw=78:ts=8:ft=help:norl:fdm=marker top - main help file