Mercurial > vim

comparison runtime/doc/pi_netrw.txt @ 21:db5102f7e29f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
updated for version 7.0013
author vimboss
date Thu, 29 Jul 2004 08:43:53 +0000
parents 631143ac4a01
children cc049b00ee70
comparison
equal deleted inserted replaced
20:4ac1dce8dd5e 21:db5102f7e29f
1 *pi_netrw.txt For Vim version 6.2. Last change: Jun 25, 2004 1 *pi_netrw.txt For Vim version 6.2. Last change: Jul 26, 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*
501 ============================================================================== 501 ==============================================================================
502 7. Remote Directory Browser *netrw-browse* *netrw-dir* *netrw-list* *netrw-help* 502 7. Remote Directory Browser *netrw-browse* *netrw-dir* *netrw-list* *netrw-help*
503 ?..........Help....................................|netrw-help| 503 ?..........Help....................................|netrw-help|
504 <cr>.......Browsing................................|netrw-cr| 504 <cr>.......Browsing................................|netrw-cr|
505 <c-l>......Refreshing the Listing..................|netrw-c-l| 505 <c-l>......Refreshing the Listing..................|netrw-c-l|
506 <del>......Removing Files or Directories...........|netrw-delete| 506 <del>......Deleting Files or Directories...........|netrw-delete|
507 D..........Removing Files or Directories...........|netrw-D|
508 \H.........Edit File/Directory Hiding List.........|netrw-H|
509 \M.........Make A New Directory....................|netrw-M|
510 R..........Renaming Files or Directories...........|netrw-R|
511 -..........Going Up................................|netrw--| 507 -..........Going Up................................|netrw--|
512 a..........Hiding Files or Directories.............|netrw-a| 508 a..........Hiding Files or Directories.............|netrw-a|
509 D..........Deleting Files or Directories...........|netrw-D|
510 \h.........Edit File/Directory Hiding List.........|netrw-h|
513 i..........Long Listing............................|netrw-i| 511 i..........Long Listing............................|netrw-i|
512 \m.........Make A New Directory....................|netrw-m|
514 o..........Browsing with a Horizontal Split........|netrw-o| 513 o..........Browsing with a Horizontal Split........|netrw-o|
515 r..........Reversing Sorting Order.................|netrw-r| 514 r..........Reversing Sorting Order.................|netrw-r|
515 R..........Renaming Files or Directories...........|netrw-R|
516 s..........Selecting Sorting Style.................|netrw-s| 516 s..........Selecting Sorting Style.................|netrw-s|
517 v..........Browsing with a Vertical Split..........|netrw-v| 517 v..........Browsing with a Vertical Split..........|netrw-v|
518 x..........Customizing Browsing....................|netrw-x| 518 x..........Customizing Browsing....................|netrw-x|
519 *netrw-browse-cmds* 519
520 > 520 QUICK REFERENCE COMMANDS TABLE *netrw-browse-cmds*
521 Quick Reference Commands Table 521 >
522 ------- ----------- 522 ------- -----------
523 Command Explanation 523 Command Explanation
524 ------- ----------- 524 ------- -----------
525 ? Causes Netrw to issue help 525 ? Causes Netrw to issue help
526 <cr> Netrw will enter the directory or read the file 526 <cr> Netrw will enter the directory or read the file
528 <c-l> Causes Netrw to refresh the directory listing 528 <c-l> Causes Netrw to refresh the directory listing
529 D Netrw will attempt to remove the file(s)/directory(ies) 529 D Netrw will attempt to remove the file(s)/directory(ies)
530 R Netrw will attempt to rename the file(s)/directory(ies) 530 R Netrw will attempt to rename the file(s)/directory(ies)
531 - Makes Netrw go up one directory 531 - Makes Netrw go up one directory
532 a Show all of a directory (temporarily ignore g:netrw_list_hide) 532 a Show all of a directory (temporarily ignore g:netrw_list_hide)
533 h Edit file hiding list 533 \h Edit file hiding list
534 i Toggles between long and short listing 534 i Toggles between long and short listing
535 \m Make a directory
535 o Enter the file/directory under the cursor in a new browser 536 o Enter the file/directory under the cursor in a new browser
536 window. A horizontal split is used. 537 window. A horizontal split is used.
537 r Reverse sorting order 538 r Reverse sorting order
538 s Select sorting style: by name, time, or file size 539 s Select sorting style: by name, time, or file size
539 v Enter the file/directory under the cursor in a new browser 540 v Enter the file/directory under the cursor in a new browser
540 window. A vertical split is used. 541 window. A vertical split is used.
541 x Apply a function to a file. 542 x Apply a function to a file.
542 < 543 <
543 *netrw-browse-var* 544 NETRW BROWSER VARIABLES *netrw-browse-var*
544 > 545 >
545 --- ----------- 546 --- -----------
546 Var Explanation 547 Var Explanation
547 --- ----------- 548 --- -----------
548 g:netrw_list_cmd supports listing 549 g:netrw_list_cmd supports listing
554 unix-default: rm win32-default: ren 555 unix-default: rm win32-default: ren
555 g:netrw_mkdir_cmd specify command for making a directory remotely 556 g:netrw_mkdir_cmd specify command for making a directory remotely
556 g:netrw_rm_cmd supports removing files 557 g:netrw_rm_cmd supports removing files
557 g:netrw_rmdir_cmd supports removing directories 558 g:netrw_rmdir_cmd supports removing directories
558 g:netrw_rmf_cmd supports removing softlinks to directories 559 g:netrw_rmf_cmd supports removing softlinks to directories
560 g:netrw_hide if true, the hiding list is used
559 g:netrw_sort_by sort by "name", "time", or "size" 561 g:netrw_sort_by sort by "name", "time", or "size"
560 g:netrw_sort_direction sorting direction: "normal" or "reverse" 562 g:netrw_sort_direction sorting direction: "normal" or "reverse"
561 g:netrw_sort_sequence when sorting by name, first sort by the 563 g:netrw_sort_sequence when sorting by name, first sort by the
562 comma-separated pattern sequence 564 comma-separated pattern sequence
563 g:netrw_timefmt specify format string to strftime() default: %c 565 g:netrw_timefmt specify format string to strftime() default: %c
575 To enter the netrw directory browser, simply attempt to read a "file" with a 577 To enter the netrw directory browser, simply attempt to read a "file" with a
576 trailing slash and it will be interpreted as a request to list a directory: 578 trailing slash and it will be interpreted as a request to list a directory:
577 579
578 vim [protocol]://[user@]hostname/path/ 580 vim [protocol]://[user@]hostname/path/
579 581
582 To get no-password directory listings, scp, ssh interaction, etc, see
583 |netrw-list-hack|.
580 584
581 REFRESHING THE LISTING *netrw-c-l* 585 REFRESHING THE LISTING *netrw-c-l*
582 586
583 To refresh the directory listing, press ctrl-l (<c-l>) or hit the <cr> 587 To refresh the directory listing, press ctrl-l (<c-l>) or hit the <cr>
584 when atop the ./ directory entry in the listing. 588 when atop the ./ directory entry in the listing.
613 The long listing is either based on the "ls" command via ssh for remote 617 The long listing is either based on the "ls" command via ssh for remote
614 directories or displays the filename, file size (in bytes), and the 618 directories or displays the filename, file size (in bytes), and the
615 time and date of last modification for local directories. 619 time and date of last modification for local directories.
616 620
617 621
618 MAKING A NEW DIRECTORY *netrw-M* 622 MAKING A NEW DIRECTORY *netrw-m*
619 623
620 Actually <Leader>M, where the <Leader> is, by default, the backslash. 624 Actually <Leader>m, where the <Leader> is, by default, the backslash.
621 625
622 With the "<Leader>M" map one may make a new directory either remotely (which 626 With the "<Leader>m" map one may make a new directory either remotely (which
623 depends on the global variable g:netrw_mkdir_cmd) or locally (which depends on 627 depends on the global variable g:netrw_mkdir_cmd) or locally (which depends on
624 the global variable g:netrw_local_mkdir). Netrw will issue a request for the 628 the global variable g:netrw_local_mkdir). Netrw will issue a request for the
625 new directory's name. A bare <CR> at that point will abort the making of the 629 new directory's name. A bare <CR> at that point will abort the making of the
626 directory. Attempts to make a local directory that already exists (as either 630 directory. Attempts to make a local directory that already exists (as either
627 a file or a directory) will be detected, reported on, and ignored. 631 a file or a directory) will be detected, reported on, and ignored.
628 632
629 REMOVING FILES OR DIRECTORIES *netrw-delete* *netrw-remove* *netrw-D* 633 DELETING FILES OR DIRECTORIES *netrw-delete* *netrw-D*
630 634
631 Deleting/removing files and directories involves moving the cursor to the 635 Deleting/removing files and directories involves moving the cursor to the
632 file/directory to be deleted and pressing "D". Directories must be empty first 636 file/directory to be deleted and pressing "D". Directories must be empty first
633 before they can be successfully removed. If the directory is a softlink to a 637 before they can be successfully removed. If the directory is a softlink to a
634 directory, then netrw will make two requests to remove the directory before 638 directory, then netrw will make two requests to remove the directory before
666 The g:netrw_rename_cmd variable is used to implement renaming. By default its 670 The g:netrw_rename_cmd variable is used to implement renaming. By default its
667 value is: 671 value is:
668 672
669 ssh HOSTNAME mv 673 ssh HOSTNAME mv
670 674
671 675 One may rename a block of files and directories by selecting them with
672 HIDING FILES OR DIRECTORIES *g:netrw_a* *g:netrw_list_hide* 676 the V (|linewise-visual|).
673 677
674 The "a" map lets the browser ignore the g:netrw_list_hide variable. Normally 678 HIDING FILES OR DIRECTORIES *g:netrw-a* *g:netrw_list_hide*
675 the g:netrw_list_hide variable holds a comma separated list of patterns which 679
676 will be hidden (removed) from the directory listing. Mnemonically, the 680 The "a" map toggles the netrw vim file browser (both remote and local) between
677 "a" stands for show All. 681 displaying hidden files (show-all) versus hiding files. For files to be
678 682 hidden, the g:netrw_list_hide variable must hold a comma delimited list of
679 683 patterns (ex. \.obj) to be hidden from normal listing. (see |netrw-h|)
680 EDIT FILE OR DIRECTORY HIDING LIST *netrw-H* 684
681 685
682 Actually <Leader>H, where the <Leader> is, by default, the backslash. 686 EDIT FILE OR DIRECTORY HIDING LIST *netrw-h*
683 687
684 The "<Leader>H" map brings up a requestor allowing the user to change the 688 Actually <Leader>h, where the <Leader> is, by default, the backslash.
685 file/directory hiding list. The hiding list consists of one or more 689
686 patterns delimited by commas. Files and/or directories satisfying 690 The "<Leader>h" map brings up a requestor allowing the user to change the
687 these patterns will be hidden (ie. not shown). 691 file/directory hiding list. The hiding list consists of one or more patterns
692 delimited by commas. Files and/or directories satisfying these patterns will
693 be hidden (ie. not shown).
688 694
689 695
690 BROWSING WITH A HORIZONTALLY SPLIT WINDOW *netrw-o* 696 BROWSING WITH A HORIZONTALLY SPLIT WINDOW *netrw-o*
691 697
692 Normally one enters a file or directory using the <cr>. However, the "o" 698 Normally one enters a file or directory using the <cr>. However, the "o" map
693 map allows one to open a new window to hold the new directory listing or 699 allows one to open a new window to hold the new directory listing or file. A
694 file. A horizontal split is used. (also see |netrw-v|) 700 horizontal split is used. (also see |netrw-v|)
695 701
696 702
697 SELECTING SORTING STYLE *netrw-s* 703 SELECTING SORTING STYLE *netrw-s*
698 704
699 One may select the sorting style by name, time, or (file) size. The 705 One may select the sorting style by name, time, or (file) size. The
777 drchipNOSPAM at campbellfamily.biz - NOSPAM 783 drchipNOSPAM at campbellfamily.biz - NOSPAM
778 784
779 ============================================================================== 785 ==============================================================================
780 9. History *netrw-history* 786 9. History *netrw-history*
781 787
782 v47: * 788 v47: * now handles local directory browsing.
783 v46: * now handles remote directory browsing 789 v46: * now handles remote directory browsing
784 * g:netrw_silent (if 1) will cause all transfers to be silent'd 790 * g:netrw_silent (if 1) will cause all transfers to be silent'd
785 v45: * made the [user@]hostname:path form a bit more restrictive 791 v45: * made the [user@]hostname:path form a bit more restrictive
786 to better handle errors in using protocols 792 to better handle errors in using protocols
787 (e.g. scp:usr@host:file was being recognized as an rcp request) 793 (e.g. scp:usr@host:file was being recognized as an rcp request)