Netrw.vim

netrw.vim plugin from vim (upstream repository)

The upstream maintained netrw plugin. The original has been created and maintained by Charles E Campbell and maintained by the vim project until v9.1.0988.

Every major version a snapshot from here will be sent to the main [Vim][1] upstream for distribution with Vim.

License

To see License informations see the LICENSE.txt file included in this repository.

Credits

Below are stated the contribution made in the past to netrw.

Changes made to autoload/netrw.vim:

• 2023 Nov 21 by Vim Project: ignore wildignore when expanding $COMSPEC (v173a)
• 2023 Nov 22 by Vim Project: fix handling of very long filename on longlist style (v173a)
• 2024 Feb 19 by Vim Project: (announce adoption)
• 2024 Feb 29 by Vim Project: handle symlinks in tree mode correctly
• 2024 Apr 03 by Vim Project: detect filetypes for remote edited files
• 2024 May 08 by Vim Project: cleanup legacy Win9X checks
• 2024 May 09 by Vim Project: remove hard-coded private.ppk
• 2024 May 10 by Vim Project: recursively delete directories by default
• 2024 May 13 by Vim Project: prefer scp over pscp
• 2024 Jun 04 by Vim Project: set bufhidden if buffer changed, nohidden is set and buffer shall be switched (#14915)
• 2024 Jun 13 by Vim Project: glob() on Windows fails when a directory name contains [] (#14952)
• 2024 Jun 23 by Vim Project: save ad restore registers when liststyle = WIDELIST (#15077, #15114)
• 2024 Jul 22 by Vim Project: avoid endless recursion (#15318)
• 2024 Jul 23 by Vim Project: escape filename before trying to delete it (#15330)
• 2024 Jul 30 by Vim Project: handle mark-copy to same target directory (#12112)
• 2024 Aug 02 by Vim Project: honor g:netrw_alt{o,v} for :{S,H,V}explore (#15417)
• 2024 Aug 15 by Vim Project: style changes, prevent E121 (#15501)
• 2024 Aug 22 by Vim Project: fix mf-selection highlight (#15551)
• 2024 Aug 22 by Vim Project: adjust echo output of mx command (#15550)
• 2024 Sep 15 by Vim Project: more strict confirmation dialog (#15680)
• 2024 Sep 19 by Vim Project: mf-selection highlight uses wrong pattern (#15700)
• 2024 Sep 21 by Vim Project: remove extraneous closing bracket (#15718)
• 2024 Oct 21 by Vim Project: remove netrwFileHandlers (#15895)
• 2024 Oct 27 by Vim Project: clean up gx mapping (#15721)
• 2024 Oct 30 by Vim Project: fix filetype detection for remote files (#15961)
• 2024 Oct 30 by Vim Project: fix x mapping on cygwin (#13687)
• 2024 Oct 31 by Vim Project: add netrw#Launch() and netrw#Open() (#15962)
• 2024 Oct 31 by Vim Project: fix E874 when browsing remote dir (#15964)
• 2024 Nov 07 by Vim Project: use keeppatterns to prevent polluting the search history
• 2024 Nov 07 by Vim Project: fix a few issues with netrw tree listing (#15996)
• 2024 Nov 10 by Vim Project: directory symlink not resolved in tree view (#16020)
• 2024 Nov 14 by Vim Project: small fixes to netrw#BrowseX (#16056)
• 2024 Nov 23 by Vim Project: update decompress defaults (#16104)
• 2024 Nov 23 by Vim Project: fix powershell escaping issues (#16094)
• 2024 Dec 04 by Vim Project: do not detach for gvim (#16168)
• 2024 Dec 08 by Vim Project: check the first arg of netrw_browsex_viewer for being executable (#16185)
• 2024 Dec 12 by Vim Project: do not pollute the search history (#16206)
• 2024 Dec 19 by Vim Project: change style (#16248)
• 2024 Dec 20 by Vim Project: change style continued (#16266), fix escaping of # in :Open command (#16265)

General changes made to netrw:

	v172:	Sep 02, 2021	* (Bram Moolenaar) Changed "l:go" to "go"
				* (Bram Moolenaar) no need for "b" in
				  netrw-safe guioptions
		Nov 15, 2021	* removed netrw_localrm and netrw_localrmdir
				  references
		Aug 18, 2022	* (Miguel Barro) improving compatibility with
				  powershell
	v171:	Oct 09, 2020	* included code in s:NetrwOptionsSafe()
				  to allow |'bh'| to be set to delete when
				  rather than hide when g:netrw_fastbrowse
				  was zero.
				* Installed |g:netrw_clipboard| setting
				* Installed option bypass for |'guioptions'|
				  a/A settings
				* Changed popup_beval() to |popup_atcursor()|
				  in netrw#ErrorMsg (lacygoill). Apparently
				  popup_beval doesn't reliably close the
				  popup when the mouse is moved.
				* VimEnter() now using win_execute to examine
				  buffers for an attempt to open a directory.
				  Avoids issues with popups/terminal from
				  command line. (lacygoill)
		Jun 28, 2021	* (zeertzjq) provided a patch for use of
				  xmap,xno instead of vmap,vno in
				  netrwPlugin.vim. Avoids entanglement with
				  select mode.
		Jul 14, 2021	* Fixed problem addressed by tst976; opening
				  a file using tree mode, going up a
				  directory, and opening a file there was
				  opening the file in the wrong directory.
		Jul 28, 2021	* (Ingo Karkat) provided a patch fixing an
				  E488 error with netrwPlugin.vim
				  (occurred for vim versions < 8.02)
	v170:	Mar 11, 2020	* (reported by Reiner Herrmann) netrw+tree
				  would not hide with the ^\..* pattern
				  correctly.
				* (Marcin Szamotulski) NetrwOptionRestore
				  did not restore options correctly that
				  had a single quote in the option string.
		Apr 13, 2020	* implemented error handling via popup
				  windows (see |popup_beval()|)
		Apr 30, 2020	* (reported by Manatsu Takahashi) while
				  using Lexplore, a modified file could
				  be overwritten.  Sol'n: will not overwrite,
				  but will emit an |E37| (although one cannot
				  add an ! to override)
		Jun 07, 2020	* (reported by Jo Totland) repeatedly invoking
				  :Lexplore and quitting it left unused
				  hidden buffers.  Netrw will now set netrw
				  buffers created by :Lexplore to |'bh'|=wipe.
	v169:	Dec 20, 2019	* (reported by amkarthik) that netrw's x
				  (|netrw-x|) would throw an error when
				  attempting to open a local directory.
	v168:	Dec 12, 2019	* scp timeout error message not reported,
				  hopefully now fixed (Shane Xb Qian)
	v167:	Nov 29, 2019	* netrw does a save&restore on @* and @+.
				  That causes problems with the clipboard.
				  Now restores occurs only if @* or @+ have
				  been changed.
				* netrw will change @* or @+ less often.
				  Never if I happen to have caught all the
				  operations that modify the unnamed
				  register (which also writes @*).
				* Modified hiding behavior so that "s"
				  will not ignore hiding.
	v166:	Nov 06, 2019	* Removed a space from a nmap for "-"
				* Numerous debugging statement changes
	v163:	Dec 05, 2017	* (Cristi Balan) reported that a setting ('sel')
				  was left changed
				* (Holger Mitschke) reported a problem with
				  saving and restoring history.  Fixed.
				* Hopefully I fixed a nasty bug that caused a
				  file rename to wipe out a buffer that it
				  should not have wiped out.
				* (Holger Mitschke) amended this help file
				  with additional |g:netrw_special_syntax|
				  items
				* Prioritized wget over curl for
				  g:netrw_http_cmd
	v162:	Sep 19, 2016	* (haya14busa) pointed out two syntax errors
				  with a patch; these are now fixed.
		Oct 26, 2016	* I started using mate-terminal and found that
				  x and gx (|netrw-x| and |netrw-gx|) were no
				  longer working.  Fixed (using atril when
				  $DESKTOP_SESSION is "mate").
		Nov 04, 2016	* (Martin Vuille) pointed out that @+ was
				  being restored with keepregstar rather than
				  keepregplus.
		Nov 09, 2016	* Broke apart the command from the options,
				  mostly for Windows.  Introduced new netrw
				  settings: |g:netrw_localcopycmdopt|
				  |g:netrw_localcopydircmdopt|
				  |g:netrw_localmkdiropt|
				  |g:netrw_localmovecmdopt|
		Nov 21, 2016	* (mattn) provided a patch for preview; swapped
				  winwidth() with winheight()
		Nov 22, 2016	* (glacambre) reported that files containing
				  spaces weren't being obtained properly via
				  scp.  Fix: apparently using single quotes
				  such as with 'file name' wasn't enough; the
				  spaces inside the quotes also had to be
				  escaped (ie. 'file\ name').
				* Also fixed obtain (|netrw-O|) to be able to
				  obtain files with spaces in their names
		Dec 20, 2016	* (xc1427) Reported that using "I" (|netrw-I|)
				  when atop "Hiding" in the banner also caused
				  the active-banner hiding control to occur
		Jan 03, 2017	* (Enno Nagel) reported that attempting to
				  apply netrw to a directory that was without
				  read permission caused a syntax error.
		Jan 13, 2017	* (Ingo Karkat) provided a patch which makes
				  using netrw#Call() better.  Now returns
				  value of internal routines return, for example.
		Jan 13, 2017	* (Ingo Karkat) changed netrw#FileUrlRead to
				  use |:edit| instead of |:read|.  I also
				  changed the routine name to netrw#FileUrlEdit.
		Jan 16, 2017	* (Sayem) reported a problem where :Lexplore
				  could generate a new listing buffer and
				  window instead of toggling the netrw display.
				  Unfortunately, the directions for eliciting
				  the problem weren't complete, so I may or
				  may not have fixed that issue.
		Feb 06, 2017	* Implemented cb and cB.  Changed "c" to "cd".
				  (see |netrw-cb|, |netrw-cB|, and |netrw-cd|)
		Mar 21, 2017	* previously, netrw would specify (safe) settings
				  even when the setting was already safe for
				  netrw.  Netrw now attempts to leave such
				  already-netrw-safe settings alone.
				  (affects s:NetrwOptionRestore() and
				  s:NetrwSafeOptions(); also introduced
				  s:NetrwRestoreSetting())
		Jun 26, 2017	* (Christian Brabandt) provided a patch to
				  allow curl to follow redirects (ie. -L
				  option)
		Jun 26, 2017	* (Callum Howard) reported a problem with
				  :Lexpore not removing the Lexplore window
				  after a change-directory
		Aug 30, 2017	* (Ingo Karkat) one cannot switch to the
				  previously edited file (e.g. with CTRL-^)
				  after editing a file:// URL.  Patch to
				  have a "keepalt" included.
		Oct 17, 2017	* (Adam Faryna) reported that gn (|netrw-gn|)
				  did not work on directories in the cur