comparison runtime/doc/pi_netrw.txt @ 466:7a01bd1ac566

updated for version 7.0125
author vimboss
date Mon, 08 Aug 2005 22:00:59 +0000
parents 3b705e71c7b0
children f8b75b8f1988
comparison
equal deleted inserted replaced
465:49669e1a7c5c 466:7a01bd1ac566
1 *pi_netrw.txt* For Vim version 7.0. Last change: Aug 04, 2005 1 *pi_netrw.txt* For Vim version 7.0. Last change: Aug 08, 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*
169 It is possible that some protocol will make paths relative to some 169 It is possible that some protocol will make paths relative to some
170 associated directory, however. 170 associated directory, however.
171 171
172 example: vim scp://user@host/somefile 172 example: vim scp://user@host/somefile
173 example: vim scp://user@host/subdir1/subdir2/somefile 173 example: vim scp://user@host/subdir1/subdir2/somefile
174 174
175 where "somefile" is the "user"'s home directory. If you wish to get a 175 where "somefile" is the "user"'s home directory. If you wish to get a
176 file using root-relative paths, use the full path: 176 file using root-relative paths, use the full path:
177 177
178 example: vim scp://user@host//somefile 178 example: vim scp://user@host//somefile
179 example: vim scp://user@host//subdir1/subdir2/somefile 179 example: vim scp://user@host//subdir1/subdir2/somefile
739 vim [protocol]://[user@]hostname/path/ 739 vim [protocol]://[user@]hostname/path/
740 740
741 If you'd like to avoid entering the password in for directory listings, scp, 741 If you'd like to avoid entering the password in for directory listings, scp,
742 ssh interaction, etc, see |netrw-list-hack|. 742 ssh interaction, etc, see |netrw-list-hack|.
743 743
744 744 *netrw-explore* *netrw-pexplore*
745 DIRECTORY EXPLORING COMMANDS *netrw-explore* 745 *netrw-hexplore* *netrw-sexplore*
746 DIRECTORY EXPLORING COMMANDS *netrw-nexplore* *netrw-vexplore*
746 747
747 :Explore[!] [dir]... Explore directory of current file 748 :Explore[!] [dir]... Explore directory of current file
748 :Sexplore[!] [dir]... Split & Explore directory of current file 749 :Sexplore[!] [dir]... Split & Explore directory of current file
749 :Hexplore[!] [dir]... Horizontal Split & Explore 750 :Hexplore[!] [dir]... Horizontal Split & Explore
750 :Vexplore[!] [dir]... Vertical Split & Explore 751 :Vexplore[!] [dir]... Vertical Split & Explore
751 :Nexplore............. used with **/patterns; go to next matching file 752 :Nexplore............. used with **/patterns; go to next matching file
752 :Pexplore............. used with **/patterns; go to previous matching file 753 :Pexplore............. used with **/patterns; go to previous matching file
753 754
754 The Explore command will open the local-directory browser on the current 755 The Explore command will open the local-directory browser on the current
755 file's directory (or on directory [dir] if specified). The window 756 file's directory (or on directory [dir] if specified). The window will be
756 will be split only if the file has been modified, otherwise the 757 split only if the file has been modified, otherwise the browsing window will
757 browsing window will take over that window. Normally the splitting is 758 take over that window. Normally the splitting is taken horizontally; the
758 taken horizontally; the optional ! will use vertical splitting. 759 optional ! will use vertical splitting.
759 760
760 Sexplore will always split the window before invoking the local-directory 761 Sexplore will always split the window before invoking the local-directory
761 browser. As with Explore, the splitting is normally done horizontally, 762 browser. As with Explore, the splitting is normally done horizontally, but
762 but with the optional ! the splitting will be done vertically. 763 with the optional ! the splitting will be done vertically.
763 764
764 Hexplore does an Explore with |belowright| horizontal splitting; the 765 Hexplore does an Explore with |belowright| horizontal splitting; the
765 optional ! does the Explore with |aboveleft| horizontal splitting. 766 optional ! does the Explore with |aboveleft| horizontal splitting.
766 767
767 Vexplore does an Explore with |leftabove| vertical splitting; the optiona 768 Vexplore does an Explore with |leftabove| vertical splitting; the
768 ! does an Explore with |topleft| vertical splitting. 769 optional "!" does an Explore with |topleft| vertical splitting.
769 770
770 (Following needs v7.0 or later) 771 (Following needs v7.0 or later) *netrw-starstar*
771 When Explore, Sexplore, Hexplore, or Vexplore are used with 772 When Explore, Sexplore, Hexplore, or Vexplore are used like
772 **/filename-patterns, netrw will attempt to find a (sub)directory which 773 >
773 matches the filename pattern. The Nexplore and Pexplore commands enable 774 :Explore **/filename_pattern
774 one to proceed to the next/previous matching file, respectively. If your 775 <
775 console or gui produce recognizable shift-up or shift-down sequences, then 776 netrw will attempt to find a (sub)directory which matches the filename
777 pattern. Internally, it produces a list of files which match the pattern
778 and their paths; to that extent it resembles the Unix operation:
779 >
780 find $(pwd) -name "$1" -exec "echo" "{}" ";" 2> /dev/null
781 <
782 The directory display is updated to show the subdirectory containing a
783 matching file. One may then proceed to the next (or previous) matching files'
784 directories by using Nexplore or Pexplore, respectively. If your console or
785 gui produces recognizable shift-up or shift-down sequences, then you'll likely
786 find the following mappings convenient:
776 787
777 <s-down> == Nexplore, and 788 <s-down> == Nexplore, and
778 <s-up> == Pexplore. 789 <s-up> == Pexplore.
779 790
780 As an example, consider > 791 As an example, consider
781 792 >
782 :Explore **/*.c 793 :Explore **/*.c
783 :Nexplore 794 :Nexplore
784 :Nexplore 795 :Nexplore
785 :Pexplore 796 :Pexplore
786 < 797 <
798 The status line will show, on the right hand side of the status line, a
799 message like "Match 3 of 20".
800
787 801
788 REFRESHING THE LISTING *netrw-ctrl-l* 802 REFRESHING THE LISTING *netrw-ctrl-l*
789 803
790 To refresh either a local or remote directory listing, press ctrl-l (<c-l>) or 804 To refresh either a local or remote directory listing, press ctrl-l (<c-l>) or
791 hit the <cr> when atop the ./ directory entry in the listing. One may also 805 hit the <cr> when atop the ./ directory entry in the listing. One may also
1064 1078
1065 See |netrw-fixup|, and put the following into your 1079 See |netrw-fixup|, and put the following into your
1066 <.vimrc> file: 1080 <.vimrc> file:
1067 1081
1068 let g:netrw_win95ftp= 1 1082 let g:netrw_win95ftp= 1
1069 1083
1070 1084
1071 1085
1072 P2. I use windows, and my network browsing with ftp doesn't sort by 1086 P2. I use windows, and my network browsing with ftp doesn't sort by
1073 time or size 1087 time or size
1074 1088
1075 Windows' ftp has a minimal support for ls (ie. it doesn't 1089 Windows' ftp has a minimal support for ls (ie. it doesn't
1111 1125
1112 P6. I want my current directory to track my browsing. 1126 P6. I want my current directory to track my browsing.
1113 How do I do that? 1127 How do I do that?
1114 1128
1115 let g:netrw_keepdir= 0 1129 let g:netrw_keepdir= 0
1116 1130
1117 1131
1118 ============================================================================== 1132 ==============================================================================
1119 9. Debugging *netrw-debug* 1133 9. Debugging *netrw-debug*
1120 1134
1121 The <netrw.vim> script is typically available as: 1135 The <netrw.vim> script is typically available as:
1130 as "Decho, a vimL debugging aid" 1144 as "Decho, a vimL debugging aid"
1131 or 1145 or
1132 http://vim.sourceforge.net/scripts/script.php?script_id=120 1146 http://vim.sourceforge.net/scripts/script.php?script_id=120
1133 1147
1134 and put it into your local plugin directory. 1148 and put it into your local plugin directory.
1135 1149
1136 2. <Decho.vim> itself needs the <cecutil.vim> script, so you'll need 1150 2. <Decho.vim> itself needs the <cecutil.vim> script, so you'll need
1137 to put it into your .vim/plugin, too. You may obtain it from: 1151 to put it into your .vim/plugin, too. You may obtain it from:
1138 1152
1139 http://mysite.verizon.net/astronaut/vim/index.html#VimFuncs 1153 http://mysite.verizon.net/astronaut/vim/index.html#VimFuncs
1140 as "DrC's Utilities" 1154 as "DrC's Utilities"
1163 NdrOchip at ScampbellPfamily.AbizM - NOSPAM 1177 NdrOchip at ScampbellPfamily.AbizM - NOSPAM
1164 1178
1165 ============================================================================== 1179 ==============================================================================
1166 10. History *netrw-history* 1180 10. History *netrw-history*
1167 1181
1182 v59: * bugfix -- another keepalt work-around installed (for vim6.3)
1183 * "Match # of #" for Explore **/pattern matches
1168 v58: * Explore and relatives can now handle **/somefilepattern (v7) 1184 v58: * Explore and relatives can now handle **/somefilepattern (v7)
1169 * Nexplore and Pexplore introduced (v7). shift-down and shift-up 1185 * Nexplore and Pexplore introduced (v7). shift-down and shift-up
1170 cursor keys will invoke Nexplore and Pexplore, respectively. 1186 cursor keys will invoke Nexplore and Pexplore, respectively.
1171 * bug fixed with o and v 1187 * bug fixed with o and v
1172 * autochdir only worked around for vim when it has been 1188 * autochdir only worked around for vim when it has been