annotate runtime/doc/pi_netrw.txt @ 24594:5c456a88f651 v8.2.2836

patch 8.2.2836: build failure without the +quickfix feature Commit: https://github.com/vim/vim/commit/b7c978154e0816f4dcfae8a06b4ba1bfb7f796f6 Author: Bram Moolenaar <Bram@vim.org> Date: Wed May 5 22:51:39 2021 +0200 patch 8.2.2836: build failure without the +quickfix feature Problem: Build failure without the +quickfix feature. (John Marriott) Solution: Add #ifdef.
author Bram Moolenaar <Bram@vim.org>
date Wed, 05 May 2021 23:00:03 +0200
parents 75ff30a78189
children fd37be6dc258
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
1 *pi_netrw.txt* For Vim version 8.2. Last change: 2020 Sep 19
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3 ------------------------------------------------
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
4 NETRW REFERENCE MANUAL by Charles E. Campbell
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
5 ------------------------------------------------
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
6 Author: Charles E. Campbell <NcampObell@SdrPchip.AorgM-NOSPAM>
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
7 (remove NOSPAM from Campbell's email first)
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
8
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
9 Copyright: Copyright (C) 2017 Charles E Campbell *netrw-copyright*
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
10 The VIM LICENSE applies to the files in this package, including
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
11 netrw.vim, pi_netrw.txt, netrwFileHandlers.vim, netrwSettings.vim, and
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
12 syntax/netrw.vim. Like anything else that's free, netrw.vim and its
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
13 associated files are provided *as is* and comes with no warranty of
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
14 any kind, either expressed or implied. No guarantees of
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
15 merchantability. No guarantees of suitability for any purpose. By
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
16 using this plugin, you agree that in no event will the copyright
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
17 holder be liable for any damages resulting from the use of this
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
18 software. Use at your own risk!
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
20 *netrw*
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
21 *dav* *ftp* *netrw-file* *rcp* *scp*
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
22 *davs* *http* *netrw.vim* *rsync* *sftp*
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
23 *fetch* *network*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 ==============================================================================
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
26 1. Contents *netrw-contents* {{{1
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
28 1. Contents..............................................|netrw-contents|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
29 2. Starting With Netrw...................................|netrw-start|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
30 3. Netrw Reference.......................................|netrw-ref|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
31 EXTERNAL APPLICATIONS AND PROTOCOLS.................|netrw-externapp|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
32 READING.............................................|netrw-read|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
33 WRITING.............................................|netrw-write|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
34 SOURCING............................................|netrw-source|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
35 DIRECTORY LISTING...................................|netrw-dirlist|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
36 CHANGING THE USERID AND PASSWORD....................|netrw-chgup|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
37 VARIABLES AND SETTINGS..............................|netrw-variables|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
38 PATHS...............................................|netrw-path|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
39 4. Network-Oriented File Transfer........................|netrw-xfer|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
40 NETRC...............................................|netrw-netrc|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
41 PASSWORD............................................|netrw-passwd|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
42 5. Activation............................................|netrw-activate|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
43 6. Transparent Remote File Editing.......................|netrw-transparent|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
44 7. Ex Commands...........................................|netrw-ex|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
45 8. Variables and Options.................................|netrw-variables|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
46 9. Browsing..............................................|netrw-browse|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
47 Introduction To Browsing............................|netrw-intro-browse|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
48 Quick Reference: Maps...............................|netrw-browse-maps|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
49 Quick Reference: Commands...........................|netrw-browse-cmds|
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
50 Banner Display......................................|netrw-I|
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
51 Bookmarking A Directory.............................|netrw-mb|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
52 Browsing............................................|netrw-cr|
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
53 Squeezing the Current Tree-Listing Directory........|netrw-s-cr|
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
54 Browsing With A Horizontally Split Window...........|netrw-o|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
55 Browsing With A New Tab.............................|netrw-t|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
56 Browsing With A Vertically Split Window.............|netrw-v|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
57 Change Listing Style.(thin wide long tree)..........|netrw-i|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
58 Changing To A Bookmarked Directory..................|netrw-gb|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
59 Changing To A Predecessor Directory.................|netrw-u|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
60 Changing To A Successor Directory...................|netrw-U|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
61 Customizing Browsing With A Special Handler.........|netrw-x|
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
62 Deleting Bookmarks..................................|netrw-mB|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
63 Deleting Files Or Directories.......................|netrw-D|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
64 Directory Exploring Commands........................|netrw-explore|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
65 Exploring With Stars and Patterns...................|netrw-star|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
66 Displaying Information About File...................|netrw-qf|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
67 Edit File Or Directory Hiding List..................|netrw-ctrl-h|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
68 Editing The Sorting Sequence........................|netrw-S|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
69 Forcing treatment as a file or directory............|netrw-gd| |netrw-gf|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
70 Going Up............................................|netrw--|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
71 Hiding Files Or Directories.........................|netrw-a|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
72 Improving Browsing..................................|netrw-ssh-hack|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
73 Listing Bookmarks And History.......................|netrw-qb|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
74 Making A New Directory..............................|netrw-d|
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
75 Making The Browsing Directory The Current Directory.|netrw-cd|
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
76 Marking Files.......................................|netrw-mf|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
77 Unmarking Files.....................................|netrw-mF|
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
78 Marking Files By Location List......................|netrw-qL|
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
79 Marking Files By QuickFix List......................|netrw-qF|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
80 Marking Files By Regular Expression.................|netrw-mr|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
81 Marked Files: Arbitrary Shell Command...............|netrw-mx|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
82 Marked Files: Arbitrary Shell Command, En Bloc......|netrw-mX|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
83 Marked Files: Arbitrary Vim Command.................|netrw-mv|
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
84 Marked Files: Argument List.........................|netrw-ma| |netrw-mA|
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
85 Marked Files: Buffer List...........................|netrw-cb| |netrw-cB|
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
86 Marked Files: Compression And Decompression.........|netrw-mz|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
87 Marked Files: Copying...............................|netrw-mc|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
88 Marked Files: Diff..................................|netrw-md|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
89 Marked Files: Editing...............................|netrw-me|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
90 Marked Files: Grep..................................|netrw-mg|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
91 Marked Files: Hiding and Unhiding by Suffix.........|netrw-mh|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
92 Marked Files: Moving................................|netrw-mm|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
93 Marked Files: Printing..............................|netrw-mp|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
94 Marked Files: Sourcing..............................|netrw-ms|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
95 Marked Files: Setting the Target Directory..........|netrw-mt|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
96 Marked Files: Tagging...............................|netrw-mT|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
97 Marked Files: Target Directory Using Bookmarks......|netrw-Tb|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
98 Marked Files: Target Directory Using History........|netrw-Th|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
99 Marked Files: Unmarking.............................|netrw-mu|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
100 Netrw Browser Variables.............................|netrw-browser-var|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
101 Netrw Browsing And Option Incompatibilities.........|netrw-incompatible|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
102 Netrw Settings Window...............................|netrw-settings-window|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
103 Obtaining A File....................................|netrw-O|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
104 Preview Window......................................|netrw-p|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
105 Previous Window.....................................|netrw-P|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
106 Refreshing The Listing..............................|netrw-ctrl-l|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
107 Reversing Sorting Order.............................|netrw-r|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
108 Renaming Files Or Directories.......................|netrw-R|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
109 Selecting Sorting Style.............................|netrw-s|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
110 Setting Editing Window..............................|netrw-C|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
111 10. Problems and Fixes....................................|netrw-problems|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
112 11. Debugging Netrw Itself................................|netrw-debug|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
113 12. History...............................................|netrw-history|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
114 13. Todo..................................................|netrw-todo|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
115 14. Credits...............................................|netrw-credits|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 ==============================================================================
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
118 2. Starting With Netrw *netrw-start* {{{1
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
119
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
120 Netrw makes reading files, writing files, browsing over a network, and
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
121 local browsing easy! First, make sure that you have plugins enabled, so
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
122 you'll need to have at least the following in your <.vimrc>:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
123 (or see |netrw-activate|) >
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
124
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
125 set nocp " 'compatible' is not set
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
126 filetype plugin on " plugins are enabled
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
127 <
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
128 (see |'cp'| and |:filetype-plugin-on|)
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
129
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
130 Netrw supports "transparent" editing of files on other machines using urls
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
131 (see |netrw-transparent|). As an example of this, let's assume you have an
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
132 account on some other machine; if you can use scp, try: >
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
133
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
134 vim scp://hostname/path/to/file
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
135 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
136 Want to make ssh/scp easier to use? Check out |netrw-ssh-hack|!
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
137
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
138 So, what if you have ftp, not ssh/scp? That's easy, too; try >
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
139
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
140 vim ftp://hostname/path/to/file
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
141 <
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
142 Want to make ftp simpler to use? See if your ftp supports a file called
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
143 <.netrc> -- typically it goes in your home directory, has read/write
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
144 permissions for only the user to read (ie. not group, world, other, etc),
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
145 and has lines resembling >
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
146
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
147 machine HOSTNAME login USERID password "PASSWORD"
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
148 machine HOSTNAME login USERID password "PASSWORD"
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
149 ...
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
150 default login USERID password "PASSWORD"
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
151 <
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
152 Windows' ftp doesn't support .netrc; however, one may have in one's .vimrc: >
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
153
4502
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
154 let g:netrw_ftp_cmd= 'c:\Windows\System32\ftp -s:C:\Users\MyUserName\MACHINE'
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
155 <
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
156 Netrw will substitute the host's machine name for "MACHINE" from the URL it is
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
157 attempting to open, and so one may specify >
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
158 userid
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
159 password
4502
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
160 for each site in a separate file: c:\Users\MyUserName\MachineName.
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
161
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
162 Now about browsing -- when you just want to look around before editing a
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
163 file. For browsing on your current host, just "edit" a directory: >
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
164
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
165 vim .
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
166 vim /home/userid/path
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
167 <
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
168 For browsing on a remote host, "edit" a directory (but make sure that
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
169 the directory name is followed by a "/"): >
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
170
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
171 vim scp://hostname/
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
172 vim ftp://hostname/path/to/dir/
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
173 <
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
174 See |netrw-browse| for more!
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
175
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
176 There are more protocols supported by netrw than just scp and ftp, too: see the
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
177 next section, |netrw-externapp|, on how to use these external applications with
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
178 netrw and vim.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
179
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
180 PREVENTING LOADING *netrw-noload*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
181
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
182 If you want to use plugins, but for some reason don't wish to use netrw, then
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
183 you need to avoid loading both the plugin and the autoload portions of netrw.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
184 You may do so by placing the following two lines in your <.vimrc>: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
185
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
186 :let g:loaded_netrw = 1
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
187 :let g:loaded_netrwPlugin = 1
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
188 <
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
189
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
190 ==============================================================================
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
191 3. Netrw Reference *netrw-ref* {{{1
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
192
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
193 Netrw supports several protocols in addition to scp and ftp as mentioned
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
194 in |netrw-start|. These include dav, fetch, http,... well, just look
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
195 at the list in |netrw-externapp|. Each protocol is associated with a
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
196 variable which holds the default command supporting that protocol.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
197
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
198 EXTERNAL APPLICATIONS AND PROTOCOLS *netrw-externapp* {{{2
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
199
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
200 Protocol Variable Default Value
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
201 -------- ---------------- -------------
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
202 dav: *g:netrw_dav_cmd* = "cadaver" if cadaver is executable
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
203 dav: g:netrw_dav_cmd = "curl -o" elseif curl is available
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
204 fetch: *g:netrw_fetch_cmd* = "fetch -o" if fetch is available
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
205 ftp: *g:netrw_ftp_cmd* = "ftp"
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
206 http: *g:netrw_http_cmd* = "elinks" if elinks is available
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
207 http: g:netrw_http_cmd = "links" elseif links is available
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
208 http: g:netrw_http_cmd = "curl" elseif curl is available
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
209 http: g:netrw_http_cmd = "wget" elseif wget is available
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
210 http: g:netrw_http_cmd = "fetch" elseif fetch is available
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
211 http: *g:netrw_http_put_cmd* = "curl -T"
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
212 rcp: *g:netrw_rcp_cmd* = "rcp"
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
213 rsync: *g:netrw_rsync_cmd* = "rsync" (see |g:netrw_rsync_sep|)
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
214 scp: *g:netrw_scp_cmd* = "scp -q"
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
215 sftp: *g:netrw_sftp_cmd* = "sftp"
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
216 file: *g:netrw_file_cmd* = "elinks" or "links"
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
217
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
218 *g:netrw_http_xcmd* : the option string for http://... protocols are
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
219 specified via this variable and may be independently overridden. By
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
220 default, the option arguments for the http-handling commands are: >
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
221
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
222 elinks : "-source >"
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
223 links : "-dump >"
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
224 curl : "-L -o"
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
225 wget : "-q -O"
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
226 fetch : "-o"
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
227 <
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
228 For example, if your system has elinks, and you'd rather see the
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
229 page using an attempt at rendering the text, you may wish to have >
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
230 let g:netrw_http_xcmd= "-dump >"
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
231 < in your .vimrc.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
232
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
233 g:netrw_http_put_cmd: this option specifies both the executable and
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
234 any needed options. This command does a PUT operation to the url.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
235
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
236
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
237 READING *netrw-read* *netrw-nread* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
238
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
239 Generally, one may just use the URL notation with a normal editing
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
240 command, such as >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
241
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
242 :e ftp://[user@]machine/path
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
243 <
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
244 Netrw also provides the Nread command:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
245
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
246 :Nread ? give help
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
247 :Nread "machine:path" uses rcp
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
248 :Nread "machine path" uses ftp w/ <.netrc>
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
249 :Nread "machine id password path" uses ftp
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
250 :Nread "dav://machine[:port]/path" uses cadaver
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
251 :Nread "fetch://[user@]machine/path" uses fetch
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
252 :Nread "ftp://[user@]machine[[:#]port]/path" uses ftp w/ <.netrc>
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
253 :Nread "http://[user@]machine/path" uses http uses wget
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
254 :Nread "rcp://[user@]machine/path" uses rcp
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
255 :Nread "rsync://[user@]machine[:port]/path" uses rsync
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
256 :Nread "scp://[user@]machine[[:#]port]/path" uses scp
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
257 :Nread "sftp://[user@]machine/path" uses sftp
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
258
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
259 WRITING *netrw-write* *netrw-nwrite* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
260
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
261 One may just use the URL notation with a normal file writing
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
262 command, such as >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
263
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
264 :w ftp://[user@]machine/path
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
265 <
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
266 Netrw also provides the Nwrite command:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
267
794
f19994020dad updated for version 7.0231
vimboss
parents: 766
diff changeset
268 :Nwrite ? give help
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
269 :Nwrite "machine:path" uses rcp
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
270 :Nwrite "machine path" uses ftp w/ <.netrc>
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
271 :Nwrite "machine id password path" uses ftp
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
272 :Nwrite "dav://machine[:port]/path" uses cadaver
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
273 :Nwrite "ftp://[user@]machine[[:#]port]/path" uses ftp w/ <.netrc>
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
274 :Nwrite "rcp://[user@]machine/path" uses rcp
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
275 :Nwrite "rsync://[user@]machine[:port]/path" uses rsync
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
276 :Nwrite "scp://[user@]machine[[:#]port]/path" uses scp
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
277 :Nwrite "sftp://[user@]machine/path" uses sftp
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
278 http: not supported!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
279
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
280 SOURCING *netrw-source* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
281
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
282 One may just use the URL notation with the normal file sourcing
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
283 command, such as >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
284
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
285 :so ftp://[user@]machine/path
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
286 <
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
287 Netrw also provides the Nsource command:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
288
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
289 :Nsource ? give help
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
290 :Nsource "dav://machine[:port]/path" uses cadaver
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
291 :Nsource "fetch://[user@]machine/path" uses fetch
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
292 :Nsource "ftp://[user@]machine[[:#]port]/path" uses ftp w/ <.netrc>
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
293 :Nsource "http://[user@]machine/path" uses http uses wget
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
294 :Nsource "rcp://[user@]machine/path" uses rcp
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
295 :Nsource "rsync://[user@]machine[:port]/path" uses rsync
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
296 :Nsource "scp://[user@]machine[[:#]port]/path" uses scp
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
297 :Nsource "sftp://[user@]machine/path" uses sftp
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
298
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
299 DIRECTORY LISTING *netrw-trailingslash* *netrw-dirlist* {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
300
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
301 One may browse a directory to get a listing by simply attempting to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
302 edit the directory: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
303
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
304 :e scp://[user]@hostname/path/
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
305 :e ftp://[user]@hostname/path/
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
306 <
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
307 For remote directory listings (ie. those using scp or ftp), that
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
308 trailing "/" is necessary (the slash tells netrw to treat the argument
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
309 as a directory to browse instead of as a file to download).
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
310
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
311 The Nread command may also be used to accomplish this (again, that
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
312 trailing slash is necessary): >
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
313
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
314 :Nread [protocol]://[user]@hostname/path/
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
315 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
316 *netrw-login* *netrw-password*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
317 CHANGING USERID AND PASSWORD *netrw-chgup* *netrw-userpass* {{{2
1209
070f2ac50cf8 updated for version 7.1b
vimboss
parents: 1121
diff changeset
318
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
319 Attempts to use ftp will prompt you for a user-id and a password.
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
320 These will be saved in global variables |g:netrw_uid| and
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
321 |s:netrw_passwd|; subsequent use of ftp will re-use those two strings,
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
322 thereby simplifying use of ftp. However, if you need to use a
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
323 different user id and/or password, you'll want to call |NetUserPass()|
1209
070f2ac50cf8 updated for version 7.1b
vimboss
parents: 1121
diff changeset
324 first. To work around the need to enter passwords, check if your ftp
070f2ac50cf8 updated for version 7.1b
vimboss
parents: 1121
diff changeset
325 supports a <.netrc> file in your home directory. Also see
070f2ac50cf8 updated for version 7.1b
vimboss
parents: 1121
diff changeset
326 |netrw-passwd| (and if you're using ssh/scp hoping to figure out how
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
327 to not need to use passwords for scp, look at |netrw-ssh-hack|).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
328
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
329 :NetUserPass [uid [password]] -- prompts as needed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
330 :call NetUserPass() -- prompts for uid and password
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
331 :call NetUserPass("uid") -- prompts for password
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
332 :call NetUserPass("uid","password") -- sets global uid and password
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
333
4502
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
334 (Related topics: |ftp| |netrw-userpass| |netrw-start|)
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
335
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
336 NETRW VARIABLES AND SETTINGS *netrw-variables* {{{2
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
337 (Also see:
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
338 |netrw-browser-var| : netrw browser option variables
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
339 |netrw-protocol| : file transfer protocol option variables
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
340 |netrw-settings| : additional file transfer options
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
341 |netrw-browser-options| : these options affect browsing directories
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
342 )
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
343
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
344 Netrw provides a lot of variables which allow you to customize netrw to your
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
345 preferences. One way to look at them is via the command :NetrwSettings (see
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
346 |netrw-settings|) which will display your current netrw settings. Most such
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
347 settings are described below, in |netrw-browser-options|, and in
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
348 |netrw-externapp|:
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
349
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
350 *b:netrw_lastfile* last file Network-read/written retained on a
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
351 per-buffer basis (supports plain :Nw )
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
352
2420
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
353 *g:netrw_bufsettings* the settings that netrw buffers have
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
354 (default) noma nomod nonu nowrap ro nobl
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
355
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
356 *g:netrw_chgwin* specifies a window number where subsequent file edits
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
357 will take place. (also see |netrw-C|)
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
358 (default) -1
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
359
2420
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
360 *g:Netrw_funcref* specifies a function (or functions) to be called when
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
361 netrw edits a file. The file is first edited, and
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
362 then the function reference (|Funcref|) is called.
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
363 This variable may also hold a |List| of Funcrefs.
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
364 (default) not defined. (the capital in g:Netrw...
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
365 is required by its holding a function reference)
2420
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
366 >
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
367 Example: place in .vimrc; affects all file opening
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
368 fun! MyFuncRef()
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
369 endfun
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
370 let g:Netrw_funcref= function("MyFuncRef")
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
371
2420
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
372 <
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
373 *g:Netrw_UserMaps* specifies a function or |List| of functions which can
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
374 be used to set up user-specified maps and functionality.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
375 See |netrw-usermaps|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
376
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
377 *g:netrw_ftp* if it doesn't exist, use default ftp
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
378 =0 use default ftp (uid password)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
379 =1 use alternate ftp method (user uid password)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
380 If you're having trouble with ftp, try changing the
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
381 value of this variable to see if the alternate ftp
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
382 method works for your setup.
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
383
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
384 *g:netrw_ftp_options* Chosen by default, these options are supposed to
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
385 turn interactive prompting off and to restrain ftp
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
386 from attempting auto-login upon initial connection.
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
387 However, it appears that not all ftp implementations
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
388 support this (ex. ncftp).
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
389 ="-i -n"
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
390
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
391 *g:netrw_ftpextracmd* default: doesn't exist
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
392 If this variable exists, then any string it contains
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
393 will be placed into the commands set to your ftp
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
394 client. As an example:
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
395 ="passive"
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
396
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
397 *g:netrw_ftpmode* ="binary" (default)
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
398 ="ascii"
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
399
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
400 *g:netrw_ignorenetrc* =0 (default for linux, cygwin)
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
401 =1 If you have a <.netrc> file but it doesn't work and
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
402 you want it ignored, then set this variable as
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
403 shown. (default for Windows + cmd.exe)
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
404
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
405 *g:netrw_menu* =0 disable netrw's menu
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
406 =1 (default) netrw's menu enabled
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
407
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
408 *g:netrw_nogx* if this variable exists, then the "gx" map will not
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
409 be available (see |netrw-gx|)
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
410
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
411 *g:netrw_uid* (ftp) user-id, retained on a per-vim-session basis
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
412 *s:netrw_passwd* (ftp) password, retained on a per-vim-session basis
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
413
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
414 *g:netrw_preview* =0 (default) preview window shown in a horizontally
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
415 split window
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
416 =1 preview window shown in a vertically split window.
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
417 Also affects the "previous window" (see |netrw-P|)
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
418 in the same way.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
419 The |g:netrw_alto| variable may be used to provide
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
420 additional splitting control:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
421 g:netrw_preview g:netrw_alto result
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
422 0 0 |:aboveleft|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
423 0 1 |:belowright|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
424 1 0 |:topleft|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
425 1 1 |:botright|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
426 To control sizing, see |g:netrw_winsize|
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
427
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
428 *g:netrw_scpport* = "-P" : option to use to set port for scp
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
429 *g:netrw_sshport* = "-p" : option to use to set port for ssh
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
430
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
431 *g:netrw_sepchr* =\0xff
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
432 =\0x01 for enc == euc-jp (and perhaps it should be for
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
433 others, too, please let me know)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
434 Separates priority codes from filenames internally.
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
435 See |netrw-p12|.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
436
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
437 *g:netrw_silent* =0 : transfers done normally
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
438 =1 : transfers done silently
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
439
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
440 *g:netrw_use_errorwindow* =2: messages from netrw will use a popup window
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
441 Move the mouse and pause to remove the popup window.
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
442 (default value if popup windows are availble)
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
443 =1 : messages from netrw will use a separate one
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
444 line window. This window provides reliable
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
445 delivery of messages.
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
446 (default value if popup windows are not availble)
2432
80229a724a11 Updated runtime files. :TOhtml improvements by Benjamin Fritz.
Bram Moolenaar <bram@vim.org>
parents: 2426
diff changeset
447 =0 : messages from netrw will use echoerr ;
80229a724a11 Updated runtime files. :TOhtml improvements by Benjamin Fritz.
Bram Moolenaar <bram@vim.org>
parents: 2426
diff changeset
448 messages don't always seem to show up this
80229a724a11 Updated runtime files. :TOhtml improvements by Benjamin Fritz.
Bram Moolenaar <bram@vim.org>
parents: 2426
diff changeset
449 way, but one doesn't have to quit the window.
1209
070f2ac50cf8 updated for version 7.1b
vimboss
parents: 1121
diff changeset
450
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
451 *g:netrw_win95ftp* =1 if using Win95, will remove four trailing blank
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
452 lines that o/s's ftp "provides" on transfers
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
453 =0 force normal ftp behavior (no trailing line removal)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
454
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
455 *g:netrw_cygwin* =1 assume scp under windows is from cygwin. Also
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
456 permits network browsing to use ls with time and
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
457 size sorting (default if windows)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
458 =0 assume Windows' scp accepts windows-style paths
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
459 Network browsing uses dir instead of ls
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
460 This option is ignored if you're using unix
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
461
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
462 *g:netrw_use_nt_rcp* =0 don't use the rcp of WinNT, Win2000 and WinXP
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
463 =1 use WinNT's rcp in binary mode (default)
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
464
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
465 PATHS *netrw-path* {{{2
466
7a01bd1ac566 updated for version 7.0125
vimboss
parents: 464
diff changeset
466
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
467 Paths to files are generally user-directory relative for most protocols.
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
468 It is possible that some protocol will make paths relative to some
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
469 associated directory, however.
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
470 >
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
471 example: vim scp://user@host/somefile
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
472 example: vim scp://user@host/subdir1/subdir2/somefile
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
473 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
474 where "somefile" is in the "user"'s home directory. If you wish to get a
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
475 file using root-relative paths, use the full path:
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
476 >
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
477 example: vim scp://user@host//somefile
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
478 example: vim scp://user@host//subdir1/subdir2/somefile
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
479 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
480
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
481 ==============================================================================
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
482 4. Network-Oriented File Transfer *netrw-xfer* {{{1
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
483
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
484 Network-oriented file transfer under Vim is implemented by a vim script
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
485 (<netrw.vim>) using plugin techniques. It currently supports both reading and
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
486 writing across networks using rcp, scp, ftp or ftp+<.netrc>, scp, fetch,
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
487 dav/cadaver, rsync, or sftp.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
488
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
489 http is currently supported read-only via use of wget or fetch.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
490
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
491 <netrw.vim> is a standard plugin which acts as glue between Vim and the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
492 various file transfer programs. It uses autocommand events (BufReadCmd,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
493 FileReadCmd, BufWriteCmd) to intercept reads/writes with url-like filenames. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
494
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
495 ex. vim ftp://hostname/path/to/file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
496 <
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
497 The characters preceding the colon specify the protocol to use; in the
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
498 example, it's ftp. The <netrw.vim> script then formulates a command or a
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
499 series of commands (typically ftp) which it issues to an external program
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
500 (ftp, scp, etc) which does the actual file transfer/protocol. Files are read
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
501 from/written to a temporary file (under Unix/Linux, /tmp/...) which the
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
502 <netrw.vim> script will clean up.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
503
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
504 Now, a word about Jan Minář's "FTP User Name and Password Disclosure"; first,
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
505 ftp is not a secure protocol. User names and passwords are transmitted "in
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
506 the clear" over the internet; any snooper tool can pick these up; this is not
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
507 a netrw thing, this is a ftp thing. If you're concerned about this, please
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
508 try to use scp or sftp instead.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
509
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
510 Netrw re-uses the user id and password during the same vim session and so long
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
511 as the remote hostname remains the same.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
512
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
513 Jan seems to be a bit confused about how netrw handles ftp; normally multiple
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
514 commands are performed in a "ftp session", and he seems to feel that the
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
515 uid/password should only be retained over one ftp session. However, netrw
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
516 does every ftp operation in a separate "ftp session"; so remembering the
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
517 uid/password for just one "ftp session" would be the same as not remembering
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
518 the uid/password at all. IMHO this would rapidly grow tiresome as one
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
519 browsed remote directories, for example.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
520
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
521 On the other hand, thanks go to Jan M. for pointing out the many
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
522 vulnerabilities that netrw (and vim itself) had had in handling "crafted"
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
523 filenames. The |shellescape()| and |fnameescape()| functions were written in
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
524 response by Bram Moolenaar to handle these sort of problems, and netrw has
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
525 been modified to use them. Still, my advice is, if the "filename" looks like
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
526 a vim command that you aren't comfortable with having executed, don't open it.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
527
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
528 *netrw-putty* *netrw-pscp* *netrw-psftp*
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
529 One may modify any protocol's implementing external application by setting a
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
530 variable (ex. scp uses the variable g:netrw_scp_cmd, which is defaulted to
794
f19994020dad updated for version 7.0231
vimboss
parents: 766
diff changeset
531 "scp -q"). As an example, consider using PuTTY: >
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
532
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
533 let g:netrw_scp_cmd = '"c:\Program Files\PuTTY\pscp.exe" -q -batch'
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
534 let g:netrw_sftp_cmd= '"c:\Program Files\PuTTY\psftp.exe"'
794
f19994020dad updated for version 7.0231
vimboss
parents: 766
diff changeset
535 <
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
536 (note: it has been reported that windows 7 with putty v0.6's "-batch" option
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
537 doesn't work, so its best to leave it off for that system)
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
538
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
539 See |netrw-p8| for more about putty, pscp, psftp, etc.
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
540
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
541 Ftp, an old protocol, seems to be blessed by numerous implementations.
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
542 Unfortunately, some implementations are noisy (ie., add junk to the end of the
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
543 file). Thus, concerned users may decide to write a NetReadFixup() function
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
544 that will clean up after reading with their ftp. Some Unix systems (ie.,
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
545 FreeBSD) provide a utility called "fetch" which uses the ftp protocol but is
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
546 not noisy and more convenient, actually, for <netrw.vim> to use.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
547 Consequently, if "fetch" is available (ie. executable), it may be preferable
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
548 to use it for ftp://... based transfers.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
549
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
550 For rcp, scp, sftp, and http, one may use network-oriented file transfers
459
d9d38102399f updated for version 7.0122
vimboss
parents: 236
diff changeset
551 transparently; ie.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
552 >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
553 vim rcp://[user@]machine/path
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
554 vim scp://[user@]machine/path
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
555 <
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
556 If your ftp supports <.netrc>, then it too can be transparently used
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
557 if the needed triad of machine name, user id, and password are present in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
558 that file. Your ftp must be able to use the <.netrc> file on its own, however.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
559 >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
560 vim ftp://[user@]machine[[:#]portnumber]/path
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
561 <
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
562 Windows provides an ftp (typically c:\Windows\System32\ftp.exe) which uses
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
563 an option, -s:filename (filename can and probably should be a full path)
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
564 which contains ftp commands which will be automatically run whenever ftp
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
565 starts. You may use this feature to enter a user and password for one site: >
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
566 userid
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
567 password
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
568 < *netrw-windows-netrc* *netrw-windows-s*
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
569 If |g:netrw_ftp_cmd| contains -s:[path/]MACHINE, then (on Windows machines
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
570 only) netrw will substitute the current machine name requested for ftp
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
571 connections for MACHINE. Hence one can have multiple machine.ftp files
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
572 containing login and password for ftp. Example: >
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
573
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
574 let g:netrw_ftp_cmd= 'c:\Windows\System32\ftp -s:C:\Users\Myself\MACHINE'
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
575 vim ftp://myhost.somewhere.net/
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
576
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
577 will use a file >
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
578
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
579 C:\Users\Myself\myhost.ftp
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
580 <
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
581 Often, ftp will need to query the user for the userid and password.
459
d9d38102399f updated for version 7.0122
vimboss
parents: 236
diff changeset
582 The latter will be done "silently"; ie. asterisks will show up instead of
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
583 the actually-typed-in password. Netrw will retain the userid and password
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
584 for subsequent read/writes from the most recent transfer so subsequent
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
585 transfers (read/write) to or from that machine will take place without
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
586 additional prompting.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
587
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
588 *netrw-urls*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
589 +=================================+============================+============+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
590 | Reading | Writing | Uses |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
591 +=================================+============================+============+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
592 | DAV: | | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
593 | dav://host/path | | cadaver |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
594 | :Nread dav://host/path | :Nwrite dav://host/path | cadaver |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
595 +---------------------------------+----------------------------+------------+
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
596 | DAV + SSL: | | |
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
597 | davs://host/path | | cadaver |
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
598 | :Nread davs://host/path | :Nwrite davs://host/path | cadaver |
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
599 +---------------------------------+----------------------------+------------+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
600 | FETCH: | | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
601 | fetch://[user@]host/path | | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
602 | fetch://[user@]host:http/path | Not Available | fetch |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
603 | :Nread fetch://[user@]host/path| | |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
604 +---------------------------------+----------------------------+------------+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
605 | FILE: | | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
606 | file:///* | file:///* | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
607 | file://localhost/* | file://localhost/* | |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
608 +---------------------------------+----------------------------+------------+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
609 | FTP: (*3) | (*3) | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
610 | ftp://[user@]host/path | ftp://[user@]host/path | ftp (*2) |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
611 | :Nread ftp://host/path | :Nwrite ftp://host/path | ftp+.netrc |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
612 | :Nread host path | :Nwrite host path | ftp+.netrc |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
613 | :Nread host uid pass path | :Nwrite host uid pass path | ftp |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
614 +---------------------------------+----------------------------+------------+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
615 | HTTP: wget is executable: (*4) | | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
616 | http://[user@]host/path | Not Available | wget |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
617 +---------------------------------+----------------------------+------------+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
618 | HTTP: fetch is executable (*4) | | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
619 | http://[user@]host/path | Not Available | fetch |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
620 +---------------------------------+----------------------------+------------+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
621 | RCP: | | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
622 | rcp://[user@]host/path | rcp://[user@]host/path | rcp |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
623 +---------------------------------+----------------------------+------------+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
624 | RSYNC: | | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
625 | rsync://[user@]host/path | rsync://[user@]host/path | rsync |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
626 | :Nread rsync://host/path | :Nwrite rsync://host/path | rsync |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
627 | :Nread rcp://host/path | :Nwrite rcp://host/path | rcp |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
628 +---------------------------------+----------------------------+------------+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
629 | SCP: | | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
630 | scp://[user@]host/path | scp://[user@]host/path | scp |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
631 | :Nread scp://host/path | :Nwrite scp://host/path | scp (*1) |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
632 +---------------------------------+----------------------------+------------+
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
633 | SFTP: | | |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
634 | sftp://[user@]host/path | sftp://[user@]host/path | sftp |
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
635 | :Nread sftp://host/path | :Nwrite sftp://host/path | sftp (*1) |
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
636 +=================================+============================+============+
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
637
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
638 (*1) For an absolute path use scp://machine//path.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
639
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
640 (*2) if <.netrc> is present, it is assumed that it will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
641 work with your ftp client. Otherwise the script will
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
642 prompt for user-id and password.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
643
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
644 (*3) for ftp, "machine" may be machine#port or machine:port
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
645 if a different port is needed than the standard ftp port
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
646
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
647 (*4) for http:..., if wget is available it will be used. Otherwise,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
648 if fetch is available it will be used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
649
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
650 Both the :Nread and the :Nwrite ex-commands can accept multiple filenames.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
651
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
652
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
653 NETRC *netrw-netrc*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
654
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
655 The <.netrc> file, typically located in your home directory, contains lines
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
656 therein which map a hostname (machine name) to the user id and password you
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
657 prefer to use with it.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
658
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
659 The typical syntax for lines in a <.netrc> file is given as shown below.
799
6beb2c667935 updated for version 7.0b
vimboss
parents: 794
diff changeset
660 Ftp under Unix usually supports <.netrc>; ftp under Windows usually doesn't.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
661 >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
662 machine {full machine name} login {user-id} password "{password}"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
663 default login {user-id} password "{password}"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
664
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
665 Your ftp client must handle the use of <.netrc> on its own, but if the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
666 <.netrc> file exists, an ftp transfer will not ask for the user-id or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
667 password.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
668
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
669 Note:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
670 Since this file contains passwords, make very sure nobody else can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
671 read this file! Most programs will refuse to use a .netrc that is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
672 readable for others. Don't forget that the system administrator can
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
673 still read the file! Ie. for Linux/Unix: chmod 600 .netrc
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
674
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
675 Even though Windows' ftp clients typically do not support .netrc, netrw has
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
676 a work-around: see |netrw-windows-s|.
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
677
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
678
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
679 PASSWORD *netrw-passwd*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
680
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
681 The script attempts to get passwords for ftp invisibly using |inputsecret()|,
2432
80229a724a11 Updated runtime files. :TOhtml improvements by Benjamin Fritz.
Bram Moolenaar <bram@vim.org>
parents: 2426
diff changeset
682 a built-in Vim function. See |netrw-userpass| for how to change the password
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
683 after one has set it.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
684
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
685 Unfortunately there doesn't appear to be a way for netrw to feed a password to
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
686 scp. Thus every transfer via scp will require re-entry of the password.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
687 However, |netrw-ssh-hack| can help with this problem.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
688
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
689
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
690 ==============================================================================
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
691 5. Activation *netrw-activate* {{{1
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
692
799
6beb2c667935 updated for version 7.0b
vimboss
parents: 794
diff changeset
693 Network-oriented file transfers are available by default whenever Vim's
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
694 |'nocompatible'| mode is enabled. Netrw's script files reside in your
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
695 system's plugin, autoload, and syntax directories; just the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
696 plugin/netrwPlugin.vim script is sourced automatically whenever you bring up
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
697 vim. The main script in autoload/netrw.vim is only loaded when you actually
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
698 use netrw. I suggest that, at a minimum, you have at least the following in
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
699 your <.vimrc> customization file: >
799
6beb2c667935 updated for version 7.0b
vimboss
parents: 794
diff changeset
700
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
701 set nocp
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
702 if version >= 600
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
703 filetype plugin indent on
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
704 endif
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
705 <
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
706 By also including the following lines in your .vimrc, one may have netrw
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
707 immediately activate when using [g]vim without any filenames, showing the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
708 current directory: >
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
709
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
710 " Augroup VimStartup:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
711 augroup VimStartup
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
712 au!
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
713 au VimEnter * if expand("%") == "" | e . | endif
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
714 augroup END
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
715 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
716
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
717 ==============================================================================
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
718 6. Transparent Remote File Editing *netrw-transparent* {{{1
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
719
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
720 Transparent file transfers occur whenever a regular file read or write
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
721 (invoked via an |:autocmd| for |BufReadCmd|, |BufWriteCmd|, or |SourceCmd|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
722 events) is made. Thus one may read, write, or source files across networks
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
723 just as easily as if they were local files! >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
724
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
725 vim ftp://[user@]machine/path
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
726 ...
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
727 :wq
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
728
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
729 See |netrw-activate| for more on how to encourage your vim to use plugins
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
730 such as netrw.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
731
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
732 For password-free use of scp:, see |netrw-ssh-hack|.
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
733
799
6beb2c667935 updated for version 7.0b
vimboss
parents: 794
diff changeset
734
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
735 ==============================================================================
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
736 7. Ex Commands *netrw-ex* {{{1
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
737
799
6beb2c667935 updated for version 7.0b
vimboss
parents: 794
diff changeset
738 The usual read/write commands are supported. There are also a few
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
739 additional commands available. Often you won't need to use Nwrite or
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
740 Nread as shown in |netrw-transparent| (ie. simply use >
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
741 :e URL
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
742 :r URL
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
743 :w URL
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
744 instead, as appropriate) -- see |netrw-urls|. In the explanations
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
745 below, a {netfile} is a URL to a remote file.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
746
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
747 *:Nwrite* *:Nw*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
748 :[range]Nw[rite] Write the specified lines to the current
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
749 file as specified in b:netrw_lastfile.
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
750 (related: |netrw-nwrite|)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
751
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
752 :[range]Nw[rite] {netfile} [{netfile}]...
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
753 Write the specified lines to the {netfile}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
754
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
755 *:Nread* *:Nr*
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
756 :Nr[ead] Read the lines from the file specified in b:netrw_lastfile
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
757 into the current buffer. (related: |netrw-nread|)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
758
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
759 :Nr[ead] {netfile} {netfile}...
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
760 Read the {netfile} after the current line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
761
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
762 *:Nsource* *:Ns*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
763 :Ns[ource] {netfile}
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
764 Source the {netfile}.
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
765 To start up vim using a remote .vimrc, one may use
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
766 the following (all on one line) (tnx to Antoine Mechelynck) >
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
767 vim -u NORC -N
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
768 --cmd "runtime plugin/netrwPlugin.vim"
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
769 --cmd "source scp://HOSTNAME/.vimrc"
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
770 < (related: |netrw-source|)
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
771
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
772 :call NetUserPass() *NetUserPass()*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
773 If g:netrw_uid and s:netrw_passwd don't exist,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
774 this function will query the user for them.
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
775 (related: |netrw-userpass|)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
776
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
777 :call NetUserPass("userid")
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
778 This call will set the g:netrw_uid and, if
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
779 the password doesn't exist, will query the user for it.
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
780 (related: |netrw-userpass|)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
781
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
782 :call NetUserPass("userid","passwd")
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
783 This call will set both the g:netrw_uid and s:netrw_passwd.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
784 The user-id and password are used by ftp transfers. One may
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
785 effectively remove the user-id and password by using empty
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
786 strings (ie. "").
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
787 (related: |netrw-userpass|)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
788
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
789 :NetrwSettings This command is described in |netrw-settings| -- used to
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
790 display netrw settings and change netrw behavior.
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
791
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
792
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
793 ==============================================================================
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
794 8. Variables and Options *netrw-var* *netrw-settings* {{{1
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
795
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
796 (also see: |netrw-options| |netrw-variables| |netrw-protocol|
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
797 |netrw-browser-settings| |netrw-browser-options| )
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
798
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
799 The <netrw.vim> script provides several variables which act as options to
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
800 affect <netrw.vim>'s file transfer behavior. These variables typically may be
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
801 set in the user's <.vimrc> file: (see also |netrw-settings| |netrw-protocol|)
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
802 *netrw-options*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
803 >
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
804 -------------
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
805 Netrw Options
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
806 -------------
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
807 Option Meaning
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
808 -------------- -----------------------------------------------
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
809 <
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
810 b:netrw_col Holds current cursor position (during NetWrite)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
811 g:netrw_cygwin =1 assume scp under windows is from cygwin
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
812 (default/windows)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
813 =0 assume scp under windows accepts windows
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
814 style paths (default/else)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
815 g:netrw_ftp =0 use default ftp (uid password)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
816 g:netrw_ftpmode ="binary" (default)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
817 ="ascii" (your choice)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
818 g:netrw_ignorenetrc =1 (default)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
819 if you have a <.netrc> file but you don't
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
820 want it used, then set this variable. Its
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
821 mere existence is enough to cause <.netrc>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
822 to be ignored.
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
823 b:netrw_lastfile Holds latest method/machine/path.
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
824 b:netrw_line Holds current line number (during NetWrite)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
825 g:netrw_silent =0 transfers done normally
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
826 =1 transfers done silently
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
827 g:netrw_uid Holds current user-id for ftp.
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
828 g:netrw_use_nt_rcp =0 don't use WinNT/2K/XP's rcp (default)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
829 =1 use WinNT/2K/XP's rcp, binary mode
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
830 g:netrw_win95ftp =0 use unix-style ftp even if win95/98/ME/etc
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
831 =1 use default method to do ftp >
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
832 -----------------------------------------------------------------------
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
833 <
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
834 *netrw-internal-variables*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
835 The script will also make use of the following variables internally, albeit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
836 temporarily.
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
837 >
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
838 -------------------
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
839 Temporary Variables
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
840 -------------------
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
841 Variable Meaning
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
842 -------- ------------------------------------
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
843 <
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
844 b:netrw_method Index indicating rcp/ftp+.netrc/ftp
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
845 w:netrw_method (same as b:netrw_method)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
846 g:netrw_machine Holds machine name parsed from input
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
847 b:netrw_fname Holds filename being accessed >
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
848 ------------------------------------------------------------
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
849 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
850 *netrw-protocol*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
851
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
852 Netrw supports a number of protocols. These protocols are invoked using the
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
853 variables listed below, and may be modified by the user.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
854 >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
855 ------------------------
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
856 Protocol Control Options
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
857 ------------------------
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
858 Option Type Setting Meaning
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
859 --------- -------- -------------- ---------------------------
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
860 < netrw_ftp variable =doesn't exist userid set by "user userid"
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
861 =0 userid set by "user userid"
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
862 =1 userid set by "userid"
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
863 NetReadFixup function =doesn't exist no change
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
864 =exists Allows user to have files
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
865 read via ftp automatically
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
866 transformed however they wish
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
867 by NetReadFixup()
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
868 g:netrw_dav_cmd var ="cadaver" if cadaver is executable
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
869 g:netrw_dav_cmd var ="curl -o" elseif curl is executable
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
870 g:netrw_fetch_cmd var ="fetch -o" if fetch is available
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
871 g:netrw_ftp_cmd var ="ftp"
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
872 g:netrw_http_cmd var ="fetch -o" if fetch is available
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
873 g:netrw_http_cmd var ="wget -O" else if wget is available
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
874 g:netrw_http_put_cmd var ="curl -T"
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
875 |g:netrw_list_cmd| var ="ssh USEPORT HOSTNAME ls -Fa"
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
876 g:netrw_rcp_cmd var ="rcp"
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
877 g:netrw_rsync_cmd var ="rsync"
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
878 *g:netrw_rsync_sep* var ="/" used to separate the hostname
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
879 from the file spec
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
880 g:netrw_scp_cmd var ="scp -q"
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
881 g:netrw_sftp_cmd var ="sftp" >
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
882 -------------------------------------------------------------------------
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
883 <
12
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
884 *netrw-ftp*
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
885
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
886 The g:netrw_..._cmd options (|g:netrw_ftp_cmd| and |g:netrw_sftp_cmd|)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
887 specify the external program to use handle the ftp protocol. They may
2420
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
888 include command line options (such as -p for passive mode). Example: >
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
889
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
890 let g:netrw_ftp_cmd= "ftp -p"
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
891 <
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
892 Browsing is supported by using the |g:netrw_list_cmd|; the substring
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
893 "HOSTNAME" will be changed via substitution with whatever the current request
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
894 is for a hostname.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
895
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
896 Two options (|g:netrw_ftp| and |netrw-fixup|) both help with certain ftp's
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
897 that give trouble . In order to best understand how to use these options if
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
898 ftp is giving you troubles, a bit of discussion is provided on how netrw does
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
899 ftp reads.
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
900
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
901 For ftp, netrw typically builds up lines of one of the following formats in a
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
902 temporary file:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
903 >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
904 IF g:netrw_ftp !exists or is not 1 IF g:netrw_ftp exists and is 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
905 ---------------------------------- ------------------------------
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
906 <
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
907 open machine [port] open machine [port]
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
908 user userid password userid password
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
909 [g:netrw_ftpmode] password
2432
80229a724a11 Updated runtime files. :TOhtml improvements by Benjamin Fritz.
Bram Moolenaar <bram@vim.org>
parents: 2426
diff changeset
910 [g:netrw_ftpextracmd] [g:netrw_ftpmode]
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
911 get filename tempfile [g:netrw_extracmd]
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
912 get filename tempfile >
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
913 ---------------------------------------------------------------------
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
914 <
2432
80229a724a11 Updated runtime files. :TOhtml improvements by Benjamin Fritz.
Bram Moolenaar <bram@vim.org>
parents: 2426
diff changeset
915 The |g:netrw_ftpmode| and |g:netrw_ftpextracmd| are optional.
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
916
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
917 Netrw then executes the lines above by use of a filter:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
918 >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
919 :%! {g:netrw_ftp_cmd} -i [-n]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
920 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
921 where
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
922 g:netrw_ftp_cmd is usually "ftp",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
923 -i tells ftp not to be interactive
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
924 -n means don't use netrc and is used for Method #3 (ftp w/o <.netrc>)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
925
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
926 If <.netrc> exists it will be used to avoid having to query the user for
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
927 userid and password. The transferred file is put into a temporary file.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
928 The temporary file is then read into the main editing session window that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
929 requested it and the temporary file deleted.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
930
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
931 If your ftp doesn't accept the "user" command and immediately just demands a
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
932 userid, then try putting "let netrw_ftp=1" in your <.vimrc>.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
933
12
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
934 *netrw-cadaver*
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
935 To handle the SSL certificate dialog for untrusted servers, one may pull
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
936 down the certificate and place it into /usr/ssl/cert.pem. This operation
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
937 renders the server treatment as "trusted".
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
938
794
f19994020dad updated for version 7.0231
vimboss
parents: 766
diff changeset
939 *netrw-fixup* *netreadfixup*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
940 If your ftp for whatever reason generates unwanted lines (such as AUTH
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
941 messages) you may write a NetReadFixup() function:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
942 >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
943 function! NetReadFixup(method,line1,line2)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
944 " a:line1: first new line in current file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
945 " a:line2: last new line in current file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
946 if a:method == 1 "rcp
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
947 elseif a:method == 2 "ftp + <.netrc>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
948 elseif a:method == 3 "ftp + machine,uid,password,filename
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
949 elseif a:method == 4 "scp
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
950 elseif a:method == 5 "http/wget
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
951 elseif a:method == 6 "dav/cadaver
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
952 elseif a:method == 7 "rsync
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
953 elseif a:method == 8 "fetch
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
954 elseif a:method == 9 "sftp
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
955 else " complain
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
956 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
957 endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
958 >
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
959 The NetReadFixup() function will be called if it exists and thus allows you to
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
960 customize your reading process. As a further example, <netrw.vim> contains
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
961 just such a function to handle Windows 95 ftp. For whatever reason, Windows
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
962 95's ftp dumps four blank lines at the end of a transfer, and so it is
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
963 desirable to automate their removal. Here's some code taken from <netrw.vim>
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
964 itself:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
965 >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
966 if has("win95") && g:netrw_win95ftp
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
967 fun! NetReadFixup(method, line1, line2)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
968 if method == 3 " ftp (no <.netrc>)
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
969 let fourblanklines= line2 - 3
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
970 silent fourblanklines.",".line2."g/^\s*/d"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
971 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
972 endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
973 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
974 >
4502
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
975 (Related topics: |ftp| |netrw-userpass| |netrw-start|)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
976
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
977 ==============================================================================
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
978 9. Browsing *netrw-browsing* *netrw-browse* *netrw-help* {{{1
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
979 *netrw-browser* *netrw-dir* *netrw-list*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
980
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
981 INTRODUCTION TO BROWSING *netrw-intro-browse* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
982 (Quick References: |netrw-quickmaps| |netrw-quickcoms|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
983
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
984 Netrw supports the browsing of directories on your local system and on remote
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
985 hosts; browsing includes listing files and directories, entering directories,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
986 editing files therein, deleting files/directories, making new directories,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
987 moving (renaming) files and directories, copying files and directories, etc.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
988 One may mark files and execute any system command on them! The Netrw browser
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
989 generally implements the previous explorer's maps and commands for remote
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
990 directories, although details (such as pertinent global variable names)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
991 necessarily differ. To browse a directory, simply "edit" it! >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
992
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
993 vim /your/directory/
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
994 vim .
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
995 vim c:\your\directory\
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
996 <
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
997 (Related topics: |netrw-cr| |netrw-o| |netrw-p| |netrw-P| |netrw-t|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
998 |netrw-mf| |netrw-mx| |netrw-D| |netrw-R| |netrw-v| )
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
999
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
1000 The Netrw remote file and directory browser handles two protocols: ssh and
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1001 ftp. The protocol in the url, if it is ftp, will cause netrw also to use ftp
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1002 in its remote browsing. Specifying any other protocol will cause it to be
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1003 used for file transfers; but the ssh protocol will be used to do remote
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1004 browsing.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1005
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1006 To use Netrw's remote directory browser, simply attempt to read a "file" with
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1007 a trailing slash and it will be interpreted as a request to list a directory:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1008 >
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
1009 vim [protocol]://[user@]hostname/path/
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1010 <
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1011 where [protocol] is typically scp or ftp. As an example, try: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1012
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1013 vim ftp://ftp.home.vim.org/pub/vim/
719
82ef0c58b012 updated for version 7.0219
vimboss
parents: 650
diff changeset
1014 <
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1015 For local directories, the trailing slash is not required. Again, because it's
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1016 easy to miss: to browse remote directories, the URL must terminate with a
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1017 slash!
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1018
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1019 If you'd like to avoid entering the password repeatedly for remote directory
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1020 listings with ssh or scp, see |netrw-ssh-hack|. To avoid password entry with
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1021 ftp, see |netrw-netrc| (if your ftp supports it).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1022
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1023 There are several things you can do to affect the browser's display of files:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1024
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1025 * To change the listing style, press the "i" key (|netrw-i|).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1026 Currently there are four styles: thin, long, wide, and tree.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1027 To make that change "permanent", see |g:netrw_liststyle|.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1028
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1029 * To hide files (don't want to see those xyz~ files anymore?) see
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1030 |netrw-ctrl-h|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1031
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1032 * Press s to sort files by name, time, or size.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1033
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1034 See |netrw-browse-cmds| for all the things you can do with netrw!
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1035
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1036 *netrw-getftype* *netrw-filigree* *netrw-ftype*
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1037 The |getftype()| function is used to append a bit of filigree to indicate
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1038 filetype to locally listed files:
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1039
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1040 directory : /
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1041 executable : *
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1042 fifo : |
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1043 links : @
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1044 sockets : =
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1045
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1046 The filigree also affects the |g:netrw_sort_sequence|.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1047
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1048
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1049 QUICK HELP *netrw-quickhelp* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1050 (Use ctrl-] to select a topic)~
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1051 Intro to Browsing...............................|netrw-intro-browse|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1052 Quick Reference: Maps.........................|netrw-quickmap|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1053 Quick Reference: Commands.....................|netrw-browse-cmds|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1054 Hiding
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1055 Edit hiding list..............................|netrw-ctrl-h|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1056 Hiding Files or Directories...................|netrw-a|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1057 Hiding/Unhiding by suffix.....................|netrw-mh|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1058 Hiding dot-files.............................|netrw-gh|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1059 Listing Style
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1060 Select listing style (thin/long/wide/tree)....|netrw-i|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1061 Associated setting variable...................|g:netrw_liststyle|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1062 Shell command used to perform listing.........|g:netrw_list_cmd|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1063 Quick file info...............................|netrw-qf|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1064 Sorted by
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1065 Select sorting style (name/time/size).........|netrw-s|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1066 Editing the sorting sequence..................|netrw-S|
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
1067 Sorting options...............................|g:netrw_sort_options|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1068 Associated setting variable...................|g:netrw_sort_sequence|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1069 Reverse sorting order.........................|netrw-r|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1070
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1071
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
1072 *netrw-quickmap* *netrw-quickmaps*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1073 QUICK REFERENCE: MAPS *netrw-browse-maps* {{{2
466
7a01bd1ac566 updated for version 7.0125
vimboss
parents: 464
diff changeset
1074 >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1075 --- ----------------- ----
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1076 Map Quick Explanation Link
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1077 --- ----------------- ----
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1078 < <F1> Causes Netrw to issue help
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1079 <cr> Netrw will enter the directory or read the file |netrw-cr|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1080 <del> Netrw will attempt to remove the file/directory |netrw-del|
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1081 <c-h> Edit file hiding list |netrw-ctrl-h|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1082 <c-l> Causes Netrw to refresh the directory listing |netrw-ctrl-l|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1083 <c-r> Browse using a gvim server |netrw-ctrl-r|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1084 <c-tab> Shrink/expand a netrw/explore window |netrw-c-tab|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1085 - Makes Netrw go up one directory |netrw--|
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1086 a Cycles between normal display, |netrw-a|
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1087 hiding (suppress display of files matching g:netrw_list_hide)
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1088 and showing (display only files which match g:netrw_list_hide)
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
1089 cd Make browsing directory the current directory |netrw-cd|
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1090 C Setting the editing window |netrw-C|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1091 d Make a directory |netrw-d|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1092 D Attempt to remove the file(s)/directory(ies) |netrw-D|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1093 gb Go to previous bookmarked directory |netrw-gb|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1094 gd Force treatment as directory |netrw-gd|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1095 gf Force treatment as file |netrw-gf|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1096 gh Quick hide/unhide of dot-files |netrw-gh|
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1097 gn Make top of tree the directory below the cursor |netrw-gn|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1098 i Cycle between thin, long, wide, and tree listings |netrw-i|
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1099 I Toggle the displaying of the banner |netrw-I|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1100 mb Bookmark current directory |netrw-mb|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1101 mc Copy marked files to marked-file target directory |netrw-mc|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1102 md Apply diff to marked files (up to 3) |netrw-md|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1103 me Place marked files on arg list and edit them |netrw-me|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1104 mf Mark a file |netrw-mf|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1105 mF Unmark files |netrw-mF|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1106 mg Apply vimgrep to marked files |netrw-mg|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1107 mh Toggle marked file suffices' presence on hiding list |netrw-mh|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1108 mm Move marked files to marked-file target directory |netrw-mm|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1109 mp Print marked files |netrw-mp|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1110 mr Mark files using a shell-style |regexp| |netrw-mr|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1111 mt Current browsing directory becomes markfile target |netrw-mt|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1112 mT Apply ctags to marked files |netrw-mT|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1113 mu Unmark all marked files |netrw-mu|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1114 mv Apply arbitrary vim command to marked files |netrw-mv|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1115 mx Apply arbitrary shell command to marked files |netrw-mx|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1116 mX Apply arbitrary shell command to marked files en bloc|netrw-mX|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1117 mz Compress/decompress marked files |netrw-mz|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1118 o Enter the file/directory under the cursor in a new |netrw-o|
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1119 browser window. A horizontal split is used.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1120 O Obtain a file specified by cursor |netrw-O|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1121 p Preview the file |netrw-p|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1122 P Browse in the previously used window |netrw-P|
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1123 qb List bookmarked directories and history |netrw-qb|
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1124 qf Display information on file |netrw-qf|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1125 qF Mark files using a quickfix list |netrw-qF|
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1126 qL Mark files using a |location-list| |netrw-qL|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1127 r Reverse sorting order |netrw-r|
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1128 R Rename the designated file(s)/directory(ies) |netrw-R|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1129 s Select sorting style: by name, time, or file size |netrw-s|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1130 S Specify suffix priority for name-sorting |netrw-S|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1131 t Enter the file/directory under the cursor in a new tab|netrw-t|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1132 u Change to recently-visited directory |netrw-u|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1133 U Change to subsequently-visited directory |netrw-U|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1134 v Enter the file/directory under the cursor in a new |netrw-v|
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1135 browser window. A vertical split is used.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1136 x View file with an associated program |netrw-x|
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
1137 X Execute filename under cursor via |system()| |netrw-X|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1138
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
1139 % Open a new file in netrw's current directory |netrw-%|
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
1140
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1141 *netrw-mouse* *netrw-leftmouse* *netrw-middlemouse* *netrw-rightmouse*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1142 <leftmouse> (gvim only) selects word under mouse as if a <cr>
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1143 had been pressed (ie. edit file, change directory)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1144 <middlemouse> (gvim only) same as P selecting word under mouse;
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1145 see |netrw-P|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1146 <rightmouse> (gvim only) delete file/directory using word under
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1147 mouse
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1148 <2-leftmouse> (gvim only) when:
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1149 * in a netrw-selected file, AND
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1150 * |g:netrw_retmap| == 1 AND
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1151 * the user doesn't already have a <2-leftmouse>
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1152 mapping defined before netrw is autoloaded,
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1153 then a double clicked leftmouse button will return
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1154 to the netrw browser window. See |g:netrw_retmap|.
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1155 <s-leftmouse> (gvim only) like mf, will mark files. Dragging
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1156 the shifted leftmouse will mark multiple files.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1157 (see |netrw-mf|)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1158
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
1159 (to disable mouse buttons while browsing: |g:netrw_mousemaps|)
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
1160
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1161 *netrw-quickcom* *netrw-quickcoms*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1162 QUICK REFERENCE: COMMANDS *netrw-explore-cmds* *netrw-browse-cmds* {{{2
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1163 :NetrwClean[!]............................................|netrw-clean|
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1164 :NetrwSettings............................................|netrw-settings|
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1165 :Ntree....................................................|netrw-ntree|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1166 :Explore[!] [dir] Explore directory of current file......|netrw-explore|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1167 :Hexplore[!] [dir] Horizontal Split & Explore.............|netrw-explore|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1168 :Lexplore[!] [dir] Left Explorer Toggle...................|netrw-explore|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1169 :Nexplore[!] [dir] Vertical Split & Explore...............|netrw-explore|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1170 :Pexplore[!] [dir] Vertical Split & Explore...............|netrw-explore|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1171 :Rexplore Return to Explorer.....................|netrw-explore|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1172 :Sexplore[!] [dir] Split & Explore directory .............|netrw-explore|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1173 :Texplore[!] [dir] Tab & Explore..........................|netrw-explore|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1174 :Vexplore[!] [dir] Vertical Split & Explore...............|netrw-explore|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1175
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1176
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1177 BANNER DISPLAY *netrw-I*
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1178
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1179 One may toggle the displaying of the banner by pressing "I".
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1180
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1181 Also See: |g:netrw_banner|
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1182
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1183
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1184 BOOKMARKING A DIRECTORY *netrw-mb* *netrw-bookmark* *netrw-bookmarks* {{{2
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1185
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1186 One may easily "bookmark" the currently browsed directory by using >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1187
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1188 mb
839
1f3b1021f002 updated for version 7.0e05
vimboss
parents: 834
diff changeset
1189 <
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1190 *.netrwbook*
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1191 Bookmarks are retained in between sessions of vim in a file called .netrwbook
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1192 as a |List|, which is typically stored in the first directory on the user's
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19099
diff changeset
1193 'runtimepath'; entries are kept in sorted order.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1194
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1195 If there are marked files and/or directories, mb will add them to the bookmark
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1196 list.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1197
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1198 *netrw-:NetrwMB*
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1199 Addtionally, one may use :NetrwMB to bookmark files or directories. >
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1200
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1201 :NetrwMB[!] [files/directories]
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1202
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1203 < No bang: enters files/directories into Netrw's bookmark system
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1204
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1205 No argument and in netrw buffer:
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1206 if there are marked files : bookmark marked files
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1207 otherwise : bookmark file/directory under cursor
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1208 No argument and not in netrw buffer: bookmarks current open file
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1209 Has arguments : |glob()|s each arg and bookmarks them
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1210
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1211 With bang: deletes files/directories from Netrw's bookmark system
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1212
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1213 The :NetrwMB command is available outside of netrw buffers (once netrw has been
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1214 invoked in the session).
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1215
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1216 The file ".netrwbook" holds bookmarks when netrw (and vim) is not active. By
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1217 default, its stored on the first directory on the user's |'runtimepath'|.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1218
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1219 Related Topics:
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1220 |netrw-gb| how to return (go) to a bookmark
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1221 |netrw-mB| how to delete bookmarks
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1222 |netrw-qb| how to list bookmarks
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1223 |g:netrw_home| controls where .netrwbook is kept
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1224
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1225
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1226 BROWSING *netrw-enter* *netrw-cr* {{{2
12
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
1227
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
1228 Browsing is simple: move the cursor onto a file or directory of interest.
11
4424b47a0797 updated for version 7.0003
vimboss
parents: 9
diff changeset
1229 Hitting the <cr> (the return key) will select the file or directory.
4424b47a0797 updated for version 7.0003
vimboss
parents: 9
diff changeset
1230 Directories will themselves be listed, and files will be opened using the
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1231 protocol given in the original read request.
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
1232
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1233 CAVEAT: There are four forms of listing (see |netrw-i|). Netrw assumes that
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1234 two or more spaces delimit filenames and directory names for the long and
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1235 wide listing formats. Thus, if your filename or directory name has two or
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1236 more sequential spaces embedded in it, or any trailing spaces, then you'll
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1237 need to use the "thin" format to select it.
519
d50452846776 updated for version 7.0145
vimboss
parents: 501
diff changeset
1238
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1239 The |g:netrw_browse_split| option, which is zero by default, may be used to
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1240 cause the opening of files to be done in a new window or tab instead of the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1241 default. When the option is one or two, the splitting will be taken
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1242 horizontally or vertically, respectively. When the option is set to three, a
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1243 <cr> will cause the file to appear in a new tab.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1244
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1245
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1246 When using the gui (gvim), one may select a file by pressing the <leftmouse>
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1247 button. In addition, if
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1248
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1249 * |g:netrw_retmap| == 1 AND (its default value is 0)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1250 * in a netrw-selected file, AND
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1251 * the user doesn't already have a <2-leftmouse> mapping defined before
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1252 netrw is loaded
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1253
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1254 then a doubly-clicked leftmouse button will return to the netrw browser
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1255 window.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1256
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1257 Netrw attempts to speed up browsing, especially for remote browsing where one
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1258 may have to enter passwords, by keeping and re-using previously obtained
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1259 directory listing buffers. The |g:netrw_fastbrowse| variable is used to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1260 control this behavior; one may have slow browsing (no buffer re-use), medium
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1261 speed browsing (re-use directory buffer listings only for remote directories),
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1262 and fast browsing (re-use directory buffer listings as often as possible).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1263 The price for such re-use is that when changes are made (such as new files
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1264 are introduced into a directory), the listing may become out-of-date. One may
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1265 always refresh directory listing buffers by pressing ctrl-L (see
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1266 |netrw-ctrl-l|).
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1267
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1268 *netrw-s-cr*
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1269 Squeezing the Current Tree-Listing Directory~
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1270
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1271 When the tree listing style is enabled (see |netrw-i|) and one is using
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1272 gvim, then the <s-cr> mapping may be used to squeeze (close) the
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1273 directory currently containing the cursor.
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1274
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1275 Otherwise, one may remap a key combination of one's own choice to get
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1276 this effect: >
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1277
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1278 nmap <buffer> <silent> <nowait> YOURKEYCOMBO <Plug>NetrwTreeSqueeze
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1279 <
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1280 Put this line in $HOME/ftplugin/netrw/netrw.vim; it needs to be generated
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1281 for netrw buffers only.
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1282
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1283 Related topics:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1284 |netrw-ctrl-r| |netrw-o| |netrw-p|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1285 |netrw-P| |netrw-t| |netrw-v|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1286 Associated setting variables:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1287 |g:netrw_browse_split| |g:netrw_fastbrowse|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1288 |g:netrw_ftp_list_cmd| |g:netrw_ftp_sizelist_cmd|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1289 |g:netrw_ftp_timelist_cmd| |g:netrw_ssh_browse_reject|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1290 |g:netrw_ssh_cmd| |g:netrw_use_noswf|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1291
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1292
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1293 BROWSING WITH A HORIZONTALLY SPLIT WINDOW *netrw-o* *netrw-horiz* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1294
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1295 Normally one enters a file or directory using the <cr>. However, the "o" map
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1296 allows one to open a new window to hold the new directory listing or file. A
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1297 horizontal split is used. (for vertical splitting, see |netrw-v|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1298
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1299 Normally, the o key splits the window horizontally with the new window and
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1300 cursor at the top.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1301
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1302 Associated setting variables: |g:netrw_alto| |g:netrw_winsize|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1303
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1304 Related topics:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1305 |netrw-ctrl-r| |netrw-o| |netrw-p|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1306 |netrw-P| |netrw-t| |netrw-v|
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1307 Associated setting variables:
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1308 |g:netrw_alto| control above/below splitting
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1309 |g:netrw_winsize| control initial sizing
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1310
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1311 BROWSING WITH A NEW TAB *netrw-t* {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1312
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1313 Normally one enters a file or directory using the <cr>. The "t" map
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1314 allows one to open a new window holding the new directory listing or file in
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1315 a new tab.
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1316
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1317 If you'd like to have the new listing in a background tab, use |gT|.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1318
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1319 Related topics:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1320 |netrw-ctrl-r| |netrw-o| |netrw-p|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1321 |netrw-P| |netrw-t| |netrw-v|
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1322 Associated setting variables:
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1323 |g:netrw_winsize| control initial sizing
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1324
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1325 BROWSING WITH A VERTICALLY SPLIT WINDOW *netrw-v* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1326
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1327 Normally one enters a file or directory using the <cr>. However, the "v" map
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1328 allows one to open a new window to hold the new directory listing or file. A
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1329 vertical split is used. (for horizontal splitting, see |netrw-o|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1330
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1331 Normally, the v key splits the window vertically with the new window and
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1332 cursor at the left.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1333
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1334 There is only one tree listing buffer; using "v" on a displayed subdirectory
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1335 will split the screen, but the same buffer will be shown twice.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1336
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1337 Related topics:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1338 |netrw-ctrl-r| |netrw-o| |netrw-p|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1339 |netrw-P| |netrw-t| |netrw-v|
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1340 Associated setting variables:
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1341 |g:netrw_altv| control right/left splitting
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1342 |g:netrw_winsize| control initial sizing
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1343
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1344
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1345 BROWSING USING A GVIM SERVER *netrw-ctrl-r* {{{2
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1346
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1347 One may keep a browsing gvim separate from the gvim being used to edit.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1348 Use the <c-r> map on a file (not a directory) in the netrw browser, and it
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1349 will use a gvim server (see |g:netrw_servername|). Subsequent use of <cr>
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1350 (see |netrw-cr|) will re-use that server for editing files.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1351
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1352 Related topics:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1353 |netrw-ctrl-r| |netrw-o| |netrw-p|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1354 |netrw-P| |netrw-t| |netrw-v|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1355 Associated setting variables:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1356 |g:netrw_servername| : sets name of server
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1357 |g:netrw_browse_split| : controls how <cr> will open files
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1358
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1359
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1360 CHANGE LISTING STYLE (THIN LONG WIDE TREE) *netrw-i* {{{2
519
d50452846776 updated for version 7.0145
vimboss
parents: 501
diff changeset
1361
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1362 The "i" map cycles between the thin, long, wide, and tree listing formats.
12
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
1363
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1364 The thin listing format gives just the files' and directories' names.
519
d50452846776 updated for version 7.0145
vimboss
parents: 501
diff changeset
1365
15
631143ac4a01 updated for version 7.0007
vimboss
parents: 12
diff changeset
1366 The long listing is either based on the "ls" command via ssh for remote
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
1367 directories or displays the filename, file size (in bytes), and the time and
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
1368 date of last modification for local directories. With the long listing
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
1369 format, netrw is not able to recognize filenames which have trailing spaces.
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
1370 Use the thin listing format for such files.
519
d50452846776 updated for version 7.0145
vimboss
parents: 501
diff changeset
1371
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1372 The wide listing format uses two or more contiguous spaces to delineate
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1373 filenames; when using that format, netrw won't be able to recognize or use
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1374 filenames which have two or more contiguous spaces embedded in the name or any
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1375 trailing spaces. The thin listing format will, however, work with such files.
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1376 The wide listing format is the most compact.
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1377
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1378 The tree listing format has a top directory followed by files and directories
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1379 preceded by one or more "|"s, which indicate the directory depth. One may
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1380 open and close directories by pressing the <cr> key while atop the directory
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1381 name.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1382
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1383 One may make a preferred listing style your default; see |g:netrw_liststyle|.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1384 As an example, by putting the following line in your .vimrc, >
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1385 let g:netrw_liststyle= 3
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1386 the tree style will become your default listing style.
15
631143ac4a01 updated for version 7.0007
vimboss
parents: 12
diff changeset
1387
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1388 One typical way to use the netrw tree display is to: >
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1389
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1390 vim .
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1391 (use i until a tree display shows)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1392 navigate to a file
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1393 v (edit as desired in vertically split window)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1394 ctrl-w h (to return to the netrw listing)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1395 P (edit newly selected file in the previous window)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1396 ctrl-w h (to return to the netrw listing)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1397 P (edit newly selected file in the previous window)
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1398 ...etc...
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1399 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1400 Associated setting variables: |g:netrw_liststyle| |g:netrw_maxfilenamelen|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1401 |g:netrw_timefmt| |g:netrw_list_cmd|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1402
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1403 CHANGE FILE PERMISSION *netrw-gp* {{{2
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1404
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1405 "gp" will ask you for a new permission for the file named under the cursor.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1406 Currently, this only works for local files.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1407
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1408 Associated setting variables: |g:netrw_chgperm|
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1409
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1410
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1411 CHANGING TO A BOOKMARKED DIRECTORY *netrw-gb* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1412
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1413 To change directory back to a bookmarked directory, use
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1414
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1415 {cnt}gb
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1416
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1417 Any count may be used to reference any of the bookmarks.
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1418 Note that |netrw-qb| shows both bookmarks and history; to go
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1419 to a location stored in the history see |netrw-u| and |netrw-U|.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1420
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1421 Related Topics:
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1422 |netrw-mB| how to delete bookmarks
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1423 |netrw-mb| how to make a bookmark
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1424 |netrw-qb| how to list bookmarks
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1425
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1426
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
1427 CHANGING TO A PREDECESSOR DIRECTORY *netrw-u* *netrw-updir* {{{2
36
125e80798a85 updated for version 7.0021
vimboss
parents: 26
diff changeset
1428
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1429 Every time you change to a new directory (new for the current session), netrw
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1430 will save the directory in a recently-visited directory history list (unless
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1431 |g:netrw_dirhistmax| is zero; by default, it holds ten entries). With the "u"
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1432 map, one can change to an earlier directory (predecessor). To do the
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1433 opposite, see |netrw-U|.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1434
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1435 The "u" map also accepts counts to go back in the history several slots. For
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1436 your convenience, qb (see |netrw-qb|) lists the history number which may be
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1437 used in that count.
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1438
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1439 *.netrwhist*
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1440 See |g:netrw_dirhistmax| for how to control the quantity of history stack
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1441 slots. The file ".netrwhist" holds history when netrw (and vim) is not
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1442 active. By default, its stored on the first directory on the user's
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1443 |'runtimepath'|.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1444
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1445 Related Topics:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1446 |netrw-U| changing to a successor directory
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1447 |g:netrw_home| controls where .netrwhist is kept
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1448
36
125e80798a85 updated for version 7.0021
vimboss
parents: 26
diff changeset
1449
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1450 CHANGING TO A SUCCESSOR DIRECTORY *netrw-U* *netrw-downdir* {{{2
36
125e80798a85 updated for version 7.0021
vimboss
parents: 26
diff changeset
1451
125e80798a85 updated for version 7.0021
vimboss
parents: 26
diff changeset
1452 With the "U" map, one can change to a later directory (successor).
125e80798a85 updated for version 7.0021
vimboss
parents: 26
diff changeset
1453 This map is the opposite of the "u" map. (see |netrw-u|) Use the
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1454 qb map to list both the bookmarks and history. (see |netrw-qb|)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1455
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1456 The "U" map also accepts counts to go forward in the history several slots.
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1457
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1458 See |g:netrw_dirhistmax| for how to control the quantity of history stack
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1459 slots.
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
1460
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1461
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1462 CHANGING TREE TOP *netrw-ntree* *:Ntree* *netrw-gn* {{{2
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1463
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1464 One may specify a new tree top for tree listings using >
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1465
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1466 :Ntree [dirname]
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1467
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1468 Without a "dirname", the current line is used (and any leading depth
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1469 information is elided).
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1470 With a "dirname", the specified directory name is used.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1471
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1472 The "gn" map will take the word below the cursor and use that for
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1473 changing the top of the tree listing.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1474
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1475
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1476 NETRW CLEAN *netrw-clean* *:NetrwClean* {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1477
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1478 With :NetrwClean one may easily remove netrw from one's home directory;
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1479 more precisely, from the first directory on your |'runtimepath'|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1480
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1481 With :NetrwClean!, netrw will attempt to remove netrw from all directories on
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1482 your |'runtimepath'|. Of course, you have to have write/delete permissions
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1483 correct to do this.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1484
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1485 With either form of the command, netrw will first ask for confirmation
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1486 that the removal is in fact what you want to do. If netrw doesn't have
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1487 permission to remove a file, it will issue an error message.
36
125e80798a85 updated for version 7.0021
vimboss
parents: 26
diff changeset
1488
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1489 *netrw-gx*
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1490 CUSTOMIZING BROWSING WITH A SPECIAL HANDLER *netrw-x* *netrw-handler* {{{2
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1491 (also see |netrw_filehandler|)
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1492
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1493 Certain files, such as html, gif, jpeg, (word/office) doc, etc, files, are
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1494 best seen with a special handler (ie. a tool provided with your computer's
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1495 operating system). Netrw allows one to invoke such special handlers by: >
12
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
1496
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1497 * when Exploring, hit the "x" key
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1498 * when editing, hit gx with the cursor atop the special filename
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1499 < (latter not available if the |g:netrw_nogx| variable exists)
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1500
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1501 Netrw determines which special handler by the following method:
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1502
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1503 * if |g:netrw_browsex_viewer| exists, then it will be used to attempt to
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1504 view files. Examples of useful settings (place into your <.vimrc>): >
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1505
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1506 :let g:netrw_browsex_viewer= "kfmclient exec"
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1507 < or >
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1508 :let g:netrw_browsex_viewer= "xdg-open"
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1509 <
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1510 If g:netrw_browsex_viewer == '-', then netrwFileHandlers#Invoke() will be
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1511 used instead (see |netrw_filehandler|).
12
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
1512
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1513 * for Windows 32 or 64, the URL and FileProtocolHandler dlls are used.
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1514 * for Gnome (with gnome-open): gnome-open is used.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1515 * for KDE (with kfmclient) : kfmclient is used
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1516 * for Mac OS X : open is used.
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
1517 * otherwise the netrwFileHandler plugin is used.
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
1518
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
1519 The file's suffix is used by these various approaches to determine an
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
1520 appropriate application to use to "handle" these files. Such things as
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
1521 OpenOffice (*.sfx), visualization (*.jpg, *.gif, etc), and PostScript (*.ps,
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
1522 *.eps) can be handled.
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
1523
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1524 The gx mapping extends to all buffers; apply "gx" while atop a word and netrw
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1525 will apply a special handler to it (like "x" works when in a netrw buffer).
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1526 One may also use visual mode (see |visual-start|) to select the text that the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1527 special handler will use. Normally gx uses expand("<cfile>") to pick up the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1528 text under the cursor; one may change what |expand()| uses via the
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1529 |g:netrw_gx| variable (options include "<cword>", "<cWORD>"). Note that
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1530 expand("<cfile>") depends on the |'isfname'| setting. Alternatively, one may
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1531 select the text to be used by gx by making a visual selection (see
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1532 |visual-block|) and then pressing gx.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1533
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1534 Associated setting variables:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1535 |g:netrw_gx| control how gx picks up the text under the cursor
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1536 |g:netrw_nogx| prevent gx map while editing
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
1537 |g:netrw_suppress_gx_mesg| controls gx's suppression of browser messages
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1538
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1539 *netrw_filehandler*
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1540
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1541 When |g:netrw_browsex_viewer| exists and is "-", then netrw will attempt to
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1542 handle the special file with a vim function. The "x" map applies a function
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1543 to a file, based on its extension. Of course, the handler function must exist
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1544 for it to be called!
12
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
1545 >
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1546 Ex. mypgm.html x -> NFH_html("scp://user@host/some/path/mypgm.html")
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1547
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1548 < Users may write their own netrw File Handler functions to
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1549 support more suffixes with special handling. See
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1550 <autoload/netrwFileHandlers.vim> for examples on how to make
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1551 file handler functions. As an example: >
12
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
1552
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1553 " NFH_suffix(filename)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1554 fun! NFH_suffix(filename)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1555 ..do something special with filename..
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1556 endfun
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1557 <
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1558 These functions need to be defined in some file in your .vim/plugin
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1559 (vimfiles\plugin) directory. Vim's function names may not have punctuation
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1560 characters (except for the underscore) in them. To support suffices that
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1561 contain such characters, netrw will first convert the suffix using the
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1562 following table: >
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1563
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1564 @ -> AT ! -> EXCLAMATION % -> PERCENT
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1565 : -> COLON = -> EQUAL ? -> QUESTION
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1566 , -> COMMA - -> MINUS ; -> SEMICOLON
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1567 $ -> DOLLAR + -> PLUS ~ -> TILDE
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1568 <
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1569 So, for example: >
650
662e40bd2be1 updated for version 7.0191
vimboss
parents: 568
diff changeset
1570
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1571 file.rcs,v -> NFH_rcsCOMMAv()
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1572 <
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1573 If more such translations are necessary, please send me email: >
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
1574 NcampObell@SdrPchip.AorgM-NOSPAM
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
1575 with a request. (remove the embedded NOSPAM first)
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
1576
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1577 Associated setting variable: |g:netrw_browsex_viewer|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1578
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1579 *netrw-curdir*
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1580 DELETING BOOKMARKS *netrw-mB* {{{2
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1581
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1582 To delete a bookmark, use >
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1583
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1584 {cnt}mB
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1585
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1586 If there are marked files, then mB will remove them from the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1587 bookmark list.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1588
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1589 Alternatively, one may use :NetrwMB! (see |netrw-:NetrwMB|). >
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1590
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1591 :NetrwMB! [files/directories]
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1592
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1593 Related Topics:
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1594 |netrw-gb| how to return (go) to a bookmark
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1595 |netrw-mb| how to make a bookmark
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1596 |netrw-qb| how to list bookmarks
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1597
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1598
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1599 DELETING FILES OR DIRECTORIES *netrw-delete* *netrw-D* *netrw-del* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1600
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1601 If files have not been marked with |netrw-mf|: (local marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1602
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1603 Deleting/removing files and directories involves moving the cursor to the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1604 file/directory to be deleted and pressing "D". Directories must be empty
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1605 first before they can be successfully removed. If the directory is a
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1606 softlink to a directory, then netrw will make two requests to remove the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1607 directory before succeeding. Netrw will ask for confirmation before doing
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1608 the removal(s). You may select a range of lines with the "V" command
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1609 (visual selection), and then pressing "D".
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1610
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1611 If files have been marked with |netrw-mf|: (local marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1612
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1613 Marked files (and empty directories) will be deleted; again, you'll be
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1614 asked to confirm the deletion before it actually takes place.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1615
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1616 A further approach is to delete files which match a pattern.
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1617
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1618 * use :MF pattern (see |netrw-:MF|); then press "D".
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1619
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1620 * use mr (see |netrw-mr|) which will prompt you for pattern.
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1621 This will cause the matching files to be marked. Then,
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1622 press "D".
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1623
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1624 If your vim has 7.4 with patch#1107, then |g:netrw_localrmdir| no longer
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1625 is used to remove directories; instead, vim's |delete()| is used with
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1626 the "d" option. Please note that only empty directories may be deleted
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1627 with the "D" mapping. Regular files are deleted with |delete()|, too.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1628
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1629 The |g:netrw_rm_cmd|, |g:netrw_rmf_cmd|, and |g:netrw_rmdir_cmd| variables are
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1630 used to control the attempts to remove remote files and directories. The
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1631 g:netrw_rm_cmd is used with files, and its default value is:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1632
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1633 g:netrw_rm_cmd: ssh HOSTNAME rm
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1634
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1635 The g:netrw_rmdir_cmd variable is used to support the removal of directories.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1636 Its default value is:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1637
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1638 |g:netrw_rmdir_cmd|: ssh HOSTNAME rmdir
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1639
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1640 If removing a directory fails with g:netrw_rmdir_cmd, netrw then will attempt
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1641 to remove it again using the g:netrw_rmf_cmd variable. Its default value is:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1642
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1643 |g:netrw_rmf_cmd|: ssh HOSTNAME rm -f
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1644
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1645 Related topics: |netrw-d|
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
1646 Associated setting variable: |g:netrw_localrmdir| |g:netrw_rm_cmd|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1647 |g:netrw_rmdir_cmd| |g:netrw_ssh_cmd|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1648
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1649
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1650 *netrw-explore* *netrw-hexplore* *netrw-nexplore* *netrw-pexplore*
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1651 *netrw-rexplore* *netrw-sexplore* *netrw-texplore* *netrw-vexplore* *netrw-lexplore*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1652 DIRECTORY EXPLORATION COMMANDS {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1653
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1654 :[N]Explore[!] [dir]... Explore directory of current file *:Explore*
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1655 :[N]Hexplore[!] [dir]... Horizontal Split & Explore *:Hexplore*
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1656 :[N]Lexplore[!] [dir]... Left Explorer Toggle *:Lexplore*
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1657 :[N]Sexplore[!] [dir]... Split&Explore current file's directory *:Sexplore*
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1658 :[N]Vexplore[!] [dir]... Vertical Split & Explore *:Vexplore*
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1659 :Texplore [dir]... Tab & Explore *:Texplore*
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1660 :Rexplore ... Return to/from Explorer *:Rexplore*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1661
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1662 Used with :Explore **/pattern : (also see |netrw-starstar|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1663 :Nexplore............. go to next matching file *:Nexplore*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1664 :Pexplore............. go to previous matching file *:Pexplore*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1665
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1666 *netrw-:Explore*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1667 :Explore will open the local-directory browser on the current file's
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1668 directory (or on directory [dir] if specified). The window will be
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1669 split only if the file has been modified and |'hidden'| is not set,
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1670 otherwise the browsing window will take over that window. Normally
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1671 the splitting is taken horizontally.
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1672 Also see: |netrw-:Rexplore|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1673 :Explore! is like :Explore, but will use vertical splitting.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1674
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1675 *netrw-:Hexplore*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1676 :Hexplore [dir] does an :Explore with |:belowright| horizontal splitting.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1677 :Hexplore! [dir] does an :Explore with |:aboveleft| horizontal splitting.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1678
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1679 *netrw-:Lexplore*
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1680 :[N]Lexplore [dir] toggles a full height Explorer window on the left hand side
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1681 of the current tab. It will open a netrw window on the current
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1682 directory if [dir] is omitted; a :Lexplore [dir] will show the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1683 specified directory in the left-hand side browser display no matter
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1684 from which window the command is issued.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1685
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1686 By default, :Lexplore will change an uninitialized |g:netrw_chgwin|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1687 to 2; edits will thus preferentially be made in window#2.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1688
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1689 The [N] specifies a |g:netrw_winsize| just for the new :Lexplore
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1690 window.
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1691
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1692 Those who like this method often also like tree style displays;
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1693 see |g:netrw_liststyle|.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1694
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1695 :[N]Lexplore! [dir] is similar to :Lexplore, except that the full-height
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1696 Explorer window will open on the right hand side and an
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1697 uninitialized |g:netrw_chgwin| will be set to 1 (eg. edits will
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1698 preferentially occur in the leftmost window).
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1699
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1700 Also see: |netrw-C| |g:netrw_browse_split| |g:netrw_wiw|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1701 |netrw-p| |netrw-P| |g:netrw_chgwin|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
1702 |netrw-c-tab| |g:netrw_winsize|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1703
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1704 *netrw-:Sexplore*
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1705 :[N]Sexplore will always split the window before invoking the local-directory
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1706 browser. As with Explore, the splitting is normally done
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1707 horizontally.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1708 :[N]Sexplore! [dir] is like :Sexplore, but the splitting will be done vertically.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1709
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1710 *netrw-:Texplore*
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1711 :Texplore [dir] does a |:tabnew| before generating the browser window
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1712
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1713 *netrw-:Vexplore*
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1714 :[N]Vexplore [dir] does an :Explore with |:leftabove| vertical splitting.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1715 :[N]Vexplore! [dir] does an :Explore with |:rightbelow| vertical splitting.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1716
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1717 The optional parameters are:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1718
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1719 [N]: This parameter will override |g:netrw_winsize| to specify the quantity of
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1720 rows and/or columns the new explorer window should have.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1721 Otherwise, the |g:netrw_winsize| variable, if it has been specified by the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1722 user, is used to control the quantity of rows and/or columns new
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1723 explorer windows should have.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1724
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1725 [dir]: By default, these explorer commands use the current file's directory.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1726 However, one may explicitly provide a directory (path) to use instead;
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1727 ie. >
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1728
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1729 :Explore /some/path
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1730 <
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1731 *netrw-:Rexplore*
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1732 :Rexplore This command is a little different from the other Explore commands
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1733 as it doesn't necessarily open an Explorer window.
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1735 Return to Explorer~
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1736 When one edits a file using netrw which can occur, for example,
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1737 when pressing <cr> while the cursor is atop a filename in a netrw
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1738 browser window, a :Rexplore issued while editing that file will
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1739 return the display to that of the last netrw browser display in
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1740 that window.
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1741
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1742 Return from Explorer~
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1743 Conversely, when one is editing a directory, issuing a :Rexplore
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
1744 will return to editing the file that was last edited in that
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1745 window.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1746
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1747 The <2-leftmouse> map (which is only available under gvim and
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1748 cooperative terms) does the same as :Rexplore.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1749
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1750 Also see: |g:netrw_alto| |g:netrw_altv| |g:netrw_winsize|
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1751
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1752
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1753 *netrw-star* *netrw-starpat* *netrw-starstar* *netrw-starstarpat* *netrw-grep*
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1754 EXPLORING WITH STARS AND PATTERNS {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1755
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1756 When Explore, Sexplore, Hexplore, or Vexplore are used with one of the
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1757 following four patterns Explore generates a list of files which satisfy the
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1758 request for the local file system. These exploration patterns will not work
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
1759 with remote file browsing.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1760
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1761 */filepat files in current directory which satisfy filepat
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1762 **/filepat files in current directory or below which satisfy the
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1763 file pattern
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1764 *//pattern files in the current directory which contain the
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1765 pattern (vimgrep is used)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1766 **//pattern files in the current directory or below which contain
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1767 the pattern (vimgrep is used)
464
3b705e71c7b0 updated for version 7.0124
vimboss
parents: 461
diff changeset
1768 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1769 The cursor will be placed on the first file in the list. One may then
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1770 continue to go to subsequent files on that list via |:Nexplore| or to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1771 preceding files on that list with |:Pexplore|. Explore will update the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1772 directory and place the cursor appropriately.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1773
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1774 A plain >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1775 :Explore
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1776 will clear the explore list.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1777
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1778 If your console or gui produces recognizable shift-up or shift-down sequences,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1779 then you'll likely find using shift-downarrow and shift-uparrow convenient.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1780 They're mapped by netrw as follows:
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1781
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1782 <s-down> == Nexplore, and
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1783 <s-up> == Pexplore.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1784
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1785 As an example, consider
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1786 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1787 :Explore */*.c
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1788 :Nexplore
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1789 :Nexplore
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1790 :Pexplore
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1791 <
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1792 The status line will show, on the right hand side of the status line, a
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1793 message like "Match 3 of 20".
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1794
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1795 Associated setting variables:
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1796 |g:netrw_keepdir| |g:netrw_browse_split|
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1797 |g:netrw_fastbrowse| |g:netrw_ftp_browse_reject|
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1798 |g:netrw_ftp_list_cmd| |g:netrw_ftp_sizelist_cmd|
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1799 |g:netrw_ftp_timelist_cmd| |g:netrw_list_cmd|
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1800 |g:netrw_liststyle|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1801
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1802
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1803 DISPLAYING INFORMATION ABOUT FILE *netrw-qf* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1804
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1805 With the cursor atop a filename, pressing "qf" will reveal the file's size
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1806 and last modification timestamp. Currently this capability is only available
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1807 for local files.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1808
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1809
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1810 EDIT FILE OR DIRECTORY HIDING LIST *netrw-ctrl-h* *netrw-edithide* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1811
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1812 The "<ctrl-h>" map brings up a requestor allowing the user to change the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1813 file/directory hiding list contained in |g:netrw_list_hide|. The hiding list
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1814 consists of one or more patterns delimited by commas. Files and/or
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1815 directories satisfying these patterns will either be hidden (ie. not shown) or
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1816 be the only ones displayed (see |netrw-a|).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1817
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1818 The "gh" mapping (see |netrw-gh|) quickly alternates between the usual
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1819 hiding list and the hiding of files or directories that begin with ".".
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1820
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1821 As an example, >
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1822 let g:netrw_list_hide= '\(^\|\s\s\)\zs\.\S\+'
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1823 Effectively, this makes the effect of a |netrw-gh| command the initial setting.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1824 What it means:
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1825
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1826 \(^\|\s\s\) : if the line begins with the following, -or-
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1827 two consecutive spaces are encountered
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1828 \zs : start the hiding match now
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1829 \. : if it now begins with a dot
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1830 \S\+ : and is followed by one or more non-whitespace
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1831 characters
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1832
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1833 Associated setting variables: |g:netrw_hide| |g:netrw_list_hide|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1834 Associated topics: |netrw-a| |netrw-gh| |netrw-mh|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1835
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
1836 *netrw-sort-sequence*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1837 EDITING THE SORTING SEQUENCE *netrw-S* *netrw-sortsequence* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1838
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1839 When "Sorted by" is name, one may specify priority via the sorting sequence
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1840 (g:netrw_sort_sequence). The sorting sequence typically prioritizes the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1841 name-listing by suffix, although any pattern will do. Patterns are delimited
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1842 by commas. The default sorting sequence is (all one line):
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1843
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1844 For Unix: >
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1845 '[\/]$,\<core\%(\.\d\+\)\=,\.[a-np-z]$,\.h$,\.c$,\.cpp$,*,\.o$,\.obj$,
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1846 \.info$,\.swp$,\.bak$,\~$'
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1847 <
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
1848 Otherwise: >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1849 '[\/]$,\.[a-np-z]$,\.h$,\.c$,\.cpp$,*,\.o$,\.obj$,\.info$,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1850 \.swp$,\.bak$,\~$'
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1851 <
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1852 The lone * is where all filenames not covered by one of the other patterns
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1853 will end up. One may change the sorting sequence by modifying the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1854 g:netrw_sort_sequence variable (either manually or in your <.vimrc>) or by
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1855 using the "S" map.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1856
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
1857 Related topics: |netrw-s| |netrw-S|
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
1858 Associated setting variables: |g:netrw_sort_sequence| |g:netrw_sort_options|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1859
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1860
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1861 EXECUTING FILE UNDER CURSOR VIA SYSTEM() *netrw-X* {{{2
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
1862
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
1863 Pressing X while the cursor is atop an executable file will yield a prompt
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
1864 using the filename asking for any arguments. Upon pressing a [return], netrw
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1865 will then call |system()| with that command and arguments. The result will be
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1866 displayed by |:echomsg|, and so |:messages| will repeat display of the result.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1867 Ansi escape sequences will be stripped out.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1868
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
1869 See |cmdline-window| for directions for more on how to edit the arguments.
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
1870
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
1871
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1872 FORCING TREATMENT AS A FILE OR DIRECTORY *netrw-gd* *netrw-gf* {{{2
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1873
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1874 Remote symbolic links (ie. those listed via ssh or ftp) are problematic
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1875 in that it is difficult to tell whether they link to a file or to a
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1876 directory.
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1877
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1878 To force treatment as a file: use >
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
1879 gf
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1880 <
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1881 To force treatment as a directory: use >
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
1882 gd
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1883 <
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
1884
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1885 GOING UP *netrw--* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1886
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1887 To go up a directory, press "-" or press the <cr> when atop the ../ directory
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1888 entry in the listing.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1889
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1890 Netrw will use the command in |g:netrw_list_cmd| to perform the directory
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1891 listing operation after changing HOSTNAME to the host specified by the
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1892 user-prpvided url. By default netrw provides the command as: >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1893
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1894 ssh HOSTNAME ls -FLa
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
1895 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1896 where the HOSTNAME becomes the [user@]hostname as requested by the attempt to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1897 read. Naturally, the user may override this command with whatever is
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1898 preferred. The NetList function which implements remote browsing
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1899 expects that directories will be flagged by a trailing slash.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1900
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1901
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1902 HIDING FILES OR DIRECTORIES *netrw-a* *netrw-hiding* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1903
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1904 Netrw's browsing facility allows one to use the hiding list in one of three
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1905 ways: ignore it, hide files which match, and show only those files which
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1906 match.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1907
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1908 If no files have been marked via |netrw-mf|:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1909
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1910 The "a" map allows the user to cycle through the three hiding modes.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1911
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1912 The |g:netrw_list_hide| variable holds a comma delimited list of patterns
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1913 based on regular expressions (ex. ^.*\.obj$,^\.) which specify the hiding list.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1914 (also see |netrw-ctrl-h|) To set the hiding list, use the <c-h> map. As an
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1915 example, to hide files which begin with a ".", one may use the <c-h> map to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1916 set the hiding list to '^\..*' (or one may put let g:netrw_list_hide= '^\..*'
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1917 in one's <.vimrc>). One may then use the "a" key to show all files, hide
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1918 matching files, or to show only the matching files.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1919
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1920 Example: \.[ch]$
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1921 This hiding list command will hide/show all *.c and *.h files.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1922
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1923 Example: \.c$,\.h$
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1924 This hiding list command will also hide/show all *.c and *.h
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1925 files.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1926
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1927 Don't forget to use the "a" map to select the mode (normal/hiding/show) you
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1928 want!
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1929
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1930 If files have been marked using |netrw-mf|, then this command will:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1931
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1932 if showing all files or non-hidden files:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1933 modify the g:netrw_list_hide list by appending the marked files to it
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1934 and showing only non-hidden files.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1935
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1936 else if showing hidden files only:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1937 modify the g:netrw_list_hide list by removing the marked files from it
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1938 and showing only non-hidden files.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1939 endif
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1940
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1941 *netrw-gh* *netrw-hide*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1942 As a quick shortcut, one may press >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1943 gh
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1944 to toggle between hiding files which begin with a period (dot) and not hiding
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1945 them.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1946
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1947 Associated setting variables: |g:netrw_list_hide| |g:netrw_hide|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1948 Associated topics: |netrw-a| |netrw-ctrl-h| |netrw-mh|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1949
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1950 *netrw-gitignore*
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1951 Netrw provides a helper function 'netrw_gitignore#Hide()' that, when used with
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1952 |g:netrw_list_hide| automatically hides all git-ignored files.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1953
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1954 'netrw_gitignore#Hide' searches for patterns in the following files: >
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1955
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1956 './.gitignore'
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1957 './.git/info/exclude'
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1958 global gitignore file: `git config --global core.excludesfile`
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1959 system gitignore file: `git config --system core.excludesfile`
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1960 <
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1961 Files that do not exist, are ignored.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1962 Git-ignore patterns are taken from existing files, and converted to patterns for
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1963 hiding files. For example, if you had '*.log' in your '.gitignore' file, it
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1964 would be converted to '.*\.log'.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1965
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1966 To use this function, simply assign its output to |g:netrw_list_hide| option. >
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1967
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1968 Example: let g:netrw_list_hide= netrw_gitignore#Hide()
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1969 Git-ignored files are hidden in Netrw.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1970
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1971 Example: let g:netrw_list_hide= netrw_gitignore#Hide('my_gitignore_file')
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1972 Function can take additional files with git-ignore patterns.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1973
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1974 Example: g:netrw_list_hide= netrw_gitignore#Hide() . '.*\.swp$'
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1975 Combining 'netrw_gitignore#Hide' with custom patterns.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
1976 <
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
1977
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
1978 IMPROVING BROWSING *netrw-listhack* *netrw-ssh-hack* {{{2
12
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
1979
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
1980 Especially with the remote directory browser, constantly entering the password
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
1981 is tedious.
bdeee1504ac1 updated for version 7.0004
vimboss
parents: 11
diff changeset
1982
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1983 For Linux/Unix systems, the book "Linux Server Hacks - 100 industrial strength
1209
070f2ac50cf8 updated for version 7.1b
vimboss
parents: 1121
diff changeset
1984 tips & tools" by Rob Flickenger (O'Reilly, ISBN 0-596-00461-3) gives a tip
070f2ac50cf8 updated for version 7.1b
vimboss
parents: 1121
diff changeset
1985 for setting up no-password ssh and scp and discusses associated security
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1986 issues. It used to be available at http://hacks.oreilly.com/pub/h/66 ,
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
1987 but apparently that address is now being redirected to some "hackzine".
1698
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1988 I'll attempt a summary based on that article and on a communication from
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1989 Ben Schmidt:
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1990
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1991 1. Generate a public/private key pair on the local machine
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1992 (ssh client): >
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1993 ssh-keygen -t rsa
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1994 (saving the file in ~/.ssh/id_rsa as prompted)
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1995 <
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1996 2. Just hit the <CR> when asked for passphrase (twice) for no
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1997 passphrase. If you do use a passphrase, you will also need to use
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1998 ssh-agent so you only have to type the passphrase once per session.
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
1999 If you don't use a passphrase, simply logging onto your local
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2000 computer or getting access to the keyfile in any way will suffice
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2001 to access any ssh servers which have that key authorized for login.
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2002
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2003 3. This creates two files: >
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2004 ~/.ssh/id_rsa
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2005 ~/.ssh/id_rsa.pub
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2006 <
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2007 4. On the target machine (ssh server): >
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2008 cd
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2009 mkdir -p .ssh
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2010 chmod 0700 .ssh
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2011 <
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2012 5. On your local machine (ssh client): (one line) >
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2013 ssh {serverhostname}
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2014 cat '>>' '~/.ssh/authorized_keys2' < ~/.ssh/id_rsa.pub
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2015 <
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2016 or, for OpenSSH, (one line) >
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2017 ssh {serverhostname}
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2018 cat '>>' '~/.ssh/authorized_keys' < ~/.ssh/id_rsa.pub
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2019 <
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2020 You can test it out with >
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2021 ssh {serverhostname}
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2022 and you should be log onto the server machine without further need to type
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2023 anything.
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2024
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2025 If you decided to use a passphrase, do: >
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2026 ssh-agent $SHELL
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2027 ssh-add
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2028 ssh {serverhostname}
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2029 You will be prompted for your key passphrase when you use ssh-add, but not
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2030 subsequently when you use ssh. For use with vim, you can use >
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2031 ssh-agent vim
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2032 and, when next within vim, use >
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2033 :!ssh-add
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2034 Alternatively, you can apply ssh-agent to the terminal you're planning on
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2035 running vim in: >
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2036 ssh-agent xterm &
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2037 and do ssh-add whenever you need.
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
2038
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
2039 For Windows, folks on the vim mailing list have mentioned that Pageant helps
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
2040 with avoiding the constant need to enter the password.
794
f19994020dad updated for version 7.0231
vimboss
parents: 766
diff changeset
2041
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2042 Kingston Fung wrote about another way to avoid constantly needing to enter
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2043 passwords:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2044
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2045 In order to avoid the need to type in the password for scp each time, you
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2046 provide a hack in the docs to set up a non password ssh account. I found a
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2047 better way to do that: I can use a regular ssh account which uses a
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2048 password to access the material without the need to key-in the password
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2049 each time. It's good for security and convenience. I tried ssh public key
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2050 authorization + ssh-agent, implementing this, and it works! Here are two
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2051 links with instructions:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2052
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2053 http://www.ibm.com/developerworks/library/l-keyc2/
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2054 http://sial.org/howto/openssh/publickey-auth/
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2055
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2056
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2057 Ssh hints:
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2058
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2059 Thomer Gil has provided a hint on how to speed up netrw+ssh:
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2060 http://thomer.com/howtos/netrw_ssh.html
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2061
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2062 Alex Young has several hints on speeding ssh up:
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2063 http://usevim.com/2012/03/16/editing-remote-files/
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2064
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2065
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2066 LISTING BOOKMARKS AND HISTORY *netrw-qb* *netrw-listbookmark* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2067
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2068 Pressing "qb" (query bookmarks) will list both the bookmarked directories and
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2069 directory traversal history.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2070
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2071 Related Topics:
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2072 |netrw-gb| how to return (go) to a bookmark
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2073 |netrw-mb| how to make a bookmark
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2074 |netrw-mB| how to delete bookmarks
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2075 |netrw-u| change to a predecessor directory via the history stack
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2076 |netrw-U| change to a successor directory via the history stack
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2077
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2078 MAKING A NEW DIRECTORY *netrw-d* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2079
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2080 With the "d" map one may make a new directory either remotely (which depends
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2081 on the global variable g:netrw_mkdir_cmd) or locally (which depends on the
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2082 global variable g:netrw_localmkdir). Netrw will issue a request for the new
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2083 directory's name. A bare <CR> at that point will abort the making of the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2084 directory. Attempts to make a local directory that already exists (as either
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2085 a file or a directory) will be detected, reported on, and ignored.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2086
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2087 Related topics: |netrw-D|
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2088 Associated setting variables: |g:netrw_localmkdir| |g:netrw_mkdir_cmd|
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2089 |g:netrw_remote_mkdir| |netrw-%|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2090
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2091
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2092 MAKING THE BROWSING DIRECTORY THE CURRENT DIRECTORY *netrw-cd* {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2093
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2094 By default, |g:netrw_keepdir| is 1. This setting means that the current
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2095 directory will not track the browsing directory. (done for backwards
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2096 compatibility with v6's file explorer).
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2097
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2098 Setting g:netrw_keepdir to 0 tells netrw to make vim's current directory
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2099 track netrw's browsing directory.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2100
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2101 However, given the default setting for g:netrw_keepdir of 1 where netrw
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2102 maintains its own separate notion of the current directory, in order to make
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2103 the two directories the same, use the "cd" map (type cd). That map will
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2104 set Vim's notion of the current directory to netrw's current browsing
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2105 directory.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2106
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
2107 |netrw-cd|: This map's name was changed from "c" to cd (see |netrw-cd|).
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2108 This change was done to allow for |netrw-cb| and |netrw-cB| maps.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2109
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2110 Associated setting variable: |g:netrw_keepdir|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2111
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2112 MARKING FILES *netrw-:MF* *netrw-mf* {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2113 (also see |netrw-mr|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2114
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2115 Netrw provides several ways to mark files:
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2116
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2117 * One may mark files with the cursor atop a filename and
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2118 then pressing "mf".
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2119
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2120 * With gvim, in addition one may mark files with
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2121 <s-leftmouse>. (see |netrw-mouse|)
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2122
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2123 * One may use the :MF command, which takes a list of
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2124 files (for local directories, the list may include
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2125 wildcards -- see |glob()|) >
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2126
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2127 :MF *.c
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2128 <
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2129 (Note that :MF uses |<f-args>| to break the line
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2130 at spaces)
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2131
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2132 * Mark files using the |argument-list| (|netrw-mA|)
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2133
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2134 * Mark files based upon a |location-list| (|netrw-qL|)
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2135
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2136 * Mark files based upon the quickfix list (|netrw-qF|)
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2137 (|quickfix-error-lists|)
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2138
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2139 The following netrw maps make use of marked files:
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2140
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2141 |netrw-a| Hide marked files/directories
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2142 |netrw-D| Delete marked files/directories
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2143 |netrw-ma| Move marked files' names to |arglist|
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2144 |netrw-mA| Move |arglist| filenames to marked file list
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2145 |netrw-mb| Append marked files to bookmarks
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2146 |netrw-mB| Delete marked files from bookmarks
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2147 |netrw-mc| Copy marked files to target
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2148 |netrw-md| Apply vimdiff to marked files
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2149 |netrw-me| Edit marked files
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2150 |netrw-mF| Unmark marked files
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2151 |netrw-mg| Apply vimgrep to marked files
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2152 |netrw-mm| Move marked files to target
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2153 |netrw-mp| Print marked files
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2154 |netrw-ms| Netrw will source marked files
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2155 |netrw-mt| Set target for |netrw-mm| and |netrw-mc|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2156 |netrw-mT| Generate tags using marked files
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2157 |netrw-mv| Apply vim command to marked files
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2158 |netrw-mx| Apply shell command to marked files
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2159 |netrw-mX| Apply shell command to marked files, en bloc
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2160 |netrw-mz| Compress/Decompress marked files
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2161 |netrw-O| Obtain marked files
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2162 |netrw-R| Rename marked files
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2163
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2164 One may unmark files one at a time the same way one marks them; ie. place
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2165 the cursor atop a marked file and press "mf". This process also works
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2166 with <s-leftmouse> using gvim. One may unmark all files by pressing
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2167 "mu" (see |netrw-mu|).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2168
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2169 Marked files are highlighted using the "netrwMarkFile" highlighting group,
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2170 which by default is linked to "Identifier" (see Identifier under
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2171 |group-name|). You may change the highlighting group by putting something
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2172 like >
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2173
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2174 highlight clear netrwMarkFile
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2175 hi link netrwMarkFile ..whatever..
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2176 <
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2177 into $HOME/.vim/after/syntax/netrw.vim .
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2178
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2179 If the mouse is enabled and works with your vim, you may use <s-leftmouse> to
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2180 mark one or more files. You may mark multiple files by dragging the shifted
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2181 leftmouse. (see |netrw-mouse|)
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2182
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2183 *markfilelist* *global_markfilelist* *local_markfilelist*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2184 All marked files are entered onto the global marked file list; there is only
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2185 one such list. In addition, every netrw buffer also has its own buffer-local
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2186 marked file list; since netrw buffers are associated with specific
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2187 directories, this means that each directory has its own local marked file
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2188 list. The various commands which operate on marked files use one or the other
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2189 of the marked file lists.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2190
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2191 Known Problem: if one is using tree mode (|g:netrw_liststyle|) and several
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2192 directories have files with the same name, then marking such a file will
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2193 result in all such files being highlighted as if they were all marked. The
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2194 |markfilelist|, however, will only have the selected file in it. This problem
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2195 is unlikely to be fixed.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2196
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2197
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2198 UNMARKING FILES *netrw-mF* {{{2
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2199 (also see |netrw-mf|, |netrw-mu|)
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2200
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2201 The "mF" command will unmark all files in the current buffer. One may also use
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2202 mf (|netrw-mf|) on a specific, already marked, file to unmark just that file.
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2203
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2204 MARKING FILES BY LOCATION LIST *netrw-qL* {{{2
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2205 (also see |netrw-mf|)
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2206
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2207 One may convert |location-list|s into a marked file list using "qL".
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2208 You may then proceed with commands such as me (|netrw-me|) to edit them.
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2209
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2210
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2211 MARKING FILES BY QUICKFIX LIST *netrw-qF* {{{2
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2212 (also see |netrw-mf|)
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2213
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2214 One may convert |quickfix-error-lists| into a marked file list using "qF".
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2215 You may then proceed with commands such as me (|netrw-me|) to edit them.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2216 Quickfix error lists are generated, for example, by calls to |:vimgrep|.
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2217
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2218
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2219 MARKING FILES BY REGULAR EXPRESSION *netrw-mr* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2220 (also see |netrw-mf|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2221
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2222 One may also mark files by pressing "mr"; netrw will then issue a prompt,
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2223 "Enter regexp: ". You may then enter a shell-style regular expression such
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2224 as *.c$ (see |glob()|). For remote systems, glob() doesn't work -- so netrw
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2225 converts "*" into ".*" (see |regexp|) and marks files based on that. In the
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2226 future I may make it possible to use |regexp|s instead of glob()-style
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2227 expressions (yet-another-option).
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2228
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2229 See |cmdline-window| for directions on more on how to edit the regular
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2230 expression.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2231
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2232
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2233 MARKED FILES, ARBITRARY VIM COMMAND *netrw-mv* {{{2
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2234 (See |netrw-mf| and |netrw-mr| for how to mark files)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2235 (uses the local marked-file list)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2236
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2237 The "mv" map causes netrw to execute an arbitrary vim command on each file on
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2238 the local marked file list, individually:
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2239
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2240 * 1split
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2241 * sil! keepalt e file
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2242 * run vim command
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2243 * sil! keepalt wq!
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2244
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2245 A prompt, "Enter vim command: ", will be issued to elicit the vim command you
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2246 wish used. See |cmdline-window| for directions for more on how to edit the
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2247 command.
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2248
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2249
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2250 MARKED FILES, ARBITRARY SHELL COMMAND *netrw-mx* {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2251 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2252 (uses the local marked-file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2253
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2254 Upon activation of the "mx" map, netrw will query the user for some (external)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2255 command to be applied to all marked files. All "%"s in the command will be
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2256 substituted with the name of each marked file in turn. If no "%"s are in the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2257 command, then the command will be followed by a space and a marked filename.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2258
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2259 Example:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2260 (mark files)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2261 mx
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2262 Enter command: cat
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2263
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2264 The result is a series of shell commands:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2265 cat 'file1'
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2266 cat 'file2'
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2267 ...
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2268
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2269
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2270 MARKED FILES, ARBITRARY SHELL COMMAND, EN BLOC *netrw-mX* {{{2
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2271 (See |netrw-mf| and |netrw-mr| for how to mark files)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2272 (uses the global marked-file list)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2273
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2274 Upon activation of the 'mX' map, netrw will query the user for some (external)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2275 command to be applied to all marked files on the global marked file list. The
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2276 "en bloc" means that one command will be executed on all the files at once: >
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2277
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2278 command files
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2279
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2280 This approach is useful, for example, to select files and make a tarball: >
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2281
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2282 (mark files)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2283 mX
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2284 Enter command: tar cf mynewtarball.tar
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2285 <
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2286 The command that will be run with this example:
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2287
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2288 tar cf mynewtarball.tar 'file1' 'file2' ...
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2289
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2290
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2291 MARKED FILES: ARGUMENT LIST *netrw-ma* *netrw-mA*
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2292 (See |netrw-mf| and |netrw-mr| for how to mark files)
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2293 (uses the global marked-file list)
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2294
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2295 Using ma, one moves filenames from the marked file list to the argument list.
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2296 Using mA, one moves filenames from the argument list to the marked file list.
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2297
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2298 See Also: |netrw-cb| |netrw-cB| |netrw-qF| |argument-list| |:args|
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2299
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2300
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2301 MARKED FILES: BUFFER LIST *netrw-cb* *netrw-cB*
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2302 (See |netrw-mf| and |netrw-mr| for how to mark files)
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2303 (uses the global marked-file list)
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2304
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2305 Using cb, one moves filenames from the marked file list to the buffer list.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2306 Using cB, one copies filenames from the buffer list to the marked file list.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2307
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2308 See Also: |netrw-ma| |netrw-mA| |netrw-qF| |buffer-list| |:buffers|
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2309
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2310
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2311 MARKED FILES: COMPRESSION AND DECOMPRESSION *netrw-mz* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2312 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2313 (uses the local marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2314
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2315 If any marked files are compressed, then "mz" will decompress them.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2316 If any marked files are decompressed, then "mz" will compress them
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2317 using the command specified by |g:netrw_compress|; by default,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2318 that's "gzip".
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2319
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2320 For decompression, netrw uses a |Dictionary| of suffices and their
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2321 associated decompressing utilities; see |g:netrw_decompress|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2322
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2323 Remember that one can mark multiple files by regular expression
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2324 (see |netrw-mr|); this is particularly useful to facilitate compressing and
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2325 decompressing a large number of files.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2326
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2327 Associated setting variables: |g:netrw_compress| |g:netrw_decompress|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2328
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2329 MARKED FILES: COPYING *netrw-mc* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2330 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2331 (Uses the global marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2332
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2333 Select a target directory with mt (|netrw-mt|). Then change directory,
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2334 select file(s) (see |netrw-mf|), and press "mc". The copy is done
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2335 from the current window (where one does the mf) to the target.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2336
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2337 If one does not have a target directory set with |netrw-mt|, then netrw
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2338 will query you for a directory to copy to.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2339
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2340 One may also copy directories and their contents (local only) to a target
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2341 directory.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2342
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2343 Associated setting variables:
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2344 |g:netrw_localcopycmd| |g:netrw_localcopycmdopt|
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2345 |g:netrw_localcopydircmd| |g:netrw_localcopydircmdopt|
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2346 |g:netrw_ssh_cmd|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2347
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2348 MARKED FILES: DIFF *netrw-md* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2349 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2350 (uses the global marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2351
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2352 Use |vimdiff| to visualize difference between selected files (two or
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2353 three may be selected for this). Uses the global marked file list.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2354
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2355 MARKED FILES: EDITING *netrw-me* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2356 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2357 (uses the global marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2358
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2359 The "me" command will place the marked files on the |arglist| and commence
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2360 editing them. One may return the to explorer window with |:Rexplore|.
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2361 (use |:n| and |:p| to edit next and previous files in the arglist)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2362
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2363 MARKED FILES: GREP *netrw-mg* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2364 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2365 (uses the global marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2366
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2367 The "mg" command will apply |:vimgrep| to the marked files.
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2368 The command will ask for the requested pattern; one may then enter: >
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2369
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2370 /pattern/[g][j]
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2371 ! /pattern/[g][j]
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2372 pattern
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2373 <
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2374 With /pattern/, editing will start with the first item on the |quickfix| list
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2375 that vimgrep sets up (see |:copen|, |:cnext|, |:cprevious|, |:cclose|). The |:vimgrep|
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2376 command is in use, so without 'g' each line is added to quickfix list only
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2377 once; with 'g' every match is included.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2378
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2379 With /pattern/j, "mg" will winnow the current marked file list to just those
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2380 marked files also possessing the specified pattern. Thus, one may use >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2381
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2382 mr ...file-pattern...
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2383 mg /pattern/j
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2384 <
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2385 to have a marked file list satisfying the file-pattern but also restricted to
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2386 files containing some desired pattern.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2387
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2388
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2389 MARKED FILES: HIDING AND UNHIDING BY SUFFIX *netrw-mh* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2390 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2391 (uses the local marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2392
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2393 The "mh" command extracts the suffices of the marked files and toggles their
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2394 presence on the hiding list. Please note that marking the same suffix
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2395 this way multiple times will result in the suffix's presence being toggled
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2396 for each file (so an even quantity of marked files having the same suffix
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2397 is the same as not having bothered to select them at all).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2398
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2399 Related topics: |netrw-a| |g:netrw_list_hide|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2400
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2401 MARKED FILES: MOVING *netrw-mm* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2402 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2403 (uses the global marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2404
1698
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2405 WARNING: moving files is more dangerous than copying them.
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2406 A file being moved is first copied and then deleted; if the
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2407 copy operation fails and the delete succeeds, you will lose
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2408 the file. Either try things out with unimportant files
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2409 first or do the copy and then delete yourself using mc and D.
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2410 Use at your own risk!
f4f8014d516e updated for version 7.2c-000
vimboss
parents: 1668
diff changeset
2411
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2412 Select a target directory with mt (|netrw-mt|). Then change directory,
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2413 select file(s) (see |netrw-mf|), and press "mm". The move is done
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2414 from the current window (where one does the mf) to the target.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2415
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2416 Associated setting variable: |g:netrw_localmovecmd| |g:netrw_ssh_cmd|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2417
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2418 MARKED FILES: PRINTING *netrw-mp* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2419 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2420 (uses the local marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2421
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2422 When "mp" is used, netrw will apply the |:hardcopy| command to marked files.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2423 What netrw does is open each file in a one-line window, execute hardcopy, then
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2424 close the one-line window.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2425
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2426
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2427 MARKED FILES: SOURCING *netrw-ms* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2428 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2429 (uses the local marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2430
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2431 With "ms", netrw will source the marked files (using vim's |:source| command)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2432
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2433
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2434 MARKED FILES: SETTING THE TARGET DIRECTORY *netrw-mt* {{{2
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2435 (See |netrw-mf| and |netrw-mr| for how to mark files)
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2436
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2437 Set the marked file copy/move-to target (see |netrw-mc| and |netrw-mm|):
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2438
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2439 * If the cursor is atop a file name, then the netrw window's currently
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2440 displayed directory is used for the copy/move-to target.
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2441
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2442 * Also, if the cursor is in the banner, then the netrw window's currently
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2443 displayed directory is used for the copy/move-to target.
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2444 Unless the target already is the current directory. In which case,
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2445 typing "mf" clears the target.
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2446
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2447 * However, if the cursor is atop a directory name, then that directory is
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2448 used for the copy/move-to target
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2449
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2450 * One may use the :MT [directory] command to set the target *netrw-:MT*
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2451 This command uses |<q-args>|, so spaces in the directory name are
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2452 permitted without escaping.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2453
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2454 * With mouse-enabled vim or with gvim, one may select a target by using
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2455 <c-leftmouse>
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2456
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2457 There is only one copy/move-to target at a time in a vim session; ie. the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2458 target is a script variable (see |s:var|) and is shared between all netrw
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2459 windows (in an instance of vim).
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2460
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2461 When using menus and gvim, netrw provides a "Targets" entry which allows one
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2462 to pick a target from the list of bookmarks and history.
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2463
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2464 Related topics:
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2465 Marking Files......................................|netrw-mf|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2466 Marking Files by Regular Expression................|netrw-mr|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2467 Marked Files: Target Directory Using Bookmarks.....|netrw-Tb|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2468 Marked Files: Target Directory Using History.......|netrw-Th|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2469
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2470
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2471 MARKED FILES: TAGGING *netrw-mT* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2472 (See |netrw-mf| and |netrw-mr| for how to mark files)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2473 (uses the global marked file list)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2474
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2475 The "mT" mapping will apply the command in |g:netrw_ctags| (by default, it is
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2476 "ctags") to marked files. For remote browsing, in order to create a tags file
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2477 netrw will use ssh (see |g:netrw_ssh_cmd|), and so ssh must be available for
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2478 this to work on remote systems. For your local system, see |ctags| on how to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2479 get a version. I myself use hdrtags, currently available at
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
2480 http://www.drchip.org/astronaut/src/index.html , and have >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2481
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2482 let g:netrw_ctags= "hdrtag"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2483 <
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2484 in my <.vimrc>.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2485
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2486 When a remote set of files are tagged, the resulting tags file is "obtained";
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2487 ie. a copy is transferred to the local system's directory. The now local tags
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2488 file is then modified so that one may use it through the network. The
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2489 modification made concerns the names of the files in the tags; each filename is
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2490 preceded by the netrw-compatible URL used to obtain it. When one subsequently
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2491 uses one of the go to tag actions (|tags|), the URL will be used by netrw to
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2492 edit the desired file and go to the tag.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2493
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
2494 Associated setting variables: |g:netrw_ctags| |g:netrw_ssh_cmd|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2495
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2496 MARKED FILES: TARGET DIRECTORY USING BOOKMARKS *netrw-Tb* {{{2
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2497
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2498 Sets the marked file copy/move-to target.
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2499
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2500 The |netrw-qb| map will give you a list of bookmarks (and history).
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2501 One may choose one of the bookmarks to become your marked file
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2502 target by using [count]Tb (default count: 1).
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2503
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2504 Related topics:
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2505 Copying files to target............................|netrw-mc|
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2506 Listing Bookmarks and History......................|netrw-qb|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2507 Marked Files: Setting The Target Directory.........|netrw-mt|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2508 Marked Files: Target Directory Using History.......|netrw-Th|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2509 Marking Files......................................|netrw-mf|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2510 Marking Files by Regular Expression................|netrw-mr|
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2511 Moving files to target.............................|netrw-mm|
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2512
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2513
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2514 MARKED FILES: TARGET DIRECTORY USING HISTORY *netrw-Th* {{{2
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2515
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2516 Sets the marked file copy/move-to target.
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2517
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2518 The |netrw-qb| map will give you a list of history (and bookmarks).
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2519 One may choose one of the history entries to become your marked file
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2520 target by using [count]Th (default count: 0; ie. the current directory).
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2521
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2522 Related topics:
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2523 Copying files to target............................|netrw-mc|
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2524 Listing Bookmarks and History......................|netrw-qb|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2525 Marked Files: Setting The Target Directory.........|netrw-mt|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2526 Marked Files: Target Directory Using Bookmarks.....|netrw-Tb|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2527 Marking Files......................................|netrw-mf|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2528 Marking Files by Regular Expression................|netrw-mr|
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2529 Moving files to target.............................|netrw-mm|
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2530
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2531
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2532 MARKED FILES: UNMARKING *netrw-mu* {{{2
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2533 (See |netrw-mf|, |netrw-mF|)
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2534
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2535 The "mu" mapping will unmark all currently marked files. This command differs
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2536 from "mF" as the latter only unmarks files in the current directory whereas
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2537 "mu" will unmark global and all buffer-local marked files.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2538 (see |netrw-mF|)
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2539
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2540
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2541 *netrw-browser-settings*
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2542 NETRW BROWSER VARIABLES *netrw-browser-options* *netrw-browser-var* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2543
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2544 (if you're interested in the netrw file transfer settings, see |netrw-options|
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2545 and |netrw-protocol|)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2546
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2547 The <netrw.vim> browser provides settings in the form of variables which
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2548 you may modify; by placing these settings in your <.vimrc>, you may customize
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2549 your browsing preferences. (see also: |netrw-settings|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2550 >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2551 --- -----------
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2552 Var Explanation
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2553 --- -----------
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2554 < *g:netrw_altfile* some like |CTRL-^| to return to the last
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2555 edited file. Choose that by setting this
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2556 parameter to 1.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2557 Others like |CTRL-^| to return to the
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2558 netrw browsing buffer. Choose that by setting
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2559 this parameter to 0.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2560 default: =0
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2561
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2562 *g:netrw_alto* change from above splitting to below splitting
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2563 by setting this variable (see |netrw-o|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2564 default: =&sb (see |'sb'|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2565
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2566 *g:netrw_altv* change from left splitting to right splitting
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2567 by setting this variable (see |netrw-v|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2568 default: =&spr (see |'spr'|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2569
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2570 *g:netrw_banner* enable/suppress the banner
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2571 =0: suppress the banner
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2572 =1: banner is enabled (default)
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2573
4502
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
2574 *g:netrw_bannerbackslash* if this variable exists and is not zero, the
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
2575 banner will be displayed with backslashes
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
2576 rather than forward slashes.
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
2577
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2578 *g:netrw_browse_split* when browsing, <cr> will open the file by:
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2579 =0: re-using the same window (default)
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2580 =1: horizontally splitting the window first
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2581 =2: vertically splitting the window first
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2582 =3: open file in new tab
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2583 =4: act like "P" (ie. open previous window)
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2584 Note that |g:netrw_preview| may be used
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2585 to get vertical splitting instead of
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2586 horizontal splitting.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2587 =[servername,tab-number,window-number]
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2588 Given a |List| such as this, a remote server
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2589 named by the "servername" will be used for
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2590 editing. It will also use the specified tab
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2591 and window numbers to perform editing
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2592 (see |clientserver|, |netrw-ctrl-r|)
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2593 This option does not affect the production of
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2594 |:Lexplore| windows.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2595
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2596 Related topics:
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2597 |g:netrw_alto| |g:netrw_altv|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2598 |netrw-C| |netrw-cr|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2599 |netrw-ctrl-r|
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2600
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2601 *g:netrw_browsex_viewer* specify user's preference for a viewer: >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2602 "kfmclient exec"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2603 "gnome-open"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2604 < If >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2605 "-"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2606 < is used, then netrwFileHandler() will look for
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2607 a script/function to handle the given
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2608 extension. (see |netrw_filehandler|).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2609
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2610 *g:netrw_chgperm* Unix/Linux: "chmod PERM FILENAME"
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2611 Windows: "cacls FILENAME /e /p PERM"
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2612 Used to change access permission for a file.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2613
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2614 *g:netrw_compress* ="gzip"
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2615 Will compress marked files with this
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2616 command
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2617
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2618 *g:Netrw_corehandler* Allows one to specify something additional
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2619 to do when handling <core> files via netrw's
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2620 browser's "x" command (see |netrw-x|). If
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2621 present, g:Netrw_corehandler specifies
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2622 either one or more function references
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2623 (see |Funcref|). (the capital g:Netrw...
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2624 is required its holding a function reference)
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2625
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2626
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2627 *g:netrw_ctags* ="ctags"
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2628 The default external program used to create
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2629 tags
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2630
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2631 *g:netrw_cursor* = 2 (default)
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2632 This option controls the use of the
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2633 |'cursorline'| (cul) and |'cursorcolumn'|
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2634 (cuc) settings by netrw:
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2635
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2636 Value Thin-Long-Tree Wide
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2637 =0 u-cul u-cuc u-cul u-cuc
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2638 =1 u-cul u-cuc cul u-cuc
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2639 =2 cul u-cuc cul u-cuc
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2640 =3 cul u-cuc cul cuc
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2641 =4 cul cuc cul cuc
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2642
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2643 Where
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2644 u-cul : user's |'cursorline'| setting used
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2645 u-cuc : user's |'cursorcolumn'| setting used
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2646 cul : |'cursorline'| locally set
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2647 cuc : |'cursorcolumn'| locally set
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2648
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2649 *g:netrw_decompress* = { ".gz" : "gunzip" ,
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2650 ".bz2" : "bunzip2" ,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2651 ".zip" : "unzip" ,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2652 ".tar" : "tar -xf"}
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2653 A dictionary mapping suffices to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2654 decompression programs.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2655
2751
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2656 *g:netrw_dirhistmax* =10: controls maximum quantity of past
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2657 history. May be zero to supppress
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2658 history.
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2659 (related: |netrw-qb| |netrw-u| |netrw-U|)
b0d34143ebfc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
2660
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
2661 *g:netrw_dynamic_maxfilenamelen* =32: enables dynamic determination of
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
2662 |g:netrw_maxfilenamelen|, which affects
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
2663 local file long listing.
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2664
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2665 *g:netrw_errorlvl* =0: error levels greater than or equal to
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2666 this are permitted to be displayed
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2667 0: notes
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2668 1: warnings
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2669 2: errors
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2670
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2671 *g:netrw_fastbrowse* =0: slow speed directory browsing;
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2672 never re-uses directory listings;
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2673 always obtains directory listings.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2674 =1: medium speed directory browsing;
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2675 re-use directory listings only
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2676 when remote directory browsing.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2677 (default value)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2678 =2: fast directory browsing;
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2679 only obtains directory listings when the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2680 directory hasn't been seen before
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2681 (or |netrw-ctrl-l| is used).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2682
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2683 Fast browsing retains old directory listing
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2684 buffers so that they don't need to be
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2685 re-acquired. This feature is especially
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2686 important for remote browsing. However, if
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2687 a file is introduced or deleted into or from
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2688 such directories, the old directory buffer
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2689 becomes out-of-date. One may always refresh
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2690 such a directory listing with |netrw-ctrl-l|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2691 This option gives the user the choice of
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2692 trading off accuracy (ie. up-to-date listing)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2693 versus speed.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2694
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2695 *g:netrw_ffkeep* (default: doesn't exist)
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2696 If this variable exists and is zero, then
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2697 netrw will not do a save and restore for
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2698 |'fileformat'|.
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2699
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2700 *g:netrw_fname_escape* =' ?&;%'
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2701 Used on filenames before remote reading/writing
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2702
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2703 *g:netrw_ftp_browse_reject* ftp can produce a number of errors and warnings
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2704 that can show up as "directories" and "files"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2705 in the listing. This pattern is used to
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2706 remove such embedded messages. By default its
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2707 value is:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2708 '^total\s\+\d\+$\|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2709 ^Trying\s\+\d\+.*$\|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2710 ^KERBEROS_V\d rejected\|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2711 ^Security extensions not\|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2712 No such file\|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2713 : connect to address [0-9a-fA-F:]*
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2714 : No route to host$'
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2715
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2716 *g:netrw_ftp_list_cmd* options for passing along to ftp for directory
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2717 listing. Defaults:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2718 unix or g:netrw_cygwin set: : "ls -lF"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2719 otherwise "dir"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2720
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2721
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2722 *g:netrw_ftp_sizelist_cmd* options for passing along to ftp for directory
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2723 listing, sorted by size of file.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2724 Defaults:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2725 unix or g:netrw_cygwin set: : "ls -slF"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2726 otherwise "dir"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2727
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2728 *g:netrw_ftp_timelist_cmd* options for passing along to ftp for directory
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2729 listing, sorted by time of last modification.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2730 Defaults:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2731 unix or g:netrw_cygwin set: : "ls -tlF"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2732 otherwise "dir"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2733
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2734 *g:netrw_glob_escape* ='[]*?`{~$' (unix)
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
2735 ='[]*?`{$' (windows
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2736 These characters in directory names are
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2737 escaped before applying glob()
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2738
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2739 *g:netrw_gx* ="<cfile>"
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2740 This option controls how gx (|netrw-gx|) picks
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2741 up the text under the cursor. See |expand()|
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2742 for possibilities.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2743
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2744 *g:netrw_hide* Controlled by the "a" map (see |netrw-a|)
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2745 =0 : show all
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2746 =1 : show not-hidden files
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2747 =2 : show hidden files only
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2748 default: =1
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2749
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2750 *g:netrw_home* The home directory for where bookmarks and
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2751 history are saved (as .netrwbook and
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2752 .netrwhist).
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2753 Netrw uses |expand()|on the string.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2754 default: the first directory on the
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2755 |'runtimepath'|
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2756
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2757 *g:netrw_keepdir* =1 (default) keep current directory immune from
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2758 the browsing directory.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2759 =0 keep the current directory the same as the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2760 browsing directory.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2761 The current browsing directory is contained in
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
2762 b:netrw_curdir (also see |netrw-cd|)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2763
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2764 *g:netrw_keepj* ="keepj" (default) netrw attempts to keep the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2765 |:jumps| table unaffected.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2766 ="" netrw will not use |:keepjumps| with
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2767 exceptions only for the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2768 saving/restoration of position.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2769
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2770 *g:netrw_list_cmd* command for listing remote directories
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2771 default: (if ssh is executable)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2772 "ssh HOSTNAME ls -FLa"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2773
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2774 *g:netrw_list_cmd_options* If this variable exists, then its contents are
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2775 appended to the g:netrw_list_cmd. For
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2776 example, use "2>/dev/null" to get rid of banner
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2777 messages on unix systems.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2778
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2779
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2780 *g:netrw_liststyle* Set the default listing style:
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2781 = 0: thin listing (one file per line)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2782 = 1: long listing (one file per line with time
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2783 stamp information and file size)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2784 = 2: wide listing (multiple files in columns)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2785 = 3: tree style listing
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2786
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2787 *g:netrw_list_hide* comma separated pattern list for hiding files
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2788 Patterns are regular expressions (see |regexp|)
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2789 There's some special support for git-ignore
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2790 files: you may add the output from the helper
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2791 function 'netrw_gitignore#Hide() automatically
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2792 hiding all gitignored files.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2793 For more details see |netrw-gitignore|.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2794
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2795 Examples:
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2796 let g:netrw_list_hide= '.*\.swp$'
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2797 let g:netrw_list_hide= netrw_gitignore#Hide().'.*\.swp$'
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
2798 default: ""
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2799
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2800 *g:netrw_localcopycmd* ="cp" Linux/Unix/MacOS/Cygwin
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2801 =expand("$COMSPEC") Windows
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2802 Copies marked files (|netrw-mf|) to target
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2803 directory (|netrw-mt|, |netrw-mc|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2804
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2805 *g:netrw_localcopycmdopt* ='' Linux/Unix/MacOS/Cygwin
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2806 =' \c copy' Windows
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2807 Options for the |g:netrw_localcopycmd|
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2808
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2809 *g:netrw_localcopydircmd* ="cp" Linux/Unix/MacOS/Cygwin
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2810 =expand("$COMSPEC") Windows
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2811 Copies directories to target directory.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2812 (|netrw-mc|, |netrw-mt|)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2813
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2814 *g:netrw_localcopydircmdopt* =" -R" Linux/Unix/MacOS/Cygwin
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2815 =" /c xcopy /e /c /h/ /i /k" Windows
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2816 Options for |g:netrw_localcopydircmd|
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2817
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2818 *g:netrw_localmkdir* ="mkdir" Linux/Unix/MacOS/Cygwin
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2819 =expand("$COMSPEC") Windows
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2820 command for making a local directory
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2821
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2822 *g:netrw_localmkdiropt* ="" Linux/Unix/MacOS/Cygwin
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2823 =" /c mkdir" Windows
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2824 Options for |g:netrw_localmkdir|
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2825
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2826 *g:netrw_localmovecmd* ="mv" Linux/Unix/MacOS/Cygwin
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2827 =expand("$COMSPEC") Windows
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2828 Moves marked files (|netrw-mf|) to target
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2829 directory (|netrw-mt|, |netrw-mm|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2830
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2831 *g:netrw_localmovecmdopt* ="" Linux/Unix/MacOS/Cygwin
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2832 =" /c move" Windows
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2833 Options for |g:netrw_localmovecmd|
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2834
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2835 *g:netrw_localrmdir* ="rmdir" Linux/Unix/MacOS/Cygwin
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2836 =expand("$COMSPEC") Windows
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2837 Remove directory command (rmdir)
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2838 This variable is only used if your vim is
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2839 earlier than 7.4 or if your vim doesn't
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2840 have patch#1107. Otherwise, |delete()|
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2841 is used with the "d" option.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2842
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2843 *g:netrw_localrmdiropt* ="" Linux/Unix/MacOS/Cygwin
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2844 =" /c rmdir" Windows
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2845 Options for |g:netrw_localrmdir|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2846
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2847 *g:netrw_maxfilenamelen* =32 by default, selected so as to make long
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2848 listings fit on 80 column displays.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2849 If your screen is wider, and you have file
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2850 or directory names longer than 32 bytes,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2851 you may set this option to keep listings
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2852 columnar.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2853
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2854 *g:netrw_mkdir_cmd* command for making a remote directory
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2855 via ssh (also see |g:netrw_remote_mkdir|)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2856 default: "ssh USEPORT HOSTNAME mkdir"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2857
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
2858 *g:netrw_mousemaps* =1 (default) enables mouse buttons while
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2859 browsing to:
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2860 leftmouse : open file/directory
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2861 shift-leftmouse : mark file
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2862 middlemouse : same as P
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2863 rightmouse : remove file/directory
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2864 =0: disables mouse maps
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2865
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2866 *g:netrw_nobeval* doesn't exist (default)
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2867 If this variable exists, then balloon
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2868 evaluation will be suppressed
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2869 (see |'ballooneval'|)
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2870
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2871 *g:netrw_sizestyle* not defined: actual bytes (default)
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2872 ="b" : actual bytes (default)
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2873 ="h" : human-readable (ex. 5k, 4m, 3g)
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2874 uses 1000 base
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2875 ="H" : human-readable (ex. 5K, 4M, 3G)
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2876 uses 1024 base
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2877 The long listing (|netrw-i|) and query-file
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2878 maps (|netrw-qf|) will display file size
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2879 using the specified style.
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
2880
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2881 *g:netrw_usetab* if this variable exists and is non-zero, then
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2882 the <tab> map supporting shrinking/expanding a
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2883 Lexplore or netrw window will be enabled.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2884 (see |netrw-c-tab|)
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2885
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2886 *g:netrw_remote_mkdir* command for making a remote directory
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2887 via ftp (also see |g:netrw_mkdir_cmd|)
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2888 default: "mkdir"
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
2889
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2890 *g:netrw_retmap* if it exists and is set to one, then:
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2891 * if in a netrw-selected file, AND
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2892 * no normal-mode <2-leftmouse> mapping exists,
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2893 then the <2-leftmouse> will be mapped for easy
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2894 return to the netrw browser window.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2895 example: click once to select and open a file,
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2896 double-click to return.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2897
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2898 Note that one may instead choose to:
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2899 * let g:netrw_retmap= 1, AND
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2900 * nmap <silent> YourChoice <Plug>NetrwReturn
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2901 and have another mapping instead of
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2902 <2-leftmouse> to invoke the return.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2903
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2904 You may also use the |:Rexplore| command to do
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2905 the same thing.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2906
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2907 default: =0
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2908
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2909 *g:netrw_rm_cmd* command for removing remote files
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2910 default: "ssh USEPORT HOSTNAME rm"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2911
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2912 *g:netrw_rmdir_cmd* command for removing remote directories
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2913 default: "ssh USEPORT HOSTNAME rmdir"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2914
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
2915 *g:netrw_rmf_cmd* command for removing remote softlinks
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2916 default: "ssh USEPORT HOSTNAME rm -f"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2917
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2918 *g:netrw_servername* use this variable to provide a name for
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2919 |netrw-ctrl-r| to use for its server.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2920 default: "NETRWSERVER"
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
2921
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2922 *g:netrw_sort_by* sort by "name", "time", "size", or
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
2923 "exten".
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2924 default: "name"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2925
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2926 *g:netrw_sort_direction* sorting direction: "normal" or "reverse"
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2927 default: "normal"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2928
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2929 *g:netrw_sort_options* sorting is done using |:sort|; this
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
2930 variable's value is appended to the
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
2931 sort command. Thus one may ignore case,
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
2932 for example, with the following in your
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
2933 .vimrc: >
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
2934 let g:netrw_sort_options="i"
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
2935 < default: ""
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
2936
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2937 *g:netrw_sort_sequence* when sorting by name, first sort by the
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2938 comma-separated pattern sequence. Note that
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2939 any filigree added to indicate filetypes
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
2940 should be accounted for in your pattern.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2941 default: '[\/]$,*,\.bak$,\.o$,\.h$,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2942 \.info$,\.swp$,\.obj$'
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2943
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
2944 *g:netrw_special_syntax* If true, then certain files will be shown
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
2945 using special syntax in the browser:
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2946
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2947 netrwBak : *.bak
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2948 netrwCompress: *.gz *.bz2 *.Z *.zip
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2949 netrwCoreDump: core.\d\+
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2950 netrwData : *.dat
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2951 netrwDoc : *.doc,*.txt,*.pdf,
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2952 *.pdf,*.docx
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2953 netrwHdr : *.h
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2954 netrwLex : *.l *.lex
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2955 netrwLib : *.a *.so *.lib *.dll
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2956 netrwMakefile: [mM]akefile *.mak
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2957 netrwObj : *.o *.obj
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2958 netrwPix : *.bmp,*.fit,*.fits,*.gif,
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2959 *.jpg,*.jpeg,*.pcx,*.ppc
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2960 *.pgm,*.png,*.psd,*.rgb
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2961 *.tif,*.xbm,*.xcf
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2962 netrwTags : tags ANmenu ANtags
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2963 netrwTilde : *
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2964 netrwTmp : tmp* *tmp
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
2965 netrwYacc : *.y
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2966
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2967 In addition, those groups mentioned in
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2968 |'suffixes'| are also added to the special
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2969 file highlighting group.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2970 These syntax highlighting groups are linked
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2971 to netrwGray or Folded by default
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2972 (see |hl-Folded|), but one may put lines like >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2973 hi link netrwCompress Visual
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
2974 < into one's <.vimrc> to use one's own
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2975 preferences. Alternatively, one may
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2976 put such specifications into >
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2977 .vim/after/syntax/netrw.vim.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2978 < The netrwGray highlighting is set up by
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2979 netrw when >
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2980 * netrwGray has not been previously
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2981 defined
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2982 * the gui is running
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
2983 < As an example, I myself use a dark-background
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2984 colorscheme with the following in
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2985 .vim/after/syntax/netrw.vim: >
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2986
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2987 hi netrwCompress term=NONE cterm=NONE gui=NONE ctermfg=10 guifg=green ctermbg=0 guibg=black
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2988 hi netrwData term=NONE cterm=NONE gui=NONE ctermfg=9 guifg=blue ctermbg=0 guibg=black
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2989 hi netrwHdr term=NONE cterm=NONE,italic gui=NONE guifg=SeaGreen1
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2990 hi netrwLex term=NONE cterm=NONE,italic gui=NONE guifg=SeaGreen1
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2991 hi netrwYacc term=NONE cterm=NONE,italic gui=NONE guifg=SeaGreen1
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2992 hi netrwLib term=NONE cterm=NONE gui=NONE ctermfg=14 guifg=yellow
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2993 hi netrwObj term=NONE cterm=NONE gui=NONE ctermfg=12 guifg=red
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2994 hi netrwTilde term=NONE cterm=NONE gui=NONE ctermfg=12 guifg=red
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2995 hi netrwTmp term=NONE cterm=NONE gui=NONE ctermfg=12 guifg=red
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2996 hi netrwTags term=NONE cterm=NONE gui=NONE ctermfg=12 guifg=red
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2997 hi netrwDoc term=NONE cterm=NONE gui=NONE ctermfg=220 ctermbg=27 guifg=yellow2 guibg=Blue3
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2998 hi netrwSymLink term=NONE cterm=NONE gui=NONE ctermfg=220 ctermbg=27 guifg=grey60
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
2999 <
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3000 *g:netrw_ssh_browse_reject* ssh can sometimes produce unwanted lines,
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3001 messages, banners, and whatnot that one doesn't
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3002 want masquerading as "directories" and "files".
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3003 Use this pattern to remove such embedded
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3004 messages. By default its value is:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3005 '^total\s\+\d\+$'
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3006
4502
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
3007 *g:netrw_ssh_cmd* One may specify an executable command
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
3008 to use instead of ssh for remote actions
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
3009 such as listing, file removal, etc.
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
3010 default: ssh
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
3011
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
3012 *g:netrw_suppress_gx_mesg* =1 : browsers sometimes produce messages
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
3013 which are normally unwanted intermixed
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
3014 with the page.
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
3015 However, when using links, for example,
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
3016 those messages are what the browser produces.
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
3017 By setting this option to 0, netrw will not
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
3018 suppress browser messages.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3019
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3020 *g:netrw_tmpfile_escape* =' &;'
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3021 escape() is applied to all temporary files
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3022 to escape these characters.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3023
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3024 *g:netrw_timefmt* specify format string to vim's strftime().
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3025 The default, "%c", is "the preferred date
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3026 and time representation for the current
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3027 locale" according to my manpage entry for
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3028 strftime(); however, not all are satisfied
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3029 with it. Some alternatives:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3030 "%a %d %b %Y %T",
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3031 " %a %Y-%m-%d %I-%M-%S %p"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3032 default: "%c"
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3033
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3034 *g:netrw_use_noswf* netrw normally avoids writing swapfiles
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3035 for browser buffers. However, under some
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3036 systems this apparently is causing nasty
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3037 ml_get errors to appear; if you're getting
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3038 ml_get errors, try putting
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3039 let g:netrw_use_noswf= 0
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3040 in your .vimrc.
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3041 default: 1
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3042
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3043 *g:netrw_winsize* specify initial size of new windows made with
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3044 "o" (see |netrw-o|), "v" (see |netrw-v|),
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3045 |:Hexplore| or |:Vexplore|. The g:netrw_winsize
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3046 is an integer describing the percentage of the
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3047 current netrw buffer's window to be used for
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3048 the new window.
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
3049 If g:netrw_winsize is less than zero, then
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3050 the absolute value of g:netrw_winsize will be
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3051 used to specify the quantity of lines or
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3052 columns for the new window.
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3053 If g:netrw_winsize is zero, then a normal
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3054 split will be made (ie. |'equalalways'| will
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3055 take effect, for example).
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3056 default: 50 (for 50%)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3057
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3058 *g:netrw_wiw* =1 specifies the minimum window width to use
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3059 when shrinking a netrw/Lexplore window
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3060 (see |netrw-c-tab|).
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3061
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3062 *g:netrw_xstrlen* Controls how netrw computes string lengths,
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3063 including multi-byte characters' string
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3064 length. (thanks to N Weibull, T Mechelynck)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3065 =0: uses Vim's built-in strlen()
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3066 =1: number of codepoints (Latin a + combining
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3067 circumflex is two codepoints) (DEFAULT)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3068 =2: number of spacing codepoints (Latin a +
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3069 combining circumflex is one spacing
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3070 codepoint; a hard tab is one; wide and
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3071 narrow CJK are one each; etc.)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3072 =3: virtual length (counting tabs as anything
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3073 between 1 and |'tabstop'|, wide CJK as 2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3074 rather than 1, Arabic alif as zero when
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3075 immediately preceded by lam, one
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3076 otherwise, etc)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3077
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3078 *g:NetrwTopLvlMenu* This variable specifies the top level
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3079 menu name; by default, it's "Netrw.". If
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3080 you wish to change this, do so in your
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3081 .vimrc.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3082
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3083 NETRW BROWSING AND OPTION INCOMPATIBILITIES *netrw-incompatible* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3084
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3085 Netrw has been designed to handle user options by saving them, setting the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3086 options to something that's compatible with netrw's needs, and then restoring
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3087 them. However, the autochdir option: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3088 :set acd
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3089 is problematic. Autochdir sets the current directory to that containing the
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3090 file you edit; this apparently also applies to directories. In other words,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3091 autochdir sets the current directory to that containing the "file" (even if
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3092 that "file" is itself a directory).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3093
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
3094 NETRW SETTINGS WINDOW *netrw-settings-window* {{{2
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
3095
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
3096 With the NetrwSettings.vim plugin, >
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
3097 :NetrwSettings
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
3098 will bring up a window with the many variables that netrw uses for its
559
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
3099 settings. You may change any of their values; when you save the file, the
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
3100 settings therein will be used. One may also press "?" on any of the lines for
8ec588470508 updated for version 7.0159
vimboss
parents: 557
diff changeset
3101 help on what each of the variables do.
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
3102
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
3103 (also see: |netrw-browser-var| |netrw-protocol| |netrw-variables|)
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3104
482
6f8b578776ab updated for version 7.0131
vimboss
parents: 480
diff changeset
3105
9
4102fb4ea781 updated for version 7.0002
vimboss
parents: 7
diff changeset
3106 ==============================================================================
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3107 OBTAINING A FILE *netrw-obtain* *netrw-O* {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3108
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3109 If there are no marked files:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3110
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3111 When browsing a remote directory, one may obtain a file under the cursor
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3112 (ie. get a copy on your local machine, but not edit it) by pressing the O
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3113 key.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3114
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3115 If there are marked files:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3116
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3117 The marked files will be obtained (ie. a copy will be transferred to your
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3118 local machine, but not set up for editing).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3119
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3120 Only ftp and scp are supported for this operation (but since these two are
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3121 available for browsing, that shouldn't be a problem). The status bar will
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3122 then show, on its right hand side, a message like "Obtaining filename". The
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3123 statusline will be restored after the transfer is complete.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3124
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3125 Netrw can also "obtain" a file using the local browser. Netrw's display
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3126 of a directory is not necessarily the same as Vim's "current directory",
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3127 unless |g:netrw_keepdir| is set to 0 in the user's <.vimrc>. One may select
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3128 a file using the local browser (by putting the cursor on it) and pressing
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3129 "O" will then "obtain" the file; ie. copy it to Vim's current directory.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3130
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3131 Related topics:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3132 * To see what the current directory is, use |:pwd|
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3133 * To make the currently browsed directory the current directory, see
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3134 |netrw-cd|
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3135 * To automatically make the currently browsed directory the current
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3136 directory, see |g:netrw_keepdir|.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3137
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3138 *netrw-newfile* *netrw-createfile*
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3139 OPEN A NEW FILE IN NETRW'S CURRENT DIRECTORY *netrw-%* {{{2
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
3140
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3141 To open a new file in netrw's current directory, press "%". This map
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3142 will query the user for a new filename; an empty file by that name will
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3143 be placed in the netrw's current directory (ie. b:netrw_curdir).
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
3144
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
3145 Related topics: |netrw-d|
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
3146
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1621
diff changeset
3147
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3148 PREVIEW WINDOW *netrw-p* *netrw-preview* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3149
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3150 One may use a preview window by using the "p" key when the cursor is atop the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3151 desired filename to be previewed. The display will then split to show both
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3152 the browser (where the cursor will remain) and the file (see |:pedit|). By
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3153 default, the split will be taken horizontally; one may use vertical splitting
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3154 if one has set |g:netrw_preview| first.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3155
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3156 An interesting set of netrw settings is: >
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3157
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3158 let g:netrw_preview = 1
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3159 let g:netrw_liststyle = 3
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3160 let g:netrw_winsize = 30
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3161
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3162 These will:
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3163
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3164 1. Make vertical splitting the default for previewing files
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3165 2. Make the default listing style "tree"
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3166 3. When a vertical preview window is opened, the directory listing
3456
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
3167 will use only 30% of the columns available; the rest of the window
4dde9b516e72 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3312
diff changeset
3168 is used for the preview window.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3169
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3170 Related: if you like this idea, you may also find :Lexplore
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3171 (|netrw-:Lexplore|) or |g:netrw_chgwin| of interest
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3172
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
3173 Also see: |g:netrw_chgwin| |netrw-P| |'previewwindow'| |CTRL-W_z| |:pclose|
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3174
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3175
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3176 PREVIOUS WINDOW *netrw-P* *netrw-prvwin* {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3177
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
3178 To edit a file or directory under the cursor in the previously used (last
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
3179 accessed) window (see :he |CTRL-W_p|), press a "P". If there's only one
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
3180 window, then the one window will be horizontally split (by default).
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3181
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3182 If there's more than one window, the previous window will be re-used on
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3183 the selected file/directory. If the previous window's associated buffer
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3184 has been modified, and there's only one window with that buffer, then
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3185 the user will be asked if s/he wishes to save the buffer first (yes,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3186 no, or cancel).
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3187
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3188 Related Actions |netrw-cr| |netrw-o| |netrw-t| |netrw-v|
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
3189 Associated setting variables:
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
3190 |g:netrw_alto| control above/below splitting
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
3191 |g:netrw_altv| control right/left splitting
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
3192 |g:netrw_preview| control horizontal vs vertical splitting
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
3193 |g:netrw_winsize| control initial sizing
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
3194
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3195 Also see: |g:netrw_chgwin| |netrw-p|
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3196
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3197
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3198 REFRESHING THE LISTING *netrw-refresh* *netrw-ctrl-l* *netrw-ctrl_l* {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3199
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3200 To refresh either a local or remote directory listing, press ctrl-l (<c-l>) or
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3201 hit the <cr> when atop the ./ directory entry in the listing. One may also
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3202 refresh a local directory by using ":e .".
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3203
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3204
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3205 REVERSING SORTING ORDER *netrw-r* *netrw-reverse* {{{2
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3206
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3207 One may toggle between normal and reverse sorting order by pressing the
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3208 "r" key.
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3209
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3210 Related topics: |netrw-s|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3211 Associated setting variable: |g:netrw_sort_direction|
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3212
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3213
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3214 RENAMING FILES OR DIRECTORIES *netrw-move* *netrw-rename* *netrw-R* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3215
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3216 If there are no marked files: (see |netrw-mf|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3217
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3218 Renaming files and directories involves moving the cursor to the
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3219 file/directory to be moved (renamed) and pressing "R". You will then be
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3220 queried for what you want the file/directory to be renamed to. You may
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3221 select a range of lines with the "V" command (visual selection), and then
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3222 press "R"; you will be queried for each file as to what you want it
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3223 renamed to.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3224
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3225 If there are marked files: (see |netrw-mf|)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3226
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3227 Marked files will be renamed (moved). You will be queried as above in
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3228 order to specify where you want the file/directory to be moved.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3229
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3230 If you answer a renaming query with a "s/frompattern/topattern/", then
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3231 subsequent files on the marked file list will be renamed by taking each
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3232 name, applying that substitute, and renaming each file to the result.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3233 As an example : >
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3234
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3235 mr [query: reply with *.c]
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3236 R [query: reply with s/^\(.*\)\.c$/\1.cpp/]
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3237 <
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3238 This example will mark all *.c files and then rename them to *.cpp
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
3239 files. Netrw will protect you from overwriting local files without
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
3240 confirmation, but not remote ones.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3241
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3242 The ctrl-X character has special meaning for renaming files: >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3243
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3244 <c-x> : a single ctrl-x tells netrw to ignore the portion of the response
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3245 lying between the last '/' and the ctrl-x.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3246
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3247 <c-x><c-x> : a pair of contiguous ctrl-x's tells netrw to ignore any
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3248 portion of the string preceding the double ctrl-x's.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3249 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3250 WARNING:~
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3251
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3252 Note that moving files is a dangerous operation; copies are safer. That's
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3253 because a "move" for remote files is actually a copy + delete -- and if
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3254 the copy fails and the delete succeeds you may lose the file.
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3255 Use at your own risk.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3256
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3257 The *g:netrw_rename_cmd* variable is used to implement remote renaming. By
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3258 default its value is: >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3259
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3260 ssh HOSTNAME mv
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3261 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3262 One may rename a block of files and directories by selecting them with
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3263 V (|linewise-visual|) when using thin style.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3264
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3265 See |cmdline-editing| for more on how to edit the command line; in particular,
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3266 you'll find <ctrl-f> (initiates cmdline window editing) and <ctrl-c> (uses the
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3267 command line under the cursor) useful in conjunction with the R command.
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3268
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3269
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3270 SELECTING SORTING STYLE *netrw-s* *netrw-sort* {{{2
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3271
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3272 One may select the sorting style by name, time, or (file) size. The "s" map
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3273 allows one to circulate amongst the three choices; the directory listing will
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3274 automatically be refreshed to reflect the selected style.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3275
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3276 Related topics: |netrw-r| |netrw-S|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3277 Associated setting variables: |g:netrw_sort_by| |g:netrw_sort_sequence|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3278
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3279
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3280 SETTING EDITING WINDOW *netrw-editwindow* *netrw-C* *netrw-:NetrwC* {{{2
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3281
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3282 One may select a netrw window for editing with the "C" mapping, using the
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3283 :NetrwC [win#] command, or by setting |g:netrw_chgwin| to the selected window
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3284 number. Subsequent selection of a file to edit (|netrw-cr|) will use that
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3285 window.
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3286
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3287 * C : by itself, will select the current window holding a netrw buffer
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3288 for subsequent editing via |netrw-cr|. The C mapping is only available
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3289 while in netrw buffers.
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3290
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3291 * [count]C : the count will be used as the window number to be used
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3292 for subsequent editing via |netrw-cr|.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3293
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3294 * :NetrwC will set |g:netrw_chgwin| to the current window
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3295
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3296 * :NetrwC win# will set |g:netrw_chgwin| to the specified window
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3297 number
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3298
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3299 Using >
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3300 let g:netrw_chgwin= -1
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3301 will restore the default editing behavior
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3302 (ie. subsequent editing will use the current window).
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3303
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
3304 Related topics: |netrw-cr| |g:netrw_browse_split|
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3305 Associated setting variables: |g:netrw_chgwin|
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3306
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3307
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3308 SHRINKING OR EXPANDING A NETRW OR LEXPLORE WINDOW *netrw-c-tab* {{{2
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3309
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3310 The <c-tab> key will toggle a netrw or |:Lexplore| window's width,
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3311 but only if |g:netrw_usetab| exists and is non-zero (and, of course,
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3312 only if your terminal supports differentiating <c-tab> from a plain
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3313 <tab>).
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3314
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3315 * If the current window is a netrw window, toggle its width
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3316 (between |g:netrw_wiw| and its original width)
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3317
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3318 * Else if there is a |:Lexplore| window in the current tab, toggle
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3319 its width
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3320
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3321 * Else bring up a |:Lexplore| window
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3322
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3323 If |g:netrw_usetab| exists and is zero, or if there is a pre-existing mapping
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
3324 for <c-tab>, then the <c-tab> will not be mapped. One may map something other
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3325 than a <c-tab>, too: (but you'll still need to have had |g:netrw_usetab| set). >
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3326
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3327 nmap <unique> (whatever) <Plug>NetrwShrink
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3328 <
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3329 Related topics: |:Lexplore|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3330 Associated setting variable: |g:netrw_usetab|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3331
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3332
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3333 USER SPECIFIED MAPS *netrw-usermaps* {{{1
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3334
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3335 One may make customized user maps. Specify a variable, |g:Netrw_UserMaps|,
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3336 to hold a |List| of lists of keymap strings and function names: >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3337
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3338 [["keymap-sequence","ExampleUserMapFunc"],...]
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3339 <
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3340 When netrw is setting up maps for a netrw buffer, if |g:Netrw_UserMaps|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3341 exists, then the internal function netrw#UserMaps(islocal) is called.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3342 This function goes through all the entries in the |g:Netrw_UserMaps| list:
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3343
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3344 * sets up maps: >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3345 nno <buffer> <silent> KEYMAP-SEQUENCE
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3346 :call s:UserMaps(islocal,"ExampleUserMapFunc")
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3347 < * refreshes if result from that function call is the string
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3348 "refresh"
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3349 * if the result string is not "", then that string will be
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3350 executed (:exe result)
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3351 * if the result is a List, then the above two actions on results
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3352 will be taken for every string in the result List
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3353
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3354 The user function is passed one argument; it resembles >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3355
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3356 fun! ExampleUserMapFunc(islocal)
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3357 <
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3358 where a:islocal is 1 if its a local-directory system call or 0 when
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3359 remote-directory system call.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3360
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3361 *netrw-call* *netrw-expose* *netrw-modify*
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3362 Use netrw#Expose("varname") to access netrw-internal (script-local)
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3363 variables.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3364 Use netrw#Modify("varname",newvalue) to change netrw-internal variables.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3365 Use netrw#Call("funcname"[,args]) to call a netrw-internal function with
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3366 specified arguments.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3367
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3368 Example: Get a copy of netrw's marked file list: >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3369
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3370 let netrwmarkfilelist= netrw#Expose("netrwmarkfilelist")
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3371 <
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3372 Example: Modify the value of netrw's marked file list: >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3373
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3374 call netrw#Modify("netrwmarkfilelist",[])
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3375 <
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3376 Example: Clear netrw's marked file list via a mapping on gu >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3377 " ExampleUserMap: {{{2
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3378 fun! ExampleUserMap(islocal)
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3379 call netrw#Modify("netrwmarkfilelist",[])
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3380 call netrw#Modify('netrwmarkfilemtch_{bufnr("%")}',"")
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3381 let retval= ["refresh"]
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3382 return retval
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3383 endfun
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3384 let g:Netrw_UserMaps= [["gu","ExampleUserMap"]]
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3385 <
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3386
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3387 10. Problems and Fixes *netrw-problems* {{{1
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3388
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3389 (This section is likely to grow as I get feedback)
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3390 (also see |netrw-debug|)
477
f8b75b8f1988 updated for version 7.0128
vimboss
parents: 466
diff changeset
3391 *netrw-p1*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3392 P1. I use windows 95, and my ftp dumps four blank lines at the {{{2
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3393 end of every read.
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3394
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3395 See |netrw-fixup|, and put the following into your
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3396 <.vimrc> file:
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3397
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3398 let g:netrw_win95ftp= 1
466
7a01bd1ac566 updated for version 7.0125
vimboss
parents: 464
diff changeset
3399
477
f8b75b8f1988 updated for version 7.0128
vimboss
parents: 466
diff changeset
3400 *netrw-p2*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3401 P2. I use Windows, and my network browsing with ftp doesn't sort by {{{2
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3402 time or size! -or- The remote system is a Windows server; why
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3403 don't I get sorts by time or size?
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3404
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3405 Windows' ftp has a minimal support for ls (ie. it doesn't
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3406 accept sorting options). It doesn't support the -F which
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3407 gives an explanatory character (ABC/ for "ABC is a directory").
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3408 Netrw then uses "dir" to get both its thin and long listings.
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3409 If you think your ftp does support a full-up ls, put the
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3410 following into your <.vimrc>: >
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3411
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3412 let g:netrw_ftp_list_cmd = "ls -lF"
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3413 let g:netrw_ftp_timelist_cmd= "ls -tlF"
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3414 let g:netrw_ftp_sizelist_cmd= "ls -slF"
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3415 <
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3416 Alternatively, if you have cygwin on your Windows box, put
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3417 into your <.vimrc>: >
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3418
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3419 let g:netrw_cygwin= 1
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3420 <
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3421 This problem also occurs when the remote system is Windows.
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3422 In this situation, the various g:netrw_ftp_[time|size]list_cmds
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3423 are as shown above, but the remote system will not correctly
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3424 modify its listing behavior.
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3425
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3426
477
f8b75b8f1988 updated for version 7.0128
vimboss
parents: 466
diff changeset
3427 *netrw-p3*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3428 P3. I tried rcp://user@host/ (or protocol other than ftp) and netrw {{{2
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3429 used ssh! That wasn't what I asked for...
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3430
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3431 Netrw has two methods for browsing remote directories: ssh
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3432 and ftp. Unless you specify ftp specifically, ssh is used.
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3433 When it comes time to do download a file (not just a directory
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3434 listing), netrw will use the given protocol to do so.
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3435
477
f8b75b8f1988 updated for version 7.0128
vimboss
parents: 466
diff changeset
3436 *netrw-p4*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3437 P4. I would like long listings to be the default. {{{2
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3438
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3439 Put the following statement into your |.vimrc|: >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3440
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3441 let g:netrw_liststyle= 1
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3442 <
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3443 Check out |netrw-browser-var| for more customizations that
26
404aac550f35 updated for version 7.0017
vimboss
parents: 24
diff changeset
3444 you can set.
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3445
477
f8b75b8f1988 updated for version 7.0128
vimboss
parents: 466
diff changeset
3446 *netrw-p5*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3447 P5. My times come up oddly in local browsing {{{2
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3448
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3449 Does your system's strftime() accept the "%c" to yield dates
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3450 such as "Sun Apr 27 11:49:23 1997"? If not, do a
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3451 "man strftime" and find out what option should be used. Then
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
3452 put it into your |.vimrc|: >
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3453
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3454 let g:netrw_timefmt= "%X" (where X is the option)
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3455 <
477
f8b75b8f1988 updated for version 7.0128
vimboss
parents: 466
diff changeset
3456 *netrw-p6*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3457 P6. I want my current directory to track my browsing. {{{2
26
404aac550f35 updated for version 7.0017
vimboss
parents: 24
diff changeset
3458 How do I do that?
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3459
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3460 Put the following line in your |.vimrc|:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3461 >
794
f19994020dad updated for version 7.0231
vimboss
parents: 766
diff changeset
3462 let g:netrw_keepdir= 0
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3463 <
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3464 *netrw-p7*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3465 P7. I use Chinese (or other non-ascii) characters in my filenames, {{{2
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3466 and netrw (Explore, Sexplore, Hexplore, etc) doesn't display them!
466
7a01bd1ac566 updated for version 7.0125
vimboss
parents: 464
diff changeset
3467
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3468 (taken from an answer provided by Wu Yongwei on the vim
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3469 mailing list)
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3470 I now see the problem. Your code page is not 936, right? Vim
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3471 seems only able to open files with names that are valid in the
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3472 current code page, as are many other applications that do not
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3473 use the Unicode version of Windows APIs. This is an OS-related
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3474 issue. You should not have such problems when the system
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3475 locale uses UTF-8, such as modern Linux distros.
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3476
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3477 (...it is one more reason to recommend that people use utf-8!)
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3478
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3479 *netrw-p8*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3480 P8. I'm getting "ssh is not executable on your system" -- what do I {{{2
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3481 do?
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3482
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3483 (Dudley Fox) Most people I know use putty for windows ssh. It
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3484 is a free ssh/telnet application. You can read more about it
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3485 here:
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3486
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3487 http://www.chiark.greenend.org.uk/~sgtatham/putty/ Also:
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3488
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3489 (Marlin Unruh) This program also works for me. It's a single
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3490 executable, so he/she can copy it into the Windows\System32
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3491 folder and create a shortcut to it.
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3492
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3493 (Dudley Fox) You might also wish to consider plink, as it
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3494 sounds most similar to what you are looking for. plink is an
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3495 application in the putty suite.
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3496
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3497 http://the.earth.li/~sgtatham/putty/0.58/htmldoc/Chapter7.html#plink
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3498
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3499 (Vissale Neang) Maybe you can try OpenSSH for windows, which
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3500 can be obtained from:
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3501
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3502 http://sshwindows.sourceforge.net/
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3503
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3504 It doesn't need the full Cygwin package.
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3505
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3506 (Antoine Mechelynck) For individual Unix-like programs needed
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3507 for work in a native-Windows environment, I recommend getting
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3508 them from the GnuWin32 project on sourceforge if it has them:
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3509
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3510 http://gnuwin32.sourceforge.net/
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3511
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3512 Unlike Cygwin, which sets up a Unix-like virtual machine on
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3513 top of Windows, GnuWin32 is a rewrite of Unix utilities with
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3514 Windows system calls, and its programs works quite well in the
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3515 cmd.exe "Dos box".
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3516
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3517 (dave) Download WinSCP and use that to connect to the server.
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3518 In Preferences > Editors, set gvim as your editor:
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3519
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3520 - Click "Add..."
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3521 - Set External Editor (adjust path as needed, include
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3522 the quotes and !.! at the end):
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19099
diff changeset
3523 "c:\Program Files\Vim\vim82\gvim.exe" !.!
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3524 - Check that the filetype in the box below is
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3525 {asterisk}.{asterisk} (all files), or whatever types
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3526 you want (cec: change {asterisk} to * ; I had to
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3527 write it that way because otherwise the helptags
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3528 system thinks it's a tag)
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3529 - Make sure it's at the top of the listbox (click it,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3530 then click "Up" if it's not)
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3531 If using the Norton Commander style, you just have to hit <F4>
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3532 to edit a file in a local copy of gvim.
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3533
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3534 (Vit Gottwald) How to generate public/private key and save
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3535 public key it on server: >
2420
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
3536 http://www.chiark.greenend.org.uk/~sgtatham/putty/0.60/htmldoc/Chapter8.html#pubkey-gettingready
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
3537 (8.3 Getting ready for public key authentication)
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3538 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3539 How to use a private key with 'pscp': >
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3540
2420
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
3541 http://www.chiark.greenend.org.uk/~sgtatham/putty/0.60/htmldoc/Chapter5.html
6de9efd58dc0 Updated runtime files. New netrw plugin version.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
3542 (5.2.4 Using public key authentication with PSCP)
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3543 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3544 (Ben Schmidt) I find the ssh included with cwRsync is
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3545 brilliant, and install cwRsync or cwRsyncServer on most
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3546 Windows systems I come across these days. I guess COPSSH,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3547 packed by the same person, is probably even better for use as
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3548 just ssh on Windows, and probably includes sftp, etc. which I
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3549 suspect the cwRsync doesn't, though it might
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3550
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3551 (cec) To make proper use of these suggestions above, you will
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3552 need to modify the following user-settable variables in your
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3553 .vimrc:
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3554
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3555 |g:netrw_ssh_cmd| |g:netrw_list_cmd| |g:netrw_mkdir_cmd|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3556 |g:netrw_rm_cmd| |g:netrw_rmdir_cmd| |g:netrw_rmf_cmd|
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3557
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3558 The first one (|g:netrw_ssh_cmd|) is the most important; most
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3559 of the others will use the string in g:netrw_ssh_cmd by
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3560 default.
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3561
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3562 *netrw-p9* *netrw-ml_get*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3563 P9. I'm browsing, changing directory, and bang! ml_get errors {{{2
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3564 appear and I have to kill vim. Any way around this?
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3565
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3566 Normally netrw attempts to avoid writing swapfiles for
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3567 its temporary directory buffers. However, on some systems
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3568 this attempt appears to be causing ml_get errors to
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3569 appear. Please try setting |g:netrw_use_noswf| to 0
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3570 in your <.vimrc>: >
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3571 let g:netrw_use_noswf= 0
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3572 <
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3573 *netrw-p10*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3574 P10. I'm being pestered with "[something] is a directory" and {{{2
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3575 "Press ENTER or type command to continue" prompts...
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3576
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3577 The "[something] is a directory" prompt is issued by Vim,
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3578 not by netrw, and there appears to be no way to work around
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3579 it. Coupled with the default cmdheight of 1, this message
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3580 causes the "Press ENTER..." prompt. So: read |hit-enter|;
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3581 I also suggest that you set your |'cmdheight'| to 2 (or more) in
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3582 your <.vimrc> file.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3583
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3584 *netrw-p11*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3585 P11. I want to have two windows; a thin one on the left and my {{{2
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3586 editing window on the right. How may I accomplish this?
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3587
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3588 You probably want netrw running as in a side window. If so, you
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3589 will likely find that ":[N]Lexplore" does what you want. The
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3590 optional "[N]" allows you to select the quantity of columns you
7188
3ba0f29ba1d1 commit https://github.com/vim/vim/commit/d7464be9747fcaa8e6210e1f00a3882932df76e2
Christian Brabandt <cb@256bit.org>
parents: 7183
diff changeset
3591 wish the |:Lexplore|r window to start with (see |g:netrw_winsize|
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3592 for how this parameter works).
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3593
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3594 Previous solution:
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3595
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3596 * Put the following line in your <.vimrc>:
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3597 let g:netrw_altv = 1
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3598 * Edit the current directory: :e .
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3599 * Select some file, press v
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3600 * Resize the windows as you wish (see |CTRL-W_<| and
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3601 |CTRL-W_>|). If you're using gvim, you can drag
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3602 the separating bar with your mouse.
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3603 * When you want a new file, use ctrl-w h to go back to the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3604 netrw browser, select a file, then press P (see |CTRL-W_h|
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3605 and |netrw-P|). If you're using gvim, you can press
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3606 <leftmouse> in the browser window and then press the
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3607 <middlemouse> to select the file.
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3608
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3609
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3610 *netrw-p12*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3611 P12. My directory isn't sorting correctly, or unwanted letters are {{{2
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3612 appearing in the listed filenames, or things aren't lining
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3613 up properly in the wide listing, ...
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3614
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3615 This may be due to an encoding problem. I myself usually use
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3616 utf-8, but really only use ascii (ie. bytes from 32-126).
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3617 Multibyte encodings use two (or more) bytes per character.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3618 You may need to change |g:netrw_sepchr| and/or |g:netrw_xstrlen|.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3619
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3620 *netrw-p13*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3621 P13. I'm a Windows + putty + ssh user, and when I attempt to {{{2
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3622 browse, the directories are missing trailing "/"s so netrw treats
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3623 them as file transfers instead of as attempts to browse
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3624 subdirectories. How may I fix this?
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3625
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3626 (mikeyao) If you want to use vim via ssh and putty under Windows,
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3627 try combining the use of pscp/psftp with plink. pscp/psftp will
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3628 be used to connect and plink will be used to execute commands on
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3629 the server, for example: list files and directory using 'ls'.
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3630
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3631 These are the settings I use to do this:
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3632 >
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3633 " list files, it's the key setting, if you haven't set,
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3634 " you will get a blank buffer
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3635 let g:netrw_list_cmd = "plink HOSTNAME ls -Fa"
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3636 " if you haven't add putty directory in system path, you should
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3637 " specify scp/sftp command. For examples:
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3638 "let g:netrw_sftp_cmd = "d:\\dev\\putty\\PSFTP.exe"
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3639 "let g:netrw_scp_cmd = "d:\\dev\\putty\\PSCP.exe"
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3640 <
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3641 *netrw-p14*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3642 P14. I would like to speed up writes using Nwrite and scp/ssh {{{2
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3643 style connections. How? (Thomer M. Gil)
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3644
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3645 Try using ssh's ControlMaster and ControlPath (see the ssh_config
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3646 man page) to share multiple ssh connections over a single network
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3647 connection. That cuts out the cryptographic handshake on each
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3648 file write, sometimes speeding it up by an order of magnitude.
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3649 (see http://thomer.com/howtos/netrw_ssh.html)
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3650 (included by permission)
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3651
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3652 Add the following to your ~/.ssh/config: >
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3653
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3654 # you change "*" to the hostname you care about
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3655 Host *
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3656 ControlMaster auto
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3657 ControlPath /tmp/%r@%h:%p
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3658
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3659 < Then create an ssh connection to the host and leave it running: >
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3660
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3661 ssh -N host.domain.com
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3662
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3663 < Now remotely open a file with Vim's Netrw and enjoy the
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3664 zippiness: >
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3665
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3666 vim scp://host.domain.com//home/user/.bashrc
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3667 <
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3668 *netrw-p15*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3669 P15. How may I use a double-click instead of netrw's usual single {{{2
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3670 click to open a file or directory? (Ben Fritz)
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3671
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3672 First, disable netrw's mapping with >
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3673 let g:netrw_mousemaps= 0
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3674 < and then create a netrw buffer only mapping in
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3675 $HOME/.vim/after/ftplugin/netrw.vim: >
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3676 nmap <buffer> <2-leftmouse> <CR>
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3677 < Note that setting g:netrw_mousemaps to zero will turn off
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3678 all netrw's mouse mappings, not just the <leftmouse> one.
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2751
diff changeset
3679 (see |g:netrw_mousemaps|)
2152
b9e314fe473f Updated runtime files.
Bram Moolenaar <bram@zimbu.org>
parents: 2033
diff changeset
3680
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3681 *netrw-p16*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3682 P16. When editing remote files (ex. :e ftp://hostname/path/file), {{{2
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3683 under Windows I get an |E303| message complaining that its unable
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3684 to open a swap file.
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3685
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3686 (romainl) It looks like you are starting Vim from a protected
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3687 directory. Start netrw from your $HOME or other writable
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3688 directory.
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
3689
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3690 *netrw-p17*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3691 P17. Netrw is closing buffers on its own. {{{2
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3692 What steps will reproduce the problem?
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3693 1. :Explore, navigate directories, open a file
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3694 2. :Explore, open another file
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3695 3. Buffer opened in step 1 will be closed. o
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3696 What is the expected output? What do you see instead?
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3697 I expect both buffers to exist, but only the last one does.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3698
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3699 (Lance) Problem is caused by "set autochdir" in .vimrc.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3700 (drchip) I am able to duplicate this problem with |'acd'| set.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3701 It appears that the buffers are not exactly closed;
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3702 a ":ls!" will show them (although ":ls" does not).
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3703
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3704 *netrw-P18*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3705 P18. How to locally edit a file that's only available via {{{2
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3706 another server accessible via ssh?
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3707 See http://stackoverflow.com/questions/12469645/
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3708 "Using Vim to Remotely Edit A File on ServerB Only
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3709 Accessible From ServerA"
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3710
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3711 *netrw-P19*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3712 P19. How do I get numbering on in directory listings? {{{2
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3713 With |g:netrw_bufsettings|, you can control netrw's buffer
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3714 settings; try putting >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3715 let g:netrw_bufsettings="noma nomod nu nobl nowrap ro nornu"
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3716 < in your .vimrc. If you'd like to have relative numbering
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3717 instead, try >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3718 let g:netrw_bufsettings="noma nomod nonu nobl nowrap ro rnu"
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3719 <
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3720 *netrw-P20*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3721 P20. How may I have gvim start up showing a directory listing? {{{2
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3722 Try putting the following code snippet into your .vimrc: >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3723 augroup VimStartup
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3724 au!
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3725 au VimEnter * if expand("%") == "" && argc() == 0 &&
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3726 \ (v:servername =~ 'GVIM\d*' || v:servername == "")
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3727 \ | e . | endif
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3728 augroup END
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3729 < You may use Lexplore instead of "e" if you're so inclined.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3730 This snippet assumes that you have client-server enabled
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3731 (ie. a "huge" vim version).
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3732
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3733 *netrw-P21*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3734 P21. I've made a directory (or file) with an accented character, {{{2
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3735 but netrw isn't letting me enter that directory/read that file:
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3736
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3737 Its likely that the shell or o/s is using a different encoding
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3738 than you have vim (netrw) using. A patch to vim supporting
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3739 "systemencoding" may address this issue in the future; for
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3740 now, just have netrw use the proper encoding. For example: >
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3741
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3742 au FileType netrw set enc=latin1
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3743 <
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3744 *netrw-P22*
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3745 P22. I get an error message when I try to copy or move a file: {{{2
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3746
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3747 **error** (netrw) tried using g:netrw_localcopycmd<cp>; it doesn't work!
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3748
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3749 What's wrong?
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3750
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3751 Netrw uses several system level commands to do things (see
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3752
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3753 |g:netrw_localcopycmd|, |g:netrw_localmovecmd|,
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3754 |g:netrw_localrmdir|, |g:netrw_mkdir_cmd|).
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3755
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3756 You may need to adjust the default commands for one or more of
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3757 these commands by setting them properly in your .vimrc. Another
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3758 source of difficulty is that these commands use vim's local
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3759 directory, which may not be the same as the browsing directory
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3760 shown by netrw (see |g:netrw_keepdir|).
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3761
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
3762
24
8ff7fd162d3c updated for version 7.0016
vimboss
parents: 22
diff changeset
3763 ==============================================================================
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3764 11. Debugging Netrw Itself *netrw-debug* {{{1
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3765
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3766 Step 1: check that the problem you've encountered hasn't already been resolved
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3767 by obtaining a copy of the latest (often developmental) netrw at:
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3768
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3769 http://www.drchip.org/astronaut/vim/index.html#NETRW
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3770
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3771 The <netrw.vim> script is typically installed on systems as something like:
477
f8b75b8f1988 updated for version 7.0128
vimboss
parents: 466
diff changeset
3772 >
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19099
diff changeset
3773 /usr/local/share/vim/vim8x/plugin/netrwPlugin.vim
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19099
diff changeset
3774 /usr/local/share/vim/vim8x/autoload/netrw.vim
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3775 (see output of :echo &rtp)
477
f8b75b8f1988 updated for version 7.0128
vimboss
parents: 466
diff changeset
3776 <
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3777 which is loaded automatically at startup (assuming :set nocp). If you
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3778 installed a new netrw, then it will be located at >
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3779
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3780 $HOME/.vim/plugin/netrwPlugin.vim
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3781 $HOME/.vim/autoload/netrw.vim
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3782 <
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3783 Step 2: assuming that you've installed the latest version of netrw,
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3784 check that your problem is really due to netrw. Create a file
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3785 called netrw.vimrc with the following contents: >
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3786
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3787 set nocp
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3788 so $HOME/.vim/plugin/netrwPlugin.vim
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3789 <
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3790 Then run netrw as follows: >
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3791
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
3792 vim -u netrw.vimrc --noplugins -i NONE [some path here]
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3793 <
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3794 Perform whatever netrw commands you need to, and check that the problem is
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3795 still present. This procedure sidesteps any issues due to personal .vimrc
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
3796 settings, .viminfo file, and other plugins. If the problem does not appear,
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
3797 then you need to determine which setting in your .vimrc is causing the
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
3798 conflict with netrw or which plugin(s) is/are involved.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3799
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3800 Step 3: If the problem still is present, then get a debugging trace from
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3801 netrw:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3802
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3803 1. Get the <Decho.vim> script, available as:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3804
3920
c53344bacabf Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3456
diff changeset
3805 http://www.drchip.org/astronaut/vim/index.html#DECHO
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3806 or
534
c6296b0ad9ea updated for version 7.0151
vimboss
parents: 532
diff changeset
3807 http://vim.sourceforge.net/scripts/script.php?script_id=120
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3808
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3809 Decho.vim is provided as a "vimball"; see |vimball-intro|. You
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3810 should edit the Decho.vba.gz file and source it in: >
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3811
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3812 vim Decho.vba.gz
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3813 :so %
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3814 :q
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3815 <
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3816 2. To turn on debug tracing in netrw, then edit the <netrw.vim>
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3817 file by typing: >
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
3818
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
3819 vim netrw.vim
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3820 :DechoOn
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
3821 :wq
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3822 <
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3823 To restore to normal non-debugging behavior, re-edit <netrw.vim>
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3824 and type >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3825
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
3826 vim netrw.vim
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
3827 :DechoOff
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
3828 :wq
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3829 <
22
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
3830 This command, provided by <Decho.vim>, will comment out all
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
3831 Decho-debugging statements (Dfunc(), Dret(), Decho(), Dredir()).
cc049b00ee70 updated for version 7.0014
vimboss
parents: 21
diff changeset
3832
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3833 3. Then bring up vim and attempt to evoke the problem by doing a
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3834 transfer or doing some browsing. A set of messages should appear
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
3835 concerning the steps that <netrw.vim> took in attempting to
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3836 read/write your file over the network in a separate tab or
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3837 server vim window.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3838
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3839 Change the netrw.vimrc file to include the Decho plugin: >
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3840
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3841 set nocp
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3842 so $HOME/.vim/plugin/Decho.vim
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3843 so $HOME/.vim/plugin/netrwPlugin.vim
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3844 <
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3845 You should continue to run vim with >
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3846
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3847 vim -u netrw.vimrc --noplugins -i NONE [some path here]
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3848 <
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3849 to avoid entanglements with options and other plugins.
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3850
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3851 To save the file: under linux, the output will be in a separate
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3852 remote server window; in it, just save the file with >
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3853
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3854 :w! DBG
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3855
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3856 < Under a vim that doesn't support clientserver, your debugging
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3857 output will appear in another tab: >
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
3858
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
3859 :tabnext
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3860 :set bt=
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3861 :w! DBG
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3862 <
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3863 Furthermore, it'd be helpful if you would type >
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3864
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3865 :Dsep <command>
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3866
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3867 < where <command> is the command you're about to type next,
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3868 thereby making it easier to associate which part of the
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3869 debugging trace is due to which command.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3870
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
3871 Please send that information to <netrw.vim>'s maintainer along
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
3872 with the o/s you're using and the vim version that you're using
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
3873 (see |:version|) (remove the embedded NOSPAM first) >
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3874
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
3875 NcampObell@SdrPchip.AorgM-NOSPAM
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3876 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3877 ==============================================================================
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
3878 12. History *netrw-history* {{{1
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3879
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3880 v170: Mar 11, 2020 * (reported by Reiner Herrmann) netrw+tree
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3881 would not hide with the ^\..* pattern
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3882 correctly.
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3883 * (Marcin Szamotulski) NetrwOptionRestore
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3884 did not restore options correctly that
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3885 had a single quote in the option string.
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3886 Apr 13, 2020 * implemented error handling via popup
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3887 windows (see |popup_beval()|)
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3888 Apr 30, 2020 * (reported by Manatsu Takahashi) while
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3889 using Lexplore, a modified file could
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3890 be overwritten. Sol'n: will not overwrite,
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3891 but will emit an |E37| (although one cannot
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3892 add an ! to override)
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3893 Jun 07, 2020 * (reported by Jo Totland) repeatedly invoking
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3894 :Lexplore and quitting it left unused
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3895 hidden buffers. Netrw will now set netrw
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
3896 buffers created by :Lexplore to |bh|=wipe.
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
3897 v169: Dec 20, 2019 * (reported by amkarthik) that netrw's x
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
3898 (|netrw-x|) would throw an error when
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
3899 attempting to open a local directory.
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
3900 v168: Dec 12, 2019 * scp timeout error message not reported,
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
3901 hopefully now fixed (Shane Xb Qian)
18750
82a28df1e2d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
3902 v167: Nov 29, 2019 * netrw does a save&restore on @* and @+.
82a28df1e2d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
3903 That causes problems with the clipboard.
82a28df1e2d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
3904 Now restores occurs only if @* or @+ have
82a28df1e2d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
3905 been changed.
82a28df1e2d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
3906 * netrw will change @* or @+ less often.
82a28df1e2d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
3907 Never if I happen to have caught all the
82a28df1e2d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
3908 operations that modify the unnamed
82a28df1e2d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
3909 register (which also writes @*).
82a28df1e2d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
3910 * Modified hiding behavior so that "s"
82a28df1e2d5 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18639
diff changeset
3911 will not ignore hiding.
18594
e9a47bcf7b94 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
3912 v166: Nov 06, 2019 * Removed a space from a nmap for "-"
e9a47bcf7b94 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
3913 * Numerous debugging statement changes
17433
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3914 v163: Dec 05, 2017 * (Cristi Balan) reported that a setting ('sel')
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3915 was left changed
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3916 * (Holger Mitschke) reported a problem with
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3917 saving and restoring history. Fixed.
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3918 * Hopefully I fixed a nasty bug that caused a
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3919 file rename to wipe out a buffer that it
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3920 should not have wiped out.
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3921 * (Holger Mitschke) amended this help file
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3922 with additional |g:netrw_special_syntax|
ca8e754bdd53 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
3923 items
18594
e9a47bcf7b94 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
3924 * Prioritized wget over curl for
e9a47bcf7b94 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
3925 g:netrw_http_cmd
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3926 v162: Sep 19, 2016 * (haya14busa) pointed out two syntax errors
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3927 with a patch; these are now fixed.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3928 Oct 26, 2016 * I started using mate-terminal and found that
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3929 x and gx (|netrw-x| and |netrw-gx|) were no
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3930 longer working. Fixed (using atril when
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3931 $DESKTOP_SESSION is "mate").
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3932 Nov 04, 2016 * (Martin Vuille) pointed out that @+ was
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3933 being restored with keepregstar rather than
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3934 keepregplus.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3935 Nov 09, 2016 * Broke apart the command from the options,
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3936 mostly for Windows. Introduced new netrw
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3937 settings: |g:netrw_localcopycmdopt|
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3938 |g:netrw_localcopydircmdopt| |g:netrw_localmkdiropt|
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3939 |g:netrw_localmovecmdopt| |g:netrw_localrmdiropt|
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3940 Nov 21, 2016 * (mattn) provided a patch for preview; swapped
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3941 winwidth() with winheight()
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3942 Nov 22, 2016 * (glacambre) reported that files containing
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3943 spaces weren't being obtained properly via
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3944 scp. Fix: apparently using single quotes
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3945 such as with 'file name' wasn't enough; the
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3946 spaces inside the quotes also had to be
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3947 escaped (ie. 'file\ name').
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3948 * Also fixed obtain (|netrw-O|) to be able to
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3949 obtain files with spaces in their names
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3950 Dec 20, 2016 * (xc1427) Reported that using "I" (|netrw-I|)
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3951 when atop "Hiding" in the banner also caused
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3952 the active-banner hiding control to occur
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3953 Jan 03, 2017 * (Enno Nagel) reported that attempting to
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3954 apply netrw to a directory that was without
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3955 read permission caused a syntax error.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3956 Jan 13, 2017 * (Ingo Karkat) provided a patch which makes
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3957 using netrw#Call() better. Now returns
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3958 value of internal routines return, for example.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3959 Jan 13, 2017 * (Ingo Karkat) changed netrw#FileUrlRead to
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3960 use |:edit| instead of |:read|. I also
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3961 changed the routine name to netrw#FileUrlEdit.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3962 Jan 16, 2017 * (Sayem) reported a problem where :Lexplore
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3963 could generate a new listing buffer and
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3964 window instead of toggling the netrw display.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3965 Unfortunately, the directions for eliciting
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3966 the problem weren't complete, so I may or
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3967 may not have fixed that issue.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3968 Feb 06, 2017 * Implemented cb and cB. Changed "c" to "cd".
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3969 (see |netrw-cb|, |netrw-cB|, and |netrw-cd|)
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3970 Mar 21, 2017 * previously, netrw would specify (safe) settings
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3971 even when the setting was already safe for
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3972 netrw. Netrw now attempts to leave such
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3973 already-netrw-safe settings alone.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3974 (affects s:NetrwOptionRestore() and
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3975 s:NetrwSafeOptions(); also introduced
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3976 s:NetrwRestoreSetting())
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3977 Jun 26, 2017 * (Christian Brabandt) provided a patch to
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3978 allow curl to follow redirects (ie. -L
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3979 option)
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3980 Jun 26, 2017 * (Callum Howard) reported a problem with
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3981 :Lexpore not removing the Lexplore window
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3982 after a change-directory
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3983 Aug 30, 2017 * (Ingo Karkat) one cannot switch to the
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3984 previously edited file (e.g. with CTRL-^)
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3985 after editing a file:// URL. Patch to
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3986 have a "keepalt" included.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3987 Oct 17, 2017 * (Adam Faryna) reported that gn (|netrw-gn|)
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3988 did not work on directories in the current
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3989 tree
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3990 v157: Apr 20, 2016 * (Nicola) had set up a "nmap <expr> ..." with
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3991 a function that returned a 0 while silently
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3992 invoking a shell command. The shell command
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3993 activated a ShellCmdPost event which in turn
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3994 called s:LocalBrowseRefresh(). That looks
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3995 over all netrw buffers for changes needing
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3996 refreshes. However, inside a |:map-<expr>|,
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3997 tab and window changes are disallowed. Fixed.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3998 (affects netrw's s:LocalBrowseRefresh())
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
3999 * |g:netrw_localrmdir| not used any more, but
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4000 the relevant patch that causes |delete()| to
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4001 take over was #1107 (not #1109).
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4002 * |expand()| is now used on |g:netrw_home|;
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4003 consequently, g:netrw_home may now use
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4004 environment variables
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4005 * s:NetrwLeftmouse and s:NetrwCLeftmouse will
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4006 return without doing anything if invoked
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4007 when inside a non-netrw window
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4008 Jun 15, 2016 * gx now calls netrw#GX() which returns
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4009 the word under the cursor. The new
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4010 wrinkle: if one is in a netrw buffer,
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4011 then netrw's s:NetrwGetWord().
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4012 Jun 22, 2016 * Netrw was executing all its associated
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4013 Filetype commands silently; I'm going
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4014 to try doing that "noisily" and see if
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4015 folks have a problem with that.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4016 Aug 12, 2016 * Changed order of tool selection for
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4017 handling http://... viewing.
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4018 (Nikolay Aleksandrovich Pavlov)
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4019 Aug 21, 2016 * Included hiding/showing/all for tree
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4020 listings
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4021 * Fixed refresh (^L) for tree listings
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4022 v156: Feb 18, 2016 * Changed =~ to =~# where appropriate
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4023 Feb 23, 2016 * s:ComposePath(base,subdir) now uses
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4024 fnameescape() on the base portion
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4025 Mar 01, 2016 * (gt_macki) reported where :Explore would
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4026 make file unlisted. Fixed (tst943)
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4027 Apr 04, 2016 * (reported by John Little) netrw normally
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4028 suppresses browser messages, but sometimes
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4029 those "messages" are what is wanted.
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4030 See |g:netrw_suppress_gx_mesg|
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4031 Apr 06, 2016 * (reported by Carlos Pita) deleting a remote
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4032 file was giving an error message. Fixed.
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4033 Apr 08, 2016 * (Charles Cooper) had a problem with an
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4034 undefined b:netrw_curdir. He also provided
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4035 a fix.
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4036 Apr 20, 2016 * Changed s:NetrwGetBuffer(); now uses
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4037 dictionaries. Also fixed the "No Name"
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 8148
diff changeset
4038 buffer problem.
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4039 v155: Oct 29, 2015 * (Timur Fayzrakhmanov) reported that netrw's
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4040 mapping of ctrl-l was not allowing refresh of
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4041 other windows when it was done in a netrw
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4042 window.
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4043 Nov 05, 2015 * Improved s:TreeSqueezeDir() to use search()
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4044 instead of a loop
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4045 * NetrwBrowse() will return line to
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4046 w:netrw_bannercnt if cursor ended up in
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4047 banner
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4048 Nov 16, 2015 * Added a <Plug>NetrwTreeSqueeze (|netrw-s-cr|)
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4049 Nov 17, 2015 * Commented out imaps -- perhaps someone can
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4050 tell me how they're useful and should be
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4051 retained?
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4052 Nov 20, 2015 * Added |netrw-ma| and |netrw-mA| support
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4053 Nov 20, 2015 * gx (|netrw-gx|) on a URL downloaded the
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4054 file in addition to simply bringing up the
12785
65d7fd8381a3 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 10228
diff changeset
4055 URL in a browser. Fixed.
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4056 Nov 23, 2015 * Added |g:netrw_sizestyle| support
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4057 Nov 27, 2015 * Inserted a lot of <c-u>s into various netrw
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4058 maps.
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4059 Jan 05, 2016 * |netrw-qL| implemented to mark files based
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4060 upon |location-list|s; similar to |netrw-qF|.
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4061 Jan 19, 2016 * using - call delete(directoryname,"d") -
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4062 instead of using g:netrw_localrmdir if
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4063 v7.4 + patch#1107 is available
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4064 Jan 28, 2016 * changed to using |winsaveview()| and
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4065 |winrestview()|
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4066 Jan 28, 2016 * s:NetrwTreePath() now does a save and
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4067 restore of view
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4068 Feb 08, 2016 * Fixed a tree-listing problem with remote
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4069 directories
7183
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4070 v154: Feb 26, 2015 * (Yuri Kanivetsky) reported a situation where
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4071 a file was not treated properly as a file
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4072 due to g:netrw_keepdir == 1
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4073 Mar 25, 2015 * (requested by Ben Friz) one may now sort by
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4074 extension
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4075 Mar 28, 2015 * (requested by Matt Brooks) netrw has a lot
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4076 of buffer-local mappings; however, some
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4077 plugins (such as vim-surround) set up
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4078 conflicting mappings that cause vim to wait.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4079 The "<nowait>" modifier has been included
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4080 with most of netrw's mappings to avoid that
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4081 delay.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4082 Jun 26, 2015 * |netrw-gn| mapping implemted
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4083 * :Ntree NotADir resulted in having
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4084 the tree listing expand in the error messages
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4085 window. Fixed.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4086 Jun 29, 2015 * Attempting to delete a file remotely caused
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4087 an error with "keepsol" mentioned; fixed.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4088 Jul 08, 2015 * Several changes to keep the |:jumps| table
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4089 correct when working with
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4090 |g:netrw_fastbrowse| set to 2
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4091 * wide listing with accented characters fixed
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4092 (using %-S instead of %-s with a |printf()|
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4093 Jul 13, 2015 * (Daniel Hahler) CheckIfKde() could be true
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4094 but kfmclient not installed. Changed order
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4095 in netrw#BrowseX(): checks if kde and
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4096 kfmclient, then will use xdg-open on a unix
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4097 system (if xdg-open is executable)
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4098 Aug 11, 2015 * (McDonnell) tree listing mode wouldn't
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4099 select a file in a open subdirectory.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4100 * (McDonnell) when multiple subdirectories
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4101 were concurrently open in tree listing
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4102 mode, a ctrl-L wouldn't refresh properly.
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4103 * The netrw:target menu showed duplicate
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4104 entries
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4105 Oct 13, 2015 * (mattn) provided an exception to handle
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4106 windows with shellslash set but no shell
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4107 Oct 23, 2015 * if g:netrw_usetab and <c-tab> now used
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4108 to control whether NetrwShrink is used
ffad29dc7eee commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents: 6476
diff changeset
4109 (see |netrw-c-tab|)
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4110 v153: May 13, 2014 * added another |g:netrw_ffkeep| usage {{{2
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4111 May 14, 2014 * changed s:PerformListing() so that it
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4112 always sets ft=netrw for netrw buffers
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4113 (ie. even when syntax highlighting is
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4114 off, not available, etc)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4115 May 16, 2014 * introduced the |netrw-ctrl-r| functionality
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4116 May 17, 2014 * introduced the |netrw-:NetrwMB| functionality
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4117 * mb and mB (|netrw-mb|, |netrw-mB|) will
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4118 add/remove marked files from bookmark list
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4119 May 20, 2014 * (Enno Nagel) reported that :Lex <dirname>
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4120 wasn't working. Fixed.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4121 May 26, 2014 * restored test to prevent leftmouse window
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4122 resizing from causing refresh.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4123 (see s:NetrwLeftmouse())
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4124 * fixed problem where a refresh caused cursor
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4125 to go just under the banner instead of
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4126 staying put
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4127 May 28, 2014 * (László Bimba) provided a patch for opening
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4128 the |:Lexplore| window 100% high, optionally
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4129 on the right, and will work with remote
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4130 files.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4131 May 29, 2014 * implemented :NetrwC (see |netrw-:NetrwC|)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4132 Jun 01, 2014 * Removed some "silent"s from commands used
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4133 to implemented scp://... and pscp://...
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4134 directory listing. Permits request for
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4135 password to appear.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4136 Jun 05, 2014 * (Enno Nagel) reported that user maps "/"
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4137 caused problems with "b" and "w", which
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4138 are mapped (for wide listings only) to
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4139 skip over files rather than just words.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4140 Jun 10, 2014 * |g:netrw_gx| introduced to allow users to
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4141 override default "<cfile>" with the gx
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4142 (|netrw-gx|) map
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4143 Jun 11, 2014 * gx (|netrw-gx|), with |'autowrite'| set,
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4144 will write modified files. s:NetrwBrowseX()
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4145 will now save, turn off, and restore the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4146 |'autowrite'| setting.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4147 Jun 13, 2014 * added visual map for gx use
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4148 Jun 15, 2014 * (Enno Nagel) reported that with having hls
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4149 set and wide listing style in use, that the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4150 b and w maps caused unwanted highlighting.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4151 Jul 05, 2014 * |netrw-mv| and |netrw-mX| commands included
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4152 Jul 09, 2014 * |g:netrw_keepj| included, allowing optional
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4153 keepj
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4154 Jul 09, 2014 * fixing bugs due to previous update
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4155 Jul 21, 2014 * (Bruno Sutic) provided an updated
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4156 netrw_gitignore.vim
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4157 Jul 30, 2014 * (Yavuz Yetim) reported that editing two
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4158 remote files of the same name caused the
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4159 second instance to have a "temporary"
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4160 name. Fixed: now they use the same buffer.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4161 Sep 18, 2014 * (Yasuhiro Matsumoto) provided a patch which
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4162 allows scp and windows local paths to work.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4163 Oct 07, 2014 * gx (see |netrw-gx|) when atop a directory,
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4164 will now do |gf| instead
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4165 Nov 06, 2014 * For cygwin: cygstart will be available for
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4166 netrw#BrowseX() to use if its executable.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4167 Nov 07, 2014 * Began support for file://... urls. Will use
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4168 |g:netrw_file_cmd| (typically elinks or links)
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4169 Dec 02, 2014 * began work on having mc (|netrw-mc|) copy
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4170 directories. Works for linux machines,
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4171 cygwin+vim, but not for windows+gvim.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4172 Dec 02, 2014 * in tree mode, netrw was not opening
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4173 directories via symbolic links.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4174 Dec 02, 2014 * added resolved link information to
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4175 thin and tree modes
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4176 Dec 30, 2014 * (issue#231) |:ls| was not showing
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4177 remote-file buffers reliably. Fixed.
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4178 v152: Apr 08, 2014 * uses the |'noswapfile'| option (requires {{{2
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4179 vim 7.4 with patch 213)
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4180 * (Enno Nagel) turn |'rnu'| off in netrw
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4181 buffers.
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4182 * (Quinn Strahl) suggested that netrw
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4183 allow regular window splitting to occur,
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4184 thereby allowing |'equalalways'| to take
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4185 effect.
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4186 * (qingtian zhao) normally, netrw will
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4187 save and restore the |'fileformat'|;
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4188 however, sometimes that isn't wanted
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4189 Apr 14, 2014 * whenever netrw marks a buffer as ro,
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4190 it will also mark it as nomod.
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4191 Apr 16, 2014 * sftp protocol now supported by
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4192 netrw#Obtain(); this means that one
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4193 may use "mc" to copy a remote file
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4194 to a local file using sftp, and that
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4195 the |netrw-O| command can obtain remote
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4196 files via sftp.
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4197 * added [count]C support (see |netrw-C|)
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4198 Apr 18, 2014 * when |g:netrw_chgwin| is one more than
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4199 the last window, then vertically split
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4200 the last window and use it as the
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4201 chgwin window.
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4202 May 09, 2014 * SavePosn was "saving filename under cursor"
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5734
diff changeset
4203 from a non-netrw window when using :Rex.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4204 v151: Jan 22, 2014 * extended :Rexplore to return to buffer {{{2
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4205 prior to Explore or editing a directory
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4206 * (Ken Takata) netrw gave error when
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4207 clipboard was disabled. Sol'n: Placed
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4208 several if has("clipboard") tests in.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4209 * Fixed ftp://X@Y@Z// problem; X@Y now
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4210 part of user id, and only Z is part of
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4211 hostname.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4212 * (A Loumiotis) reported that completion
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4213 using a directory name containing spaces
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4214 did not work. Fixed with a retry in
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4215 netrw#Explore() which removes the
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4216 backslashes vim inserted.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4217 Feb 26, 2014 * :Rexplore now records the current file
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4218 using w:netrw_rexfile when returning via
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4219 |:Rexplore|
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4220 Mar 08, 2014 * (David Kotchan) provided some patches
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4221 allowing netrw to work properly with
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4222 windows shares.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4223 * Multiple one-liner help messages available
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4224 by pressing <cr> while atop the "Quick
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4225 Help" line
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4226 * worked on ShellCmdPost, FocusGained event
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4227 handling.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4228 * |:Lexplore| path: will be used to update
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4229 a left-side netrw browsing directory.
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 7188
diff changeset
4230 Mar 12, 2014 * |netrw-s-cr|: use <s-cr> to close
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4231 tree directory implemented
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4232 Mar 13, 2014 * (Tony Mechylynck) reported that using
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4233 the browser with ftp on a directory,
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4234 and selecting a gzipped txt file, that
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4235 an E19 occurred (which was issued by
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4236 gzip.vim). Fixed.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4237 Mar 14, 2014 * Implemented :MF and :MT (see |netrw-:MF|
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4238 and |netrw-:MT|, respectively)
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4239 Mar 17, 2014 * |:Ntree| [dir] wasn't working properly; fixed
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4240 Mar 18, 2014 * Changed all uses of set to setl
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4241 Mar 18, 2014 * Commented the netrw_btkeep line in
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4242 s:NetrwOptionSave(); the effect is that
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4243 netrw buffers will remain as |'bt'|=nofile.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4244 This should prevent swapfiles being created
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4245 for netrw buffers.
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4246 Mar 20, 2014 * Changed all uses of lcd to use s:NetrwLcd()
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4247 instead. Consistent error handling results
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4248 and it also handles Window's shares
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4249 * Fixed |netrw-d| command when applied with ftp
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4250 * https: support included for netrw#NetRead()
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4251 v150: Jul 12, 2013 * removed a "keepalt" to allow ":e #" to {{{2
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4252 return to the netrw directory listing
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4253 Jul 13, 2013 * (Jonas Diemer) suggested changing
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4254 a <cWORD> to <cfile>.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4255 Jul 21, 2013 * (Yuri Kanivetsky) reported that netrw's
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4256 use of mkdir did not produce directories
5734
657ade71d395 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5618
diff changeset
4257 following the user's umask.
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4258 Aug 27, 2013 * introduced |g:netrw_altfile| option
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4259 Sep 05, 2013 * s:Strlen() now uses |strdisplaywidth()|
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4260 when available, by default
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4261 Sep 12, 2013 * (Selyano Baldo) reported that netrw wasn't
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4262 opening some directories properly from the
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4263 command line.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4264 Nov 09, 2013 * |:Lexplore| introduced
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4265 * (Ondrej Platek) reported an issue with
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4266 netrw's trees (P15). Fixed.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4267 * (Jorge Solis) reported that "t" in
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4268 tree mode caused netrw to forget its
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4269 line position.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4270 Dec 05, 2013 * Added <s-leftmouse> file marking
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4271 (see |netrw-mf|)
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4272 Dec 05, 2013 * (Yasuhiro Matsumoto) Explore should use
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4273 strlen() instead s:Strlen() when handling
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4274 multibyte chars with strpart()
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4275 (ie. strpart() is byte oriented, not
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4276 display-width oriented).
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4277 Dec 09, 2013 * (Ken Takata) Provided a patch; File sizes
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4278 and a portion of timestamps were wrongly
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4279 highlighted with the directory color when
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4280 setting `:let g:netrw_liststyle=1` on Windows.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4281 * (Paul Domaskis) noted that sometimes
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4282 cursorline was activating in non-netrw
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4283 windows. All but one setting of cursorline
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4284 was done via setl; there was one that was
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4285 overlooked. Fixed.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4286 Dec 24, 2013 * (esquifit) asked that netrw allow the
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4287 /cygdrive prefix be a user-alterable
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4288 parameter.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4289 Jan 02, 2014 * Fixed a problem with netrw-based ballon
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4290 evaluation (ie. netrw#NetrwBaloonHelp()
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4291 not having been loaded error messages)
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4292 Jan 03, 2014 * Fixed a problem with tree listings
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4293 * New command installed: |:Ntree|
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4294 Jan 06, 2014 * (Ivan Brennan) reported a problem with
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4295 |netrw-P|. Fixed.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4296 Jan 06, 2014 * Fixed a problem with |netrw-P| when the
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4297 modified file was to be abandoned.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4298 Jan 15, 2014 * (Matteo Cavalleri) reported that when the
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4299 banner is suppressed and tree listing is
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4300 used, a blank line was left at the top of
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4301 the display. Fixed.
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4302 Jan 20, 2014 * (Gideon Go) reported that, in tree listing
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4303 style, with a previous window open, that
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4304 the wrong directory was being used to open
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4305 a file. Fixed. (P21)
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4306 v149: Apr 18, 2013 * in wide listing format, now have maps for {{{2
4502
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4307 w and b to move to next/previous file
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4308 Apr 26, 2013 * one may now copy files in the same
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4309 directory; netrw will issue requests for
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4310 what names the files should be copied under
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4311 Apr 29, 2013 * Trying Benzinger's problem again. Seems
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4312 that commenting out the BufEnter and
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4313 installing VimEnter (only) works. Weird
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4314 problem! (tree listing, vim -O Dir1 Dir2)
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4315 May 01, 2013 * :Explore ftp://... wasn't working. Fixed.
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4316 May 02, 2013 * introduced |g:netrw_bannerbackslash| as
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4339
diff changeset
4317 requested by Paul Domaskis.
5618
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4318 Jul 03, 2013 * Explore now avoids splitting when a buffer
350272cbf1fd Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
4319 will be hidden.
6476
11d78e58a487 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
4320 v148: Apr 16, 2013 * changed Netrw's Style menu to allow direct {{{2
4339
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
4321 choice of listing style, hiding style, and
22fa3049e934 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3920
diff changeset
4322 sorting style
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4323
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4324 ==============================================================================
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
4325 13. Todo *netrw-todo* {{{1
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
4326
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
4327 07/29/09 : banner :|g:netrw_banner| can be used to suppress the
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
4328 suppression banner. This feature is new and experimental,
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
4329 so its in the process of being debugged.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
4330 09/04/09 : "gp" : See if it can be made to work for remote systems.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
4331 : See if it can be made to work with marked files.
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
4332
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
4333 ==============================================================================
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
4334 14. Credits *netrw-credits* {{{1
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4335
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4336 Vim editor by Bram Moolenaar (Thanks, Bram!)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4337 dav support by C Campbell
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4338 fetch support by Bram Moolenaar and C Campbell
19099
1a951a4beee3 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
4339 ftp support by C Campbell <NcampObell@SdrPchip.AorgM-NOSPAM>
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4340 http support by Bram Moolenaar <bram@moolenaar.net>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4341 rcp
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4342 rsync support by C Campbell (suggested by Erik Warendorph)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4343 scp support by raf <raf@comdyn.com.au>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4344 sftp support by C Campbell
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4345
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4346 inputsecret(), BufReadCmd, BufWriteCmd contributed by C Campbell
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4347
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4348 Jérôme Augé -- also using new buffer method with ftp+.netrc
534
c6296b0ad9ea updated for version 7.0151
vimboss
parents: 532
diff changeset
4349 Bram Moolenaar -- obviously vim itself, :e and v:cmdarg use,
1209
070f2ac50cf8 updated for version 7.1b
vimboss
parents: 1121
diff changeset
4350 fetch,...
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4351 Yasuhiro Matsumoto -- pointing out undo+0r problem and a solution
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4352 Erik Warendorph -- for several suggestions (g:netrw_..._cmd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4353 variables, rsync etc)
534
c6296b0ad9ea updated for version 7.0151
vimboss
parents: 532
diff changeset
4354 Doug Claar -- modifications to test for success with ftp
1209
070f2ac50cf8 updated for version 7.1b
vimboss
parents: 1121
diff changeset
4355 operation
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4356
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4357 ==============================================================================
1621
82b5078be2dd updated for version 7.2a
vimboss
parents: 1257
diff changeset
4358 Modelines: {{{1
22328
75ff30a78189 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 21991
diff changeset
4359 vim:tw=78:ts=8:ft=help:noet:norl:fdm=marker