Mercurial > vim

comparison runtime/doc/pi_netrw.txt @ 482:6f8b578776ab v7.0131

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
updated for version 7.0131
author vimboss
date Tue, 16 Aug 2005 23:01:50 +0000
parents bf5ba8a0cdee
children f012c4ed8c38
comparison
equal deleted inserted replaced
481:66080ac5dab7 482:6f8b578776ab
1 *pi_netrw.txt* For Vim version 7.0. Last change: Aug 11, 2005 1 *pi_netrw.txt* For Vim version 7.0. Last change: Aug 15, 2005
2 2
3 3
4 VIM REFERENCE MANUAL by Charles E. Campbell, Jr. 4 VIM REFERENCE MANUAL by Charles E. Campbell, Jr.
5 5
6 *dav* *http* *network* *rcp* *scp* 6 *dav* *http* *network* *rcp* *scp*
9 9
10 ============================================================================== 10 ==============================================================================
11 0. Contents *netrw-contents* 11 0. Contents *netrw-contents*
12 12
13 1. Netrw Reference......................................|netrw-ref| 13 1. Netrw Reference......................................|netrw-ref|
14 CONTROLLING EXTERNAL APPLICTIONS...................|netrw-externapp|
15 READING............................................|netrw-read|
16 WRITING............................................|netrw-write|
17 DIRECTORY LISTING..................................|netrw-dirlist|
18 CHANGING THE USERID AND PASSWORD...................|netrw-chgup|
19 VARIABLES..........................................|netrw-variables|
20 PATHS..............................................|netrw-path|
14 2. Network-Oriented File Transfer.......................|netrw-xfer| 21 2. Network-Oriented File Transfer.......................|netrw-xfer|
15 NETRC..............................................|netrw-netrc| 22 NETRC..............................................|netrw-netrc|
16 PASSWORD...........................................|netrw-passwd| 23 PASSWORD...........................................|netrw-passwd|
17 3. Activation...........................................|netrw-activate| 24 3. Activation...........................................|netrw-activate|
18 4. Transparent File Transfer............................|netrw-transparent| 25 4. Transparent File Transfer............................|netrw-transparent|
51 8. Problems and Fixes...................................|netrw-problems| 58 8. Problems and Fixes...................................|netrw-problems|
52 9. Debugging............................................|netrw-debug| 59 9. Debugging............................................|netrw-debug|
53 10. History..............................................|netrw-history| 60 10. History..............................................|netrw-history|
54 11. Credits..............................................|netrw-credits| 61 11. Credits..............................................|netrw-credits|
55 62
56 The functionality mentioned here is done via using |standard-plugin| 63 The Netrw plugin is generally sourced automatically as it is a
57 techniques. This plugin is only available if 64 |standard-plugin|. That said, to make use of netrw, one must
65 have plugins available which can be done with the following
66 two lines in your <.vimrc>:
58 67
59 set nocp " 'compatible' is not set 68 set nocp " 'compatible' is not set
60 filetype plugin on " plugins are enabled 69 filetype plugin on " plugins are enabled
61 70
62 You can avoid loading this plugin by setting the "loaded_netrw" variable 71 You can avoid loading this plugin by setting the "loaded_netrw" variable
67 {Vi does not have any of this} 76 {Vi does not have any of this}
68 77
69 ============================================================================== 78 ==============================================================================
70 1. Netrw Reference *netrw-ref* 79 1. Netrw Reference *netrw-ref*
71 80
72 OPTIONS 81 CONTROLLING EXTERNAL APPLICTIONS *netrw-externapp*
73 let g:netrw_ftp =0 use ftp (default) (uid password) 82
74 =1 use alternate ftp method (user uid password) 83 Protocol Variable Default Value
75 If you're having trouble with ftp, try changing the value 84 -------- ---------------- -------------
76 of this variable in your <.vimrc> to change methods 85 dav: *g:netrw_dav_cmd* = "cadaver"
77 86 fetch: *g:netrw_fetch_cmd* = "fetch -o"
78 let g:netrw_ignorenetrc= 1 87 ftp: *g:netrw_ftp_cmd* = "ftp"
79 If you have a <.netrc> file but it doesn't work and you 88 http: *g:netrw_http_cmd* = "fetch -o" if fetch is available
80 want it ignored, then set this variable as shown. Its mere 89 http: g:netrw_http_cmd = "wget -q -O" If wget is available
81 existence is enough to cause <.netrc> to be ignored. 90 rcp: *g:netrw_rcp_cmd* = "rcp"
82 91 rsync: *g:netrw_rsync_cmd* = "rsync -a"
83 Controlling External Applications *netrw-externapp* 92 scp: *g:netrw_scp_cmd* = "scp -q"
84 93 sftp: *g:netrw_sftp_cmd* = "sftp"
85 Protocol Variable Default Value 94
86 -------- ---------------- ------------- 95 READING *netrw-read* *netrw-nread*
87 dav: *g:netrw_dav_cmd* = "cadaver"
88 fetch: *g:netrw_fetch_cmd* = "fetch -o"
89 ftp: *g:netrw_ftp_cmd* = "ftp"
90 http: *g:netrw_http_cmd* = "fetch -o" if fetch is available
91 http: g:netrw_http_cmd = "wget -q -O" If wget is available
92 rcp: *g:netrw_rcp_cmd* = "rcp"
93 rsync: *g:netrw_rsync_cmd* = "rsync -a"
94 scp: *g:netrw_scp_cmd* = "scp -q"
95 sftp: *g:netrw_sftp_cmd* = "sftp"
96
97 READING *netrw-read* *netrw-nread*
98 :Nread ? give help 96 :Nread ? give help
99 :Nread "machine:path" uses rcp 97 :Nread "machine:path" uses rcp
100 :Nread "machine path" uses ftp with <.netrc> 98 :Nread "machine path" uses ftp w/ <.netrc>
101 :Nread "machine id password path" uses ftp 99 :Nread "machine id password path" uses ftp
102 :Nread "dav://machine[:port]/path" uses cadaver 100 :Nread "dav://machine[:port]/path" uses cadaver
103 :Nread "fetch://[user@]machine/path" uses fetch 101 :Nread "fetch://[user@]machine/path" uses fetch
104 :Nread "ftp://[user@]machine[[:#]port]/path" uses ftp autodetects <.netrc> 102 :Nread "ftp://[user@]machine[[:#]port]/path" uses ftp w/ <.netrc>
105 :Nread "http://[user@]machine/path" uses http uses wget 103 :Nread "http://[user@]machine/path" uses http uses wget
106 :Nread "rcp://[user@]machine/path" uses rcp 104 :Nread "rcp://[user@]machine/path" uses rcp
107 :Nread "rsync://[user@]machine[:port]/path" uses rsync 105 :Nread "rsync://[user@]machine[:port]/path" uses rsync
108 :Nread "scp://[user@]machine[[:#]port]/path" uses scp 106 :Nread "scp://[user@]machine[[:#]port]/path" uses scp
109 :Nread "sftp://[user@]machine/path" uses sftp 107 :Nread "sftp://[user@]machine/path" uses sftp
110 108
111 WRITING *netrw-write* *netrw-nwrite* 109 WRITING *netrw-write* *netrw-nwrite*
112 :Nwrite ? give help 110 :Nwrite ? give help
113 :Nwrite "machine:path" uses rcp 111 :Nwrite "machine:path" uses rcp
114 :Nwrite "machine path" uses ftp with <.netrc> 112 :Nwrite "machine path" uses ftp w/ <.netrc>
115 :Nwrite "machine id password path" uses ftp 113 :Nwrite "machine id password path" uses ftp
116 :Nwrite "dav://machine[:port]/path" uses cadaver 114 :Nwrite "dav://machine[:port]/path" uses cadaver
117 :Nwrite "ftp://[user@]machine[[:#]port]/path" uses ftp autodetects <.netrc> 115 :Nwrite "ftp://[user@]machine[[:#]port]/path" uses ftp w/ <.netrc>
118 :Nwrite "rcp://[user@]machine/path" uses rcp 116 :Nwrite "rcp://[user@]machine/path" uses rcp
119 :Nwrite "rsync://[user@]machine[:port]/path" uses rsync 117 :Nwrite "rsync://[user@]machine[:port]/path" uses rsync
120 :Nwrite "scp://[user@]machine[[:#]port]/path" uses scp 118 :Nwrite "scp://[user@]machine[[:#]port]/path" uses scp
121 :Nwrite "sftp://[user@]machine/path" uses sftp 119 :Nwrite "sftp://[user@]machine/path" uses sftp
122 http: not supported! 120 http: not supported!
123 121
124 DIRECTORY LISTING 122 DIRECTORY LISTING *netrw-dirlist*
125 :Nread [protocol]://[user]@hostname/path/ 123 :Nread [protocol]://[user]@hostname/path/
126 124
127 USER AND PASSWORD CHANGING 125 CHANGING USERID AND PASSWORD *netrw-chgup*
128 Attempts to use ftp will prompt you for a user-id and a password. 126 Attempts to use ftp will prompt you for a user-id and a password.
129 These will be saved in g:netrw_uid and g:netrw_passwd Subsequent uses 127 These will be saved in g:netrw_uid and g:netrw_passwd Subsequent uses
130 of ftp will re-use those. If you need to use a different user id 128 of ftp will re-use those. If you need to use a different user id
131 and/or password, you'll want to call NetUserPass() first. 129 and/or password, you'll want to call NetUserPass() first.
132 130
133 :NetUserPass [uid [password]] -- prompts as needed 131 :NetUserPass [uid [password]] -- prompts as needed
134 :call NetUserPass() -- prompts for uid and password 132 :call NetUserPass() -- prompts for uid and password
135 :call NetUserPass("uid") -- prompts for password 133 :call NetUserPass("uid") -- prompts for password
136 :call NetUserPass("uid","password") -- sets global uid and password 134 :call NetUserPass("uid","password") -- sets global uid and password
137 135
138 VARIABLES *netrw-variables* 136 VARIABLES *netrw-variables*
139 *b:netrw_lastfile* 137 *b:netrw_lastfile* last file Network-read/written retained on a per-buffer
140 last file Network-read/written retained on 138 basis (supports plain :Nw )
141 a per-buffer basis (supports plain :Nw ) 139
142 *s:netrw_line* 140 *s:netrw_line* during :Nw/NetWrite, holds current line number
143 during :Nw/NetWrite, holds current line number 141 *s:netrw_col* during :Nw/NetWrite, holds current column number
144 *s:netrw_col* 142 s:netrw_line and s:netrw_col are used to
145 during :Nw/NetWrite, holds current column number 143 restore the cursor position on writes
146 s:netrw_line and s:netrw_col are used to 144
147 restore the cursor position on writes 145 *g:netrw_ftp* if it doesn't exist, use default ftp
148 *g:netrw_ftp* 146 =0 use default ftp (uid password)
149 if it doesn't exist, use default ftp 147 =1 use alternate ftp method (user uid password)
150 =0 use default ftp (uid password) 148 If you're having trouble with ftp, try changing the
151 =1 use alternate ftp method (user uid password) 149 value of this variable to see if the alternate ftp
152 *g:netrw_ftpmode* 150 method works for your setup.
153 ="binary" (default) 151
154 ="ascii" 152 *g:netrw_ftpmode* ="binary" (default)
155 *g:netrw_uid* 153 ="ascii"
156 (ftp) user-id, retained on a per-session basis 154
157 *g:netrw_passwd* 155 *g:netrw_ignorenetrc* =0 (default)
158 (ftp) password, retained on a per-session basis 156 =1 If you have a <.netrc> file but it doesn't work and
159 *g:netrw_win95ftp* 157 you want it ignored, then set this variable as shown.
160 =1 if using Win95, will remove four trailing blank 158
161 lines that o/s's ftp "provides" on transfers 159 *g:netrw_uid* (ftp) user-id, retained on a per-session basis
162 =0 force normal ftp behavior (no trailing line 160 *g:netrw_passwd* (ftp) password, retained on a per-session basis
163 removal) 161
164 *g:netrw_cygwin* 162 *g:netrw_win95ftp* =1 if using Win95, will remove four trailing blank
165 =1 assume scp under windows is from cygwin 163 lines that o/s's ftp "provides" on transfers
166 Also permits network browsing to use 164 =0 force normal ftp behavior (no trailing line removal)
167 ls with time and size sorting 165
168 (default if windows) 166 *g:netrw_cygwin* =1 assume scp under windows is from cygwin. Also
169 =0 assume Windows' scp accepts windows-style paths 167 permits network browsing to use ls with time and
170 Network browsing uses dir instead of ls 168 size sorting (default if windows)
171 This option is ignored if you're using unix 169 =0 assume Windows' scp accepts windows-style paths
172 *g:netrw_use_nt_rcp* 170 Network browsing uses dir instead of ls
173 =0 don't use the rcp of WinNT, Win2000 and WinXP 171 This option is ignored if you're using unix
174 =1 use WinNT's rcp in binary mode (default) 172
175 173 *g:netrw_use_nt_rcp* =0 don't use the rcp of WinNT, Win2000 and WinXP
176 PATHS *netrw-path* 174 =1 use WinNT's rcp in binary mode (default)
177 175
178 Paths to files are generally user-directory relative for most protocols. 176 PATHS *netrw-path*
179 It is possible that some protocol will make paths relative to some 177
180 associated directory, however. 178 Paths to files are generally user-directory relative for most protocols.
181 179 It is possible that some protocol will make paths relative to some
182 example: vim scp://user@host/somefile 180 associated directory, however.
183 example: vim scp://user@host/subdir1/subdir2/somefile 181 >
184 182 example: vim scp://user@host/somefile
185 where "somefile" is the "user"'s home directory. If you wish to get a 183 example: vim scp://user@host/subdir1/subdir2/somefile
186 file using root-relative paths, use the full path: 184 <
187 185 where "somefile" is the "user"'s home directory. If you wish to get a
188 example: vim scp://user@host//somefile 186 file using root-relative paths, use the full path:
189 example: vim scp://user@host//subdir1/subdir2/somefile 187 >
190 188 example: vim scp://user@host//somefile
189 example: vim scp://user@host//subdir1/subdir2/somefile
190 <
191 191
192 ============================================================================== 192 ==============================================================================
193 2. Network-Oriented File Transfer *netrw-xfer* 193 2. Network-Oriented File Transfer *netrw-xfer*
194 194
195 Network-oriented file transfer under Vim is implemented by a VimL-based script 195 Network-oriented file transfer under Vim is implemented by a VimL-based script
389 This call will set both the b:netrw_uid and b:netrw_passwd. 389 This call will set both the b:netrw_uid and b:netrw_passwd.
390 The user-id and password are used by ftp transfers. One may 390 The user-id and password are used by ftp transfers. One may
391 effectively remove the user-id and password by using "" 391 effectively remove the user-id and password by using ""
392 strings. 392 strings.
393 393
394 :NetrwSettings This command is desribed in |netrw-settings| -- used to
395 display netrw settings and change netrw behavior
396
394 397
395 ============================================================================== 398 ==============================================================================
396 6. Variables and Options *netrw-options* *netrw-var* 399 6. Variables and Options *netrw-options* *netrw-var*
397 400
398 The script <netrw.vim> uses several variables which can affect <netrw.vim>'s 401 The script <netrw.vim> uses several variables which can affect <netrw.vim>'s
594 :Sexplore[!] [dir] Split & Explore directory ...............|netrw-explore| 597 :Sexplore[!] [dir] Split & Explore directory ...............|netrw-explore|
595 :Hexplore[!] [dir] Horizontal Split & Explore...............|netrw-explore| 598 :Hexplore[!] [dir] Horizontal Split & Explore...............|netrw-explore|
596 :Vexplore[!] [dir] Vertical Split & Explore.................|netrw-explore| 599 :Vexplore[!] [dir] Vertical Split & Explore.................|netrw-explore|
597 :Pexplore[!] [dir] Vertical Split & Explore.................|netrw-explore| 600 :Pexplore[!] [dir] Vertical Split & Explore.................|netrw-explore|
598 :Nexplore[!] [dir] Vertical Split & Explore.................|netrw-explore| 601 :Nexplore[!] [dir] Vertical Split & Explore.................|netrw-explore|
602 :NetrwSettings.............................................|netrw-settings|
599 603
600 QUICK REFERENCE COMMANDS TABLE *netrw-browse-cmds* 604 QUICK REFERENCE COMMANDS TABLE *netrw-browse-cmds*
601 > 605 >
602 ------- ----------- 606 ------- -----------
603 Command Explanation 607 Command Explanation
625 window. A vertical split is used. 629 window. A vertical split is used.
626 x Apply a function to a file. 630 x Apply a function to a file.
627 631
628 NETRW BROWSER VARIABLES *netrw-browse-var* 632 NETRW BROWSER VARIABLES *netrw-browse-var*
629 > 633 >
630 --- ----------- 634 --- -----------
631 Var Explanation 635 Var Explanation
632 --- ----------- 636 --- -----------
633 < *g:netrw_alto* change from above splitting to 637 < *g:netrw_alto* change from above splitting to below splitting
634 below splitting by setting this 638 by setting this variable (see |netrw-o|)
635 variable (see |netrw-o|) 639 default: =0
636 default: =0 640
637 641 *g:netrw_altv* change from left splitting to right splitting
638 *g:netrw_altv* change from left splitting to 642 by setting this variable (see |netrw-v|)
639 right splitting by setting this 643 default: =0
640 variable (see |netrw-v|) 644
641 default: =0 645 *g:netrw_ftp_browse_reject* ftp can produce a number of errors and warnings
642 646 that can show up as "directories" and "files"
643 *g:netrw_ftp_browse_reject* ftp can produce a number of errors 647 in the listing. This pattern is used to
644 and warnings that can show up as 648 remove such embedded messages. By default its
645 "directories" and "files" in the 649 value is:
646 listing. This pattern is used to 650 '^total\s\+\d\+$\|
647 remove such embedded messages. By 651 ^Trying\s\+\d\+.*$\|
648 default its value is: 652 ^KERBEROS_V\d rejected\|
649 '^total\s\+\d\+$\| 653 ^Security extensions not\|
650 ^Trying\s\+\d\+.*$\| 654 No such file\|
651 ^KERBEROS_V\d rejected\| 655 : connect to address [0-9a-fA-F:]*
652 ^Security extensions not\| 656 : No route to host$'
653 No such file\| 657
654 : connect to address [0-9a-fA-F:]* 658 *g:netrw_ssh_browse_reject* ssh can sometimes produce unwanted lines,
655 : No route to host$' 659 messages, banners, and whatnot that one doesn't
656 660 want masquerading as "directories" and "files".
657 *g:netrw_ssh_browse_reject* ssh can sometimes produce unwanted 661 Use this pattern to remove such embedded
658 lines/messages/banners/and whatnot 662 messages. By default its value is:
659 that one doesn't want masquerading
660 as "directories" and "files". Use
661 this pattern to remove such embedded
662 messages. By default its value is:
663 '^total\s\+\d\+$' 663 '^total\s\+\d\+$'
664 664
665 *g:netrw_keepdir* =1 (default) keep current directory 665 *g:netrw_keepdir* =1 (default) keep current directory immune from
666 immune from the browsing directory. 666 the browsing directory.
667 =0 keep the current directory the 667 =0 keep the current directory the same as the
668 same as the browsing directory. 668 browsing directory.
669 The browsing directory is contained in 669 The current browsing directory is contained in
670 b:netrw_curdir 670 b:netrw_curdir
671 671
672 *g:netrw_list_cmd* command for listing remote directories 672 *g:netrw_list_cmd* command for listing remote directories
673 default: (if ssh is executable) 673 default: (if ssh is executable)
674 "ssh HOSTNAME ls -FLa" 674 "ssh HOSTNAME ls -FLa"
675 675
676 *g:netrw_longlist* if =1, then long listing will be default 676 *g:netrw_longlist* if =1, then long listing will be default
677 677
678 *g:netrw_ftp_list_cmd* options for passing along to ftp for 678 *g:netrw_ftp_list_cmd* options for passing along to ftp for directory
679 directory listing. Defaults: 679 listing. Defaults:
680 unix or g:netrw_cygwin set: : "ls -lF" 680 unix or g:netrw_cygwin set: : "ls -lF"
681 otherwise "dir" 681 otherwise "dir"
682 682
683 *g:netrw_list_hide* comma separated list of patterns for 683 *g:netrw_list_hide* comma separated pattern list for hiding files
684 hiding files 684 default: ""
685 default: "" 685
686 686 *g:netrw_local_mkdir* command for making a local directory
687 *g:netrw_local_mkdir* command for making a local directory 687 default: "ssh HOSTNAME mkdir"
688 default: "ssh HOSTNAME mkdir" 688
689 689 *g:netrw_local_rmdir* remove directory command (rmdir)
690 *g:netrw_local_rmdir* remove directory command (rmdir) 690 default: "rmdir"
691 default: "rmdir" 691
692 692 *g:netrw_maxfilenamelen* =32 by default, selected so as to make long
693 *g:netrw_maxfilenamelen* =32 by default, selected so as to make 693 listings fit on 80 column displays.
694 long listings fit on 80 column displays. 694 If your screen is wider, and you have file
695 If your screen is wider, and you have 695 or directory names longer than 32 bytes,
696 file/directory names longer than 32 bytes, 696 you may set this option to keep listings
697 you may set this option to keep listings 697 columnar.
698 columnar. 698
699 699 *g:netrw_mkdir_cmd* command for making a remote directory
700 *g:netrw_mkdir_cmd* command for making a remote directory 700 default: "ssh HOSTNAME mkdir"
701 default: "ssh HOSTNAME mkdir" 701
702 702 *g:netrw_rm_cmd* command for removing files
703 *g:netrw_rm_cmd* command for removing files 703 default: "ssh HOSTNAME rm"
704 default: "ssh HOSTNAME rm" 704
705 705 *g:netrw_rmdir_cmd* command for removing directories
706 *g:netrw_rmdir_cmd* command for removing directories 706 default: "ssh HOSTNAME rmdir"
707 default: "ssh HOSTNAME rmdir" 707
708 708 *g:netrw_rmf_cmd* command for removing softlinks
709 *g:netrw_rmf_cmd* command for removing softlinks 709 default: "ssh HOSTNAME rm -f"
710 default: "ssh HOSTNAME rm -f" 710
711 711 *g:netrw_hide* if true, the hiding list is used
712 *g:netrw_hide* if true, the hiding list is used 712 default: =0
713 default: =0 713
714 714 *g:netrw_sort_by* sort by "name", "time", or "size"
715 *g:netrw_sort_by* sort by "name", "time", or "size" 715 default: "name"
716 default: "name" 716
717 717 *g:netrw_sort_direction* sorting direction: "normal" or "reverse"
718 *g:netrw_sort_direction* sorting direction: "normal" or "reverse" 718 default: "normal"
719 default: "normal" 719
720 720 *g:netrw_sort_sequence* when sorting by name, first sort by the
721 *g:netrw_sort_sequence* when sorting by name, first sort by the 721 comma-separated pattern sequence
722 comma-separated pattern sequence 722 default: '[\/]$,*,\.bak$,\.o$,\.h$,
723 default: '[\/]$,*,\.bak$,\.o$,\.h$, 723 \.info$,\.swp$,\.obj$'
724 \.info$,\.swp$,\.obj$' 724
725 725 *g:netrw_timefmt* specify format string to strftime() (%c)
726 *g:netrw_timefmt* specify format string to strftime() (%c) 726 default: "%c"
727 default: "%c" 727
728 728 *g:netrw_winsize* specify initial size of new o/v windows
729 *g:netrw_winsize* specify initial size of new o/v windows 729 default: ""
730 default: ""
731 730
732 INTRODUCTION TO DIRECTORY BROWSING *netrw-browse-intro* 731 INTRODUCTION TO DIRECTORY BROWSING *netrw-browse-intro*
733 732
734 Netrw supports the browsing of directories on the local system and on remote 733 Netrw supports the browsing of directories on the local system and on remote
735 hosts, including generating listing directories, entering directories, editing 734 hosts, including generating listing directories, entering directories, editing
1009 1008
1010 1009
1011 CUSTOMIZING BROWSING WITH A USER FUNCTION *netrw-x* *netrw-handler* 1010 CUSTOMIZING BROWSING WITH A USER FUNCTION *netrw-x* *netrw-handler*
1012 1011
1013 One may "enter" a file with a special handler, thereby firing up a browser or 1012 One may "enter" a file with a special handler, thereby firing up a browser or
1014 other application, for example, on a file by hitting the "x" key. Presumably 1013 other application, for example, on a file by hitting the "x" key. The special
1015 one could write handlers that would start OpenOffice programs (oowriter), etc, 1014 handler varies:
1016 based on the file's extension coupled with the user's hitting the "x" key atop 1015
1017 the file. 1016 * for Windows 32 or 64, the url and FileProtocolHandler dlls are used.
1018 1017 * for KDE (with kfmclient): kfmclient is used.
1019 The Netrw executor applies a user-defined function to a file, based on its 1018 * for Gnome (with gnome-open): gnome-open is used.
1019 * otherwise the NetrwFileHandler plugin is used.
1020
1021 The file's suffix is used by these various approaches to determine an
1022 appropriate application to use to "handle" these files. Such things
1023 as OpenOffice (*.sfx), visualization (*.jpg, *.gif, etc), and PostScript
1024 (*.ps, *.eps) can be handled.
1025
1026 The NetrwFileHandler applies a user-defined function to a file, based on its
1020 extension. Of course, the handler function must exist for it to be called! 1027 extension. Of course, the handler function must exist for it to be called!
1021 > 1028 >
1022 Ex. mypgm.html x -> 1029 Ex. mypgm.html x ->
1023 NetrwFileHandler_html("scp://user@host/some/path/mypgm.html") 1030 NetrwFileHandler_html("scp://user@host/some/path/mypgm.html")
1024 < 1031 <
1025 See the <plugin/NetrwFileHandlers.vim> for an example of how to handle an html 1032 See the <plugin/NetrwFileHandlers.vim> for an example of how to handle an html
1026 file with mozilla. 1033 file with mozilla.
1034
1035 One may write custom NetrwFileHandlers; please look at the
1036 plugin/NetrwFileHandlers.vim script for examples. If its likely to be
1037 generally useful, please feel free to forward a copy to me for future
1038 inclusion in the distribution.
1027 1039
1028 1040
1029 MAKING THE BROWSING DIRECTORY THE CURRENT DIRECTORY *netrw-c* *netrw-curdir* 1041 MAKING THE BROWSING DIRECTORY THE CURRENT DIRECTORY *netrw-c* *netrw-curdir*
1030 1042
1031 By default, g:netrw_keepdir is 1. This setting means that the current 1043 By default, g:netrw_keepdir is 1. This setting means that the current
1074 1086
1075 http://hacks.oreilly.com/pub/h/66 1087 http://hacks.oreilly.com/pub/h/66
1076 1088
1077 It gives a tip for setting up password-less use of ssh and scp, and discusses 1089 It gives a tip for setting up password-less use of ssh and scp, and discusses
1078 the associated security issues. 1090 the associated security issues.
1091
1092
1093 NETRW SETTINGS *netrw-settings*
1094
1095 With the NetrwSettings.vim plugin, >
1096 :NetrwSettings
1097 will bring up a window with the many variables that netrw uses for its
1098 settings. You may change any of their values; when you save the file,
1099 the settings therein will be used. One may also press "?" on any of
1100 the lines for help on what each of the variables do.
1079 1101
1080 1102
1081 ============================================================================== 1103 ==============================================================================
1082 8. Problems and Fixes *netrw-problems* 1104 8. Problems and Fixes *netrw-problems*
1083 1105
1193 NdrOchip at ScampbellPfamily.AbizM - NOSPAM 1215 NdrOchip at ScampbellPfamily.AbizM - NOSPAM
1194 1216
1195 ============================================================================== 1217 ==============================================================================
1196 10. History *netrw-history* 1218 10. History *netrw-history*
1197 1219
1220 v63: * netrw now takes advantage of autoload (and requires 7.0)
1221 * Bugfix - using r (to reverse sort) working again
1222 v62: * Bugfix - spaces allowed again in directory names with
1223 g:netrw_keepdir=0. In fact, I've tested netrw (again)
1224 with most ANSI punctuation marks for directory names.
1225 * Bugfix - NetrwSettings gave errors when g:netrw_silent
1226 had not be set.
1198 v61: * document upgrade -- netrw variable-based settings all should 1227 v61: * document upgrade -- netrw variable-based settings all should
1199 have tags. Supports NetrwSettings command. 1228 have tags. Supports NetrwSettings command.
1200 * several important variables are window-oriented. Netrw has 1229 * several important variables are window-oriented. Netrw has
1201 to transfer these across a window split. See s:BufWinVars() 1230 to transfer these across a window split. See s:BufWinVars()
1202 and s:UseBufWinVars(). 1231 and s:UseBufWinVars().