comparison runtime/doc/pi_netrw.txt @ 36:125e80798a85 v7.0021

updated for version 7.0021
author vimboss
date Thu, 09 Dec 2004 21:34:53 +0000
parents 404aac550f35
children 8ecb0db93e9a
comparison
equal deleted inserted replaced
35:8f3a526c2fe1 36:125e80798a85
1 *pi_netrw.txt For Vim version 6.2. Last change: Sep 13, 2004 1 *pi_netrw.txt* For Vim version 6.3. Last change: Oct 08, 2004
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*
534 <c-h>......Edit File/Directory Hiding List.........|netrw-h| 534 <c-h>......Edit File/Directory Hiding List.........|netrw-h|
535 i..........Long Listing............................|netrw-i| 535 i..........Long Listing............................|netrw-i|
536 <c-l>......Refreshing the Listing..................|netrw-ctrl-l| 536 <c-l>......Refreshing the Listing..................|netrw-ctrl-l|
537 o..........Browsing with a Horizontal Split........|netrw-o| 537 o..........Browsing with a Horizontal Split........|netrw-o|
538 p..........Preview Window..........................|netrw-p| 538 p..........Preview Window..........................|netrw-p|
539 q..........Listing Bookmarks.......................|netrw-q| 539 q..........Listing Bookmarks and History...........|netrw-q|
540 r..........Reversing Sorting Order.................|netrw-r| 540 r..........Reversing Sorting Order.................|netrw-r|
541 R..........Renaming Files or Directories...........|netrw-R| 541 R..........Renaming Files or Directories...........|netrw-R|
542 s..........Selecting Sorting Style.................|netrw-s| 542 s..........Selecting Sorting Style.................|netrw-s|
543 S..........Editing the Sorting Sequence............|netrw-S| 543 S..........Editing the Sorting Sequence............|netrw-S|
544 u..........Changing to a Predecessor Directory.....|netrw-u|
545 U..........Changing to a Successor Directory.......|netrw-U|
544 v..........Browsing with a Vertical Split..........|netrw-v| 546 v..........Browsing with a Vertical Split..........|netrw-v|
545 x..........Customizing Browsing....................|netrw-x| 547 x..........Customizing Browsing....................|netrw-x|
546 548
547 QUICK REFERENCE COMMANDS TABLE *netrw-browse-cmds* 549 QUICK REFERENCE COMMANDS TABLE *netrw-browse-cmds*
548 > 550 >
749 EDIT FILE OR DIRECTORY HIDING LIST *netrw-h* 751 EDIT FILE OR DIRECTORY HIDING LIST *netrw-h*
750 752
751 The "<ctrl-h>" map brings up a requestor allowing the user to change the 753 The "<ctrl-h>" map brings up a requestor allowing the user to change the
752 file/directory hiding list. The hiding list consists of one or more patterns 754 file/directory hiding list. The hiding list consists of one or more patterns
753 delimited by commas. Files and/or directories satisfying these patterns will 755 delimited by commas. Files and/or directories satisfying these patterns will
754 be hidden (ie. not shown). 756 either be hidden (ie. not shown) or be the only ones displayed (see |netrw-a|).
755 757
756 758
757 BROWSING WITH A HORIZONTALLY SPLIT WINDOW *netrw-o* 759 BROWSING WITH A HORIZONTALLY SPLIT WINDOW *netrw-o*
758 760
759 Normally one enters a file or directory using the <cr>. However, the "o" map 761 Normally one enters a file or directory using the <cr>. However, the "o" map
798 800
799 REVERSING SORTING ORDER *netrw-r* 801 REVERSING SORTING ORDER *netrw-r*
800 802
801 One may toggle between normal and reverse sorting order by pressing the 803 One may toggle between normal and reverse sorting order by pressing the
802 "r" key. 804 "r" key.
805
806
807 CHANGING TO A PREDECESSOR DIRECTORY *netrw-u*
808
809 Every time you change to a new directory (new for the current session),
810 netrw will save the directory in a recently-visited directory history
811 list (unless g:netrw_dirhistmax is zero; by default, its ten). With the
812 "u" map, one can change to an earlier directory (predecessor). To do
813 the opposite, see |netrw-U|.
814
815
816 CHANGING TO A SUCCESSOR DIRECTORY *netrw-U*
817
818 With the "U" map, one can change to a later directory (successor).
819 This map is the opposite of the "u" map. (see |netrw-u|) Use the
820 q map to list both the bookmarks and history. (see |netrw-q|)
803 821
804 822
805 BROWSING WITH A VERTICALLY SPLIT WINDOW *netrw-v* 823 BROWSING WITH A VERTICALLY SPLIT WINDOW *netrw-v*
806 824
807 Normally one enters a file or directory using the <cr>. However, the "v" 825 Normally one enters a file or directory using the <cr>. However, the "v"
852 One may easily "bookmark" a directory by using 870 One may easily "bookmark" a directory by using
853 871
854 {cnt}b 872 {cnt}b
855 873
856 Any count may be used. One may use viminfo's "!" option to retain bookmarks 874 Any count may be used. One may use viminfo's "!" option to retain bookmarks
857 between vim sessions. 875 between vim sessions. See |netrw-B| for how to return to a bookmark and
876 |netrw-q| for how to list them.
858 877
859 878
860 CHANGING TO A BOOKMARKED DIRECTORY *netrw-B* 879 CHANGING TO A BOOKMARKED DIRECTORY *netrw-B*
861 880
862 To change directory back to a bookmarked directory, use 881 To change directory back to a bookmarked directory, use
863 882
864 {cnt}B 883 {cnt}B
865 884
866 Any count may be used. 885 Any count may be used to reference any of the bookmarks. See |netrw-b|
867 886 for how to bookmark a directory and |netrw-q| for how to list them.
868 887
869 LISTING BOOKMARKS *netrw-q* 888
870 889 LISTING BOOKMARKS AND HISTORY *netrw-q*
871 Pressing "q" will list the bookmarked directories. (query) 890
891 Pressing "q" will list the bookmarked directories and directory traversal
892 history (query). (see |netrw-b|, |netrw-B|, |netrw-u|, and |netrw-U|)
872 893
873 894
874 IMPROVING DIRECTORY BROWSING *netrw-list-hack* 895 IMPROVING DIRECTORY BROWSING *netrw-list-hack*
875 896
876 Especially with the remote directory browser, constantly entering the password 897 Especially with the remote directory browser, constantly entering the password
989 4. Then bring up vim and attempt a transfer. A set of messages 1010 4. Then bring up vim and attempt a transfer. A set of messages
990 should appear concerning the steps that <netrw.vim> took in 1011 should appear concerning the steps that <netrw.vim> took in
991 attempting to read/write your file over the network. Please 1012 attempting to read/write your file over the network. Please
992 send that information to <netrw.vim>'s maintainer, 1013 send that information to <netrw.vim>'s maintainer,
993 1014
994 drchipNOSPAM at campbellfamily.biz - NOSPAM 1015 NdrOchip at ScampbellPfamily.AbizM - NOSPAM
995 1016
996 ============================================================================== 1017 ==============================================================================
997 10. History *netrw-history* 1018 10. History *netrw-history*
998 1019
1020 v52: * nonumber'ing now set for browsing buffers
1021 * when the hiding list hid all files, error messages ensued. Fixed
1022 * when browsing, swf is set, but directory is not set, when netrw
1023 was attempting to restore options, vim wanted to save a swapfile
1024 to a local directory using an url-style path. Fixed
1025 v51: * cygwin detection now automated (using windows and &shell is bash)
1026 * customizable browser "file" rejection patterns
1027 * directory history
1028 * :[range]w url now supported (ie. netrw has a FileWriteCmd event)
1029 * error messages have a "Press <cr> to continue" to allow them
1030 to be seen
1031 * directory browser displays no longer bother the swapfile
1032 * u/U commands to go up and down the history stack
1033 * history stack may be saved with viminfo with its "!" option
1034 * bugfixes associated with unwanted [No Files] entries
999 v50: * directories now displayed using buftype=nofile; should keep the 1035 v50: * directories now displayed using buftype=nofile; should keep the
1000 directory names as-is 1036 directory names as-is
1001 * attempts to remove empty "[No File]" buffers leftover 1037 * attempts to remove empty "[No File]" buffers leftover
1002 from :file ..name.. commands 1038 from :file ..name.. commands
1003 * bugfix: a "caps-lock" editing difficulty left in v49 was fixed 1039 * bugfix: a "caps-lock" editing difficulty left in v49 was fixed
1004 * syntax highlighting for "Showing:" the hiding list included 1040 * syntax highlighting for "Showing:" the hiding list included
1005 * bookmarks can now be retained if "!" is in the viminfo option 1041 * bookmarks can now be retained if "!" is in the viminfo option
1006 v49: * will use ftp for http://.../ browsing v48: * One may use ftp to 1042 v49: * will use ftp for http://.../ browsing v48:
1007 do remote host file browsing 1043 * One may use ftp to do remote host file browsing
1008 * (windows and !cygwin) remote browsing with ftp can now use 1044 * (windows and !cygwin) remote browsing with ftp can now use
1009 the "dir" command internally to provide listings 1045 the "dir" command internally to provide listings
1010 * g:netrw_keepdir now allows one to keep the initial current 1046 * g:netrw_keepdir now allows one to keep the initial current
1011 directory as the current directory (normally the local file 1047 directory as the current directory (normally the local file
1012 browser makes the currently viewed directory the current 1048 browser makes the currently viewed directory the current
1030 * one may view all, use the hiding list to suppress, or use the 1066 * one may view all, use the hiding list to suppress, or use the
1031 hiding list to show-only remote and local file/directory 1067 hiding list to show-only remote and local file/directory
1032 listings 1068 listings
1033 * improved unusual file and directory name handling preview 1069 * improved unusual file and directory name handling preview
1034 * window support 1070 * window support
1035 v47: * now handles local directory browsing. v46: * now handles 1071 v47: * now handles local directory browsing.
1036 remote directory browsing 1072 v46: * now handles remote directory browsing
1037 * g:netrw_silent (if 1) will cause all transfers to be silent'd 1073 * g:netrw_silent (if 1) will cause all transfers to be silent
1038 v45: * made the [user@]hostname:path form a bit more restrictive to 1074 v45: * made the [user@]hostname:path form a bit more restrictive to
1039 better handle errors in using protocols (e.g. scp:usr@host:file 1075 better handle errors in using protocols (e.g. scp:usr@host:file
1040 was being recognized as an rcp request) v44: * changed from 1076 was being recognized as an rcp request) v44: * changed from
1041 "rsync -a" to just "rsync" 1077 "rsync -a" to just "rsync"
1042 * somehow an editing error messed up the test to recognize 1078 * somehow an editing error messed up the test to recognize