mirror of
https://github.com/preservim/nerdtree.git
synced 2025-11-08 11:23:48 -05:00
Compare commits
144 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9aba1c17f6 | ||
|
|
0fc5d3f656 | ||
|
|
729abf8e9b | ||
|
|
96215c5da6 | ||
|
|
f4c455bc2f | ||
|
|
22904e41de | ||
|
|
d49c742daf | ||
|
|
a59a2f6177 | ||
|
|
2f399b9ba4 | ||
|
|
4b61723952 | ||
|
|
00ab690758 | ||
|
|
d4b4d69469 | ||
|
|
283559bd97 | ||
|
|
38442b06d4 | ||
|
|
ae0d744357 | ||
|
|
094074d8c6 | ||
|
|
9b192b4be4 | ||
|
|
5fcdd03f12 | ||
|
|
d89dbd354a | ||
|
|
ed273e108d | ||
|
|
03dec4cde4 | ||
|
|
171c3825fa | ||
|
|
be2e602efa | ||
|
|
2ca4573b01 | ||
|
|
cdc005f46a | ||
|
|
19d5aaa513 | ||
|
|
83966b7563 | ||
|
|
b2b2bdfccd | ||
|
|
cf8c54689b | ||
|
|
a8cd995624 | ||
|
|
82a6064803 | ||
|
|
f8b51d01b7 | ||
|
|
3cbb73a63c | ||
|
|
d24a421efd | ||
|
|
6cf4e9a763 | ||
|
|
2e26da9666 | ||
|
|
e102abe98f | ||
|
|
4c1362aff8 | ||
|
|
1a4cf45f03 | ||
|
|
374df70218 | ||
|
|
a57b867ee6 | ||
|
|
927aebfa8b | ||
|
|
4f0a39159a | ||
|
|
76d2ecbb17 | ||
|
|
73322e88d2 | ||
|
|
0620b91efa | ||
|
|
ea4d4ff80d | ||
|
|
45c33fe0f6 | ||
|
|
fe249e20b9 | ||
|
|
e819e13a5d | ||
|
|
5c95fbda65 | ||
|
|
3e217115bc | ||
|
|
5d564fdbcf | ||
|
|
8184b964bc | ||
|
|
0daeebc0eb | ||
|
|
5939fdb140 | ||
|
|
9dd850b672 | ||
|
|
21601d9c3d | ||
|
|
332a1baedd | ||
|
|
e8aadb77b8 | ||
|
|
31c1faea32 | ||
|
|
818a53003e | ||
|
|
78419f858c | ||
|
|
b1d10a12fa | ||
|
|
f404cdd54b | ||
|
|
c463234452 | ||
|
|
b1020ad9c8 | ||
|
|
0ad0d195e5 | ||
|
|
43bf05c42e | ||
|
|
236df49362 | ||
|
|
bccd73c8f5 | ||
|
|
fd487dfa5c | ||
|
|
3cb3227d56 | ||
|
|
f183d60b13 | ||
|
|
8c8cd29142 | ||
|
|
83e8c144ed | ||
|
|
06c7c53127 | ||
|
|
ec682b1f9b | ||
|
|
7a15d9879f | ||
|
|
dea37444bc | ||
|
|
f5a20e5379 | ||
|
|
a0573c51b1 | ||
|
|
d0cb14c7ce | ||
|
|
f2b2327c24 | ||
|
|
9d5a940be3 | ||
|
|
38d91b66b0 | ||
|
|
65ebd30334 | ||
|
|
1998cef2b4 | ||
|
|
030cff2eda | ||
|
|
02facac20a | ||
|
|
7789ccb90a | ||
|
|
d497c9ae9c | ||
|
|
cdf1e8d6e9 | ||
|
|
5f4a002787 | ||
|
|
c34968d282 | ||
|
|
f76f983182 | ||
|
|
312ce93bb4 | ||
|
|
06776557cf | ||
|
|
d831cbf17b | ||
|
|
aad2259522 | ||
|
|
e1bd98fc7c | ||
|
|
7ca9b07b68 | ||
|
|
1532bf1922 | ||
|
|
ac544460e4 | ||
|
|
d2989eb3e0 | ||
|
|
73be034d5e | ||
|
|
b5d6736f76 | ||
|
|
1c38ffd30b | ||
|
|
8e4b3565f8 | ||
|
|
31445645f7 | ||
|
|
fc053917d8 | ||
|
|
201df0a782 | ||
|
|
b59a7cd979 | ||
|
|
8f7aed712b | ||
|
|
3e946b1b4f | ||
|
|
2a16431b2d | ||
|
|
6815622d2c | ||
|
|
5c32c2a226 | ||
|
|
b363396a93 | ||
|
|
87382097df | ||
|
|
e6d2f12bf6 | ||
|
|
43ee096cee | ||
|
|
2b1eecebb2 | ||
|
|
c0d83f95a8 | ||
|
|
01ded5d150 | ||
|
|
5884cf3774 | ||
|
|
d15818bafa | ||
|
|
f74ec0661d | ||
|
|
d68dcd252e | ||
|
|
30bfb6e6b7 | ||
|
|
bfa5de8c55 | ||
|
|
6a665a588f | ||
|
|
55ff76171a | ||
|
|
a701bb71c4 | ||
|
|
6343639193 | ||
|
|
5ce5c62611 | ||
|
|
3ebff6ae54 | ||
|
|
d9a03f4600 | ||
|
|
59b132f0f7 | ||
|
|
d56bf992d2 | ||
|
|
efa7941c54 | ||
|
|
808850a464 | ||
|
|
24ad44b46f | ||
|
|
737ad58740 |
@@ -22,7 +22,10 @@ CONTENTS *NERDTree-contents*
|
||||
1.Intro...................................|NERDTree|
|
||||
2.Functionality provided..................|NERDTreeFunctionality|
|
||||
2.1 Global commands...................|NERDTreeGlobalCommands|
|
||||
2.2 Bookmark commands.................|NERDTreeBookmarkCommands|
|
||||
2.2 Bookmarks.........................|NERDTreeBookmarks|
|
||||
2.2.1 The bookmark table..........|NERDTreeBookmarkTable|
|
||||
2.2.2 Bookmark commands...........|NERDTreeBookmarkCommands|
|
||||
2.2.3 Invalid bookmarks...........|NERDTreeInvalidBookmarks|
|
||||
2.3 NERD tree mappings................|NERDTreeMappings|
|
||||
2.4 The filesystem menu...............|NERDTreeFilesysMenu|
|
||||
3.Options.................................|NERDTreeOptions|
|
||||
@@ -43,7 +46,7 @@ What is this "NERD tree"??
|
||||
The NERD tree allows you to explore your filesystem and to open files and
|
||||
directories. It presents the filesystem to you in the form of a tree which you
|
||||
manipulate with the keyboard and/or mouse. It also allows you to perform
|
||||
simple filesystem operations so you can alter the tree dynamically.
|
||||
simple filesystem operations.
|
||||
|
||||
The following features and functionality are provided by the NERD tree:
|
||||
* Files and directories are displayed in a hierarchical tree structure
|
||||
@@ -53,6 +56,7 @@ The following features and functionality are provided by the NERD tree:
|
||||
* sym-links
|
||||
* windows .lnk files
|
||||
* read-only files
|
||||
* executable files
|
||||
* Many (customisable) mappings are provided to manipulate the tree:
|
||||
* Mappings to open/close/explore directory nodes
|
||||
* Mappings to open files in new/existing windows/tabs
|
||||
@@ -66,7 +70,7 @@ The following features and functionality are provided by the NERD tree:
|
||||
* optional displaying of hidden files (. files)
|
||||
* files can be "turned off" so that only directories are displayed
|
||||
* A textual filesystem menu is provided which allows you to
|
||||
create/delete/rename file and directory nodes as well as copy (for
|
||||
create/delete/move file and directory nodes as well as copy (for
|
||||
supported OSs)
|
||||
* The position and size of the NERD tree window can be customised
|
||||
* The order in which the nodes in the tree are listed can be customised.
|
||||
@@ -109,18 +113,27 @@ The following features and functionality are provided by the NERD tree:
|
||||
Close the NERD tree in this tab.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
2.2. Bookmark Commands *NERDTreeBookmarkCommands*
|
||||
2.2. Bookmarks *NERDTreeBookmarks*
|
||||
|
||||
Bookmarks in the NERD tree are a way to tag files or directories of interest.
|
||||
For example, you could use bookmarks to tag all of your project directories.
|
||||
See also |:NERDTree| and |:NERDTreeFromBookmark|.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
2.2.1. The Bookmark Table *NERDTreeBookmarkTable*
|
||||
|
||||
If the bookmark table is active (see |NERDTree-B| and
|
||||
|'NERDTreeShowBookmarks'|), it will be rendered above the tree. You can double
|
||||
click bookmarks or use the |NERDTree-o| mapping to activate them. See also,
|
||||
|NERDTree-t| and |NERDTree-T|
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
2.2.2. Bookmark commands *NERDTreeBookmarkCommands*
|
||||
|
||||
Note that the following commands are only available in the NERD tree buffer.
|
||||
|
||||
:Bookmark <name>
|
||||
Bookmark the current node as <name>. If there is already a <name>
|
||||
bookmark, it is overwritten. <name> must consist of alphanumeric
|
||||
characters and underscores.
|
||||
bookmark, it is overwritten. <name> must not contain spaces.
|
||||
|
||||
:BookmarkToRoot <bookmark>
|
||||
Make the directory corresponding to <bookmark> the new root. If a treenode
|
||||
@@ -146,15 +159,36 @@ Note that the following commands are only available in the NERD tree buffer.
|
||||
:ClearAllBookmarks
|
||||
Remove all bookmarks.
|
||||
|
||||
:ReadBookmarks
|
||||
Re-read the bookmarks in the |'NERDTreeBookmarksFile'|.
|
||||
|
||||
See also |:NERDTree| and |:NERDTreeFromBookmark|.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
2.2.3. Invalid Bookmarks *NERDTreeInvalidBookmarks*
|
||||
|
||||
If invalid bookmarks are detected, the script will issue an error message and
|
||||
the invalid bookmarks will become unavailable for use.
|
||||
|
||||
These bookmarks will still be stored in the bookmarks file (see
|
||||
|'NERDTreeBookmarksFile'|), down the bottom. There will always be a blank line
|
||||
after the valid bookmarks but before the invalid ones.
|
||||
|
||||
Each line in the bookmarks file represents one bookmark. The proper format is:
|
||||
<bookmark name><space><full path to the bookmark location>
|
||||
|
||||
After you have corrected any invalid bookmarks, either restart vim, or go
|
||||
:ReadBookmarks from the NERD tree window.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
2.3. NERD tree Mappings *NERDTreeMappings*
|
||||
|
||||
Default Description~ help-tag~
|
||||
Key~
|
||||
|
||||
o.......Open selected file, or expand selected dir...............|NERDTree-o|
|
||||
o.......Open files, directories and bookmarks....................|NERDTree-o|
|
||||
go......Open selected file, but leave cursor in the NERDTree.....|NERDTree-go|
|
||||
t.......Open selected node in a new tab..........................|NERDTree-t|
|
||||
t.......Open selected node/bookmark in a new tab.................|NERDTree-t|
|
||||
T.......Same as 't' but keep the focus on the current tab........|NERDTree-T|
|
||||
<tab>...Open selected file in a split window.....................|NERDTree-tab|
|
||||
g<tab>..Same as <tab>, but leave the cursor on the NERDTree......|NERDTree-gtab|
|
||||
@@ -168,6 +202,8 @@ double-click.......same as the |NERDTree-o| map.
|
||||
middle-click.......same as |NERDTree-tab| for files, same as
|
||||
|NERDTree-e| for dirs.
|
||||
|
||||
D.......Delete the current bookmark .............................|NERDTree-D|
|
||||
|
||||
P.......Jump to the root node....................................|NERDTree-P|
|
||||
p.......Jump to current nodes parent.............................|NERDTree-p|
|
||||
K.......Jump up inside directories at the current tree depth.....|NERDTree-K|
|
||||
@@ -186,6 +222,7 @@ cd......Change the CWD to the dir of the selected node...........|NERDTree-cd|
|
||||
H.......Toggle whether hidden files displayed....................|NERDTree-H|
|
||||
f.......Toggle whether the file filters are used.................|NERDTree-f|
|
||||
F.......Toggle whether files are displayed.......................|NERDTree-F|
|
||||
B.......Toggle whether the bookmark table is displayed...........|NERDTree-B|
|
||||
|
||||
q.......Close the NERDTree window................................|NERDTree-q|
|
||||
?.......Toggle the display of the quick help.....................|NERDTree-?|
|
||||
@@ -196,8 +233,16 @@ Default key: o
|
||||
Map option: NERDTreeMapActivateNode
|
||||
Applies to: files and directories.
|
||||
|
||||
If a file node is selected, it is opened in the previous window. If a
|
||||
directory is selected it is opened or closed depending on its current state.
|
||||
If a file node is selected, it is opened in the previous window.
|
||||
|
||||
If a directory is selected it is opened or closed depending on its current
|
||||
state.
|
||||
|
||||
If a bookmark that links to a directory is selected then that directory
|
||||
becomes the new root.
|
||||
|
||||
If a bookmark that links to a file is selected then that file is opened in the
|
||||
previous window.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTree-go*
|
||||
@@ -217,8 +262,12 @@ Default key: t
|
||||
Map option: NERDTreeMapOpenInTab
|
||||
Applies to: files and directories.
|
||||
|
||||
Opens the selected file in a new tab. If a directory is selected, a netrw is
|
||||
opened in a new tab.
|
||||
Opens the selected file in a new tab. If a directory is selected, a fresh
|
||||
NERD Tree for that directory is opened in a new tab.
|
||||
|
||||
If a bookmark which points to a directory is selected, open a NERD tree for
|
||||
that directory in a new tab. If the bookmark points to a file, open that file
|
||||
in a new tab.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTree-T*
|
||||
@@ -265,10 +314,9 @@ Applies to: directories.
|
||||
Recursively opens the selelected directory.
|
||||
|
||||
All files and directories are cached, but if a directory would not be
|
||||
displayed due to file filters (see |NERDTreeIgnore| |NERDTree-f|) or the
|
||||
hidden file filter (see |NERDTreeShowHidden|) then it is not opened. This is
|
||||
handy, especially if you have .svn directories.
|
||||
|
||||
displayed due to file filters (see |'NERDTreeIgnore'| |NERDTree-f|) or the
|
||||
hidden file filter (see |'NERDTreeShowHidden'|) then its contents are not
|
||||
cached. This is handy, especially if you have .svn directories.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTree-x*
|
||||
@@ -296,6 +344,14 @@ Applies to: files and directories.
|
||||
|
||||
Opens a netrw on the selected directory, or the selected file's directory.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTree-D*
|
||||
Default key: D
|
||||
Map option: NERDTreeMapDeleteBookmark
|
||||
Applies to: lines in the bookmarks table
|
||||
|
||||
Deletes the currently selected bookmark.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTree-P*
|
||||
Default key: P
|
||||
@@ -344,8 +400,7 @@ Default key: <C-j>
|
||||
Map option: NERDTreeMapJumpNextSibling
|
||||
Applies to: files and directories.
|
||||
|
||||
If a dir node is selected, jump to the next sibling of that node.
|
||||
If a file node is selected, jump to the next sibling of that nodes parent.
|
||||
Jump to the next sibling of the selected node.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTree-c-k*
|
||||
@@ -353,8 +408,7 @@ Default key: <C-k>
|
||||
Map option: NERDTreeMapJumpPrevSibling
|
||||
Applies to: files and directories.
|
||||
|
||||
If a dir node is selected, jump to the previous sibling of that node.
|
||||
If a file node is selected, jump to the previous sibling of that nodes parent.
|
||||
Jump to the previous sibling of the selected node.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTree-C*
|
||||
@@ -423,7 +477,7 @@ Default key: f
|
||||
Map option: NERDTreeMapToggleFilters
|
||||
Applies to: no restrictions.
|
||||
|
||||
Toggles whether file filters are used. See |NERDTreeIgnore| for details.
|
||||
Toggles whether file filters are used. See |'NERDTreeIgnore'| for details.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTree-F*
|
||||
@@ -433,6 +487,14 @@ Applies to: no restrictions.
|
||||
|
||||
Toggles whether file nodes are displayed.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTree-B*
|
||||
Default key: B
|
||||
Map option: NERDTreeMapToggleBookmarks
|
||||
Applies to: no restrictions.
|
||||
|
||||
Toggles whether the bookmarks table is displayed.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTree-q*
|
||||
Default key: q
|
||||
@@ -499,53 +561,53 @@ then id be grateful if you'd email me.
|
||||
The script provides the following options that can customise the behaviour the
|
||||
NERD tree. These options should be set in your vimrc.
|
||||
|
||||
|loaded_nerd_tree| Turns off the script.
|
||||
|'loaded_nerd_tree'| Turns off the script.
|
||||
|
||||
|NERDChristmasTree| Tells the NERD tree to make itself colourful
|
||||
|'NERDChristmasTree'| Tells the NERD tree to make itself colourful
|
||||
and pretty.
|
||||
|
||||
|NERDTreeAutoCenter| Controls whether the NERD tree window centers
|
||||
|'NERDTreeAutoCenter'| Controls whether the NERD tree window centers
|
||||
when the cursor moves within a specified
|
||||
distance to the top/bottom of the window.
|
||||
|NERDTreeAutoCenterThreshold| Controls the sensitivity of autocentering.
|
||||
|'NERDTreeAutoCenterThreshold'| Controls the sensitivity of autocentering.
|
||||
|
||||
|NERDTreeCaseSensitiveSort| Tells the NERD tree whether to be case
|
||||
|'NERDTreeCaseSensitiveSort'| Tells the NERD tree whether to be case
|
||||
sensitive or not when sorting nodes.
|
||||
|
||||
|NERDTreeChDirMode| Tells the NERD tree if/when it should change
|
||||
|'NERDTreeChDirMode'| Tells the NERD tree if/when it should change
|
||||
vim's current working directory.
|
||||
|
||||
|NERDTreeHighlightCursorline| Tell the NERD tree whether to highlight the
|
||||
|'NERDTreeHighlightCursorline'| Tell the NERD tree whether to highlight the
|
||||
current cursor line.
|
||||
|
||||
|NERDTreeIgnore| Tells the NERD tree which files to ignore.
|
||||
|'NERDTreeIgnore'| Tells the NERD tree which files to ignore.
|
||||
|
||||
|NERDTreeBookmarksFile| Where the bookmarks are stored.
|
||||
|'NERDTreeBookmarksFile'| Where the bookmarks are stored.
|
||||
|
||||
|NERDTreeMouseMode| Tells the NERD tree how to handle mouse
|
||||
|'NERDTreeMouseMode'| Tells the NERD tree how to handle mouse
|
||||
clicks.
|
||||
|
||||
|NERDTreeShowFiles| Tells the NERD tree whether to display files
|
||||
|'NERDTreeQuitOnOpen'| Closes the tree window after opening a file.
|
||||
|
||||
|'NERDTreeShowBookmarks'| Tells the NERD tree whether to display the
|
||||
bookmarks table on startup.
|
||||
|
||||
|'NERDTreeShowFiles'| Tells the NERD tree whether to display files
|
||||
in the tree on startup.
|
||||
|
||||
|NERDTreeShowHidden| Tells the NERD tree whether to display hidden
|
||||
|'NERDTreeShowHidden'| Tells the NERD tree whether to display hidden
|
||||
files on startup.
|
||||
|
||||
|NERDTreeShowLineNumbers| Tells the NERD tree whether to display line
|
||||
|'NERDTreeShowLineNumbers'| Tells the NERD tree whether to display line
|
||||
numbers in the tree window.
|
||||
|
||||
|NERDTreeSortOrder| Tell the NERD tree how to sort the nodes in
|
||||
|'NERDTreeSortOrder'| Tell the NERD tree how to sort the nodes in
|
||||
the tree.
|
||||
|
||||
|NERDTreeSplitVertical| Tells the script whether the NERD tree should
|
||||
be created by splitting the window vertically
|
||||
or horizontally.
|
||||
|
||||
|NERDTreeWinPos| Tells the script where to put the NERD tree
|
||||
|'NERDTreeWinPos'| Tells the script where to put the NERD tree
|
||||
window.
|
||||
|
||||
|
||||
|NERDTreeWinSize| Sets the window size when the NERD tree is
|
||||
|'NERDTreeWinSize'| Sets the window size when the NERD tree is
|
||||
opened.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
@@ -554,13 +616,13 @@ NERD tree. These options should be set in your vimrc.
|
||||
To enable any of the below options you should put the given line in your
|
||||
~/.vimrc
|
||||
|
||||
*loaded_nerd_tree*
|
||||
*'loaded_nerd_tree'*
|
||||
If this plugin is making you feel homicidal, it may be a good idea to turn it
|
||||
off with this line in your vimrc: >
|
||||
let loaded_nerd_tree=1
|
||||
<
|
||||
------------------------------------------------------------------------------
|
||||
*NERDChristmasTree*
|
||||
*'NERDChristmasTree'*
|
||||
Values: 0 or 1.
|
||||
Default: 1.
|
||||
|
||||
@@ -570,12 +632,12 @@ added to the nerd tree to make it more colourful.
|
||||
Set it to 0 for a more vanilla looking tree.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeAutoCenter*
|
||||
*'NERDTreeAutoCenter'*
|
||||
Values: 0 or 1.
|
||||
Default: 1
|
||||
|
||||
If set to 1, the NERD tree window will center around the cursor if it moves to
|
||||
within |NERDTreeAutoCenterThreshold| lines of the top/bottom of the window.
|
||||
within |'NERDTreeAutoCenterThreshold'| lines of the top/bottom of the window.
|
||||
|
||||
This is ONLY done in response to tree navigation mappings,
|
||||
i.e. |NERDTree-J| |NERDTree-K| |NERDTree-C-J| |NERDTree-c-K| |NERDTree-p|
|
||||
@@ -584,15 +646,15 @@ i.e. |NERDTree-J| |NERDTree-K| |NERDTree-C-J| |NERDTree-c-K| |NERDTree-p|
|
||||
The centering is done with a |zz| operation.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeAutoCenterThreshold*
|
||||
*'NERDTreeAutoCenterThreshold'*
|
||||
Values: Any natural number.
|
||||
Default: 3
|
||||
|
||||
This option controls the "sensitivity" of the NERD tree auto centering. See
|
||||
|NERDTreeAutoCenter| for details.
|
||||
|'NERDTreeAutoCenter'| for details.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeCaseSensitiveSort*
|
||||
*'NERDTreeCaseSensitiveSort'*
|
||||
Values: 0 or 1.
|
||||
Default: 0.
|
||||
|
||||
@@ -613,10 +675,10 @@ account. The above nodes would then be sorted like this: >
|
||||
boner.c
|
||||
<
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeChDirMode*
|
||||
*'NERDTreeChDirMode'*
|
||||
|
||||
Values: 0, 1 or 2.
|
||||
Default: 1.
|
||||
Default: 0.
|
||||
|
||||
Use this option to tell the script when (if at all) to change the current
|
||||
working directory (CWD) for vim.
|
||||
@@ -635,13 +697,8 @@ the CWD is changed whenever the tree root is changed. For example, if the CWD
|
||||
is /home/marty/foobar and you make the node for /home/marty/foobar/baz the new
|
||||
root then the CWD will become /home/marty/foobar/baz.
|
||||
|
||||
Authors note: at work i have this option set to 1 because i have a giant ctags
|
||||
file in the root dir of my project. This way i can initialise the NERD tree
|
||||
with the root dir of my project and always have ctags available to me --- no
|
||||
matter where i go with the NERD tree.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeHighlightCursorline*
|
||||
*'NERDTreeHighlightCursorline'*
|
||||
Values: 0 or 1.
|
||||
Default: 1.
|
||||
|
||||
@@ -649,13 +706,14 @@ If set to 1, the current cursor line in the NERD tree buffer will be
|
||||
highlighted. This is done using the |cursorline| option.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeIgnore*
|
||||
*'NERDTreeIgnore'*
|
||||
Values: a list of regular expressions.
|
||||
Default: ['\~$'].
|
||||
|
||||
This option is used to specify which files the NERD tree should ignore. It
|
||||
must be a list of regular expressions. When the NERD tree is rendered, any
|
||||
files/dirs that match any of the regex's in NERDTreeIgnore wont be displayed.
|
||||
files/dirs that match any of the regex's in 'NERDTreeIgnore' wont be
|
||||
displayed.
|
||||
|
||||
For example if you put the following line in your vimrc: >
|
||||
let NERDTreeIgnore=['\.vim$', '\~$']
|
||||
@@ -671,14 +729,14 @@ The file filters can be turned on and off dynamically with the |NERDTree-f|
|
||||
mapping.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeBookmarksFile*
|
||||
*'NERDTreeBookmarksFile'*
|
||||
Values: a path
|
||||
Default: $HOME/.NERDTreeBookmarks
|
||||
|
||||
This is where bookmarks are saved. See |NERDTreeBookmarkCommands|.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeMouseMode*
|
||||
*'NERDTreeMouseMode'*
|
||||
Values: 1, 2 or 3.
|
||||
Default: 1.
|
||||
|
||||
@@ -696,31 +754,50 @@ then (to single click activate it) you must click somewhere in
|
||||
'application.rb'.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeShowFiles*
|
||||
*'NERDTreeQuitOnOpen'*
|
||||
|
||||
Values: 0 or 1.
|
||||
Default: 0
|
||||
|
||||
If set to 1, the NERD tree window will close after opening a file with the
|
||||
|NERDTree-o| or |NERDTree-tab| mappings.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*'NERDTreeShowBookmarks'*
|
||||
Values: 0 or 1.
|
||||
Default: 0.
|
||||
|
||||
If this option is set to 1 then the bookmarks table will be displayed.
|
||||
|
||||
This option can be toggled dynamically, per tree, with the |NERDTree-B|
|
||||
mapping.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*'NERDTreeShowFiles'*
|
||||
Values: 0 or 1.
|
||||
Default: 1.
|
||||
|
||||
If this option is set to 1 then files are displayed in the NERD tree. If it is
|
||||
set to 0 then only directories are displayed.
|
||||
|
||||
This option can be toggled dynamically with the |NERDTree-F| mapping and is
|
||||
useful for drastically shrinking the tree when you are navigating to a
|
||||
different part of the tree.
|
||||
This option can be toggled dynamically, per tree, with the |NERDTree-F|
|
||||
mapping and is useful for drastically shrinking the tree when you are
|
||||
navigating to a different part of the tree.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeShowHidden*
|
||||
*'NERDTreeShowHidden'*
|
||||
Values: 0 or 1.
|
||||
Default: 0.
|
||||
|
||||
This option tells vim whether to display hidden files by default. This option
|
||||
can be dynamically toggled with the |NERDTree-H| mapping.
|
||||
Use one of the follow lines to set this option: >
|
||||
can be dynamically toggled, per tree, with the |NERDTree-H| mapping. Use one
|
||||
of the follow lines to set this option: >
|
||||
let NERDTreeShowHidden=0
|
||||
let NERDTreeShowHidden=1
|
||||
<
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeShowLineNumbers*
|
||||
*'NERDTreeShowLineNumbers'*
|
||||
Values: 0 or 1.
|
||||
Default: 0.
|
||||
|
||||
@@ -731,7 +808,7 @@ window. Use one of the follow lines to set this option: >
|
||||
<
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeSortOrder*
|
||||
*'NERDTreeSortOrder'*
|
||||
Values: a list of regular expressions.
|
||||
Default: ['\/$', '*', '\.swp$', '\.bak$', '\~$']
|
||||
|
||||
@@ -746,8 +823,8 @@ all .h files. All files containing the string 'foobar' will be placed at the
|
||||
end. The star is a special flag: it tells the script that every node that
|
||||
doesnt match any of the other regexps should be placed here.
|
||||
|
||||
If no star is present in NERDTreeSortOrder then one is automatically appended
|
||||
to the array.
|
||||
If no star is present in 'NERDTreeSortOrder' then one is automatically
|
||||
appended to the array.
|
||||
|
||||
The regex '\/$' should be used to match directory nodes.
|
||||
|
||||
@@ -764,36 +841,22 @@ Other examples: >
|
||||
backup files will appear last with everything else preceding them.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeSplitVertical*
|
||||
Values: 0 or 1.
|
||||
Default: 1.
|
||||
*'NERDTreeWinPos'*
|
||||
Values: "left", "right", "top" or "bottom"
|
||||
Default: "left".
|
||||
|
||||
This option, along with |NERDTreeWinPos|, is used to determine where the NERD
|
||||
tree window appears.
|
||||
This option is used to determine where NERD tree window is placed on the
|
||||
screen.
|
||||
|
||||
If it is set to 1 then the NERD tree window will appear on either the left or
|
||||
right side of the screen (depending on the |NERDTreeWinPos| option).
|
||||
|
||||
If it set to 0 then the NERD tree window will appear at the top of the screen.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeWinPos*
|
||||
Values: 0 or 1.
|
||||
Default: 1.
|
||||
|
||||
This option works in conjunction with the |NERDTreeSplitVertical| option to
|
||||
determine where NERD tree window is placed on the screen.
|
||||
|
||||
If the option is set to 1 then the NERD tree will appear on the left or top of
|
||||
the screen (depending on the value of |NERDTreeSplitVertical|). If set to 0,
|
||||
the window will appear on the right or bottom of the screen.
|
||||
"top" or "bottom", will cause a horizontal split to be created for the tree,
|
||||
while "left" and "right" will cause a vertical split.
|
||||
|
||||
This option is makes it possible to use two different explorer type
|
||||
plugins simultaneously. For example, you could have the taglist plugin on the
|
||||
left of the window and the NERD tree on the right.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
*NERDTreeWinSize*
|
||||
*'NERDTreeWinSize'*
|
||||
Values: a positive integer.
|
||||
Default: 31.
|
||||
|
||||
@@ -828,10 +891,7 @@ Window manager integration?
|
||||
6. The Author *NERDTreeAuthor*
|
||||
|
||||
The author of the NERD tree is a terrible terrible monster called Martyzilla
|
||||
who gobbles up small children with milk and sugar for breakfast. He has an odd
|
||||
love/hate relationship with computers (but monsters hate everything by nature
|
||||
you know...) which can be awkward for him since he is a pro computer nerd for
|
||||
a living.
|
||||
who gobbles up small children with milk and sugar for breakfast.
|
||||
|
||||
He can be reached at martin_grenfell at msn.com. He would love to hear from
|
||||
you, so feel free to send him suggestions and/or comments about this plugin.
|
||||
@@ -841,6 +901,94 @@ fridge for later ;)
|
||||
==============================================================================
|
||||
7. Changelog *NERDTreeChangelog*
|
||||
|
||||
2.14.3
|
||||
Thanks to tpope for the following:
|
||||
- use relative paths when doing edit commands if possible (useful if you
|
||||
have %f on your statusline for example)
|
||||
- allow relative paths for :NERDTree commands, eg ":NERDTree ../foo"
|
||||
- fix a bug where the script used the directory of the current buffer
|
||||
instead of vims cwd for the :NERDTree command
|
||||
- bugfix for read only node highlighting
|
||||
|
||||
2.14.2
|
||||
- when opening a file (with 'o' or double click) dont split the window
|
||||
unless we absolutely have to. This should make the script work better
|
||||
with other explorer plugins. Thanks to Ryan Penn, Simon Peter Nicholls
|
||||
and Michael
|
||||
- fix a bug where directories starting with a '+' char could not be opened.
|
||||
Thanks to Tomasz Chomiuk.
|
||||
- fix a bug where closing vim with :qa with a tree open in another tab
|
||||
would break, thanks to Denis Pokataev.
|
||||
- compatibility bugfix for older versions of vim, thanks to knekk for
|
||||
helping me track it down and to Sean Chou.
|
||||
|
||||
2.14.1
|
||||
- dont clobber &cpo. Thanks to godlygeek for the bug report.
|
||||
|
||||
2.14.0
|
||||
- fix a bug where the <c-w>o mapping would cause the tree window to be
|
||||
incorrectly sized when reopened.
|
||||
- add keymapping to delete bookmarks from the bookmarks table, see
|
||||
:help NERDTree-D
|
||||
- lots of refactoring
|
||||
2.13.0
|
||||
- make NERDTreeChDir option default to 0 (i.e. never change vims current
|
||||
working dir by default)
|
||||
- when moving/deleting nodes with the filesystem menu, move/delete any
|
||||
associated bookmarks
|
||||
- make the t/T on directory nodes open a fresh NERD tree for the selected
|
||||
dir in a new tab, rather than a netrw.
|
||||
- place the cursor at the top of the bookmarks table when opening it with B
|
||||
- make NERDTreeQuitOnOpen option work with the g<tab> and go mappings,
|
||||
thanks to Maxim Kim for the bug report
|
||||
- change how invalid bookmarks are handled. Now they are not deleted. If a
|
||||
bookmark is malformed (in the bookmarks file) or points to an
|
||||
invalid/nonexisting location then print an error and place the offending
|
||||
bookmarks at the bottom of the bookmarks file. See :help
|
||||
|NERDTreeInvalidBookmarks| for info. Thanks to Zhang Shuhan for the
|
||||
suggestion and the testing.
|
||||
- fix a bug with the 'o' mapping that occurred when opening a new buffer
|
||||
for a file whose name was a substring of an already open file. Thanks to
|
||||
Charlton Wang for the report.
|
||||
- stop the script from going into an infinite loop when it tries to cache
|
||||
a named pipe. Thanks to Charlton Wang for the report.
|
||||
|
||||
2.12.0
|
||||
- added a UI for bookmarks. See :help NERDTreeBookmarkTable for details.
|
||||
Thanks to Zhang Shuhan for testing and bug reports.
|
||||
- relaxed the restrictions on bookmark names, now the only restriction is
|
||||
that they cant contain spaces. This allows for e.g. Chinese bookmark
|
||||
names. Thanks to Zhang Shuhan for the suggestion.
|
||||
- combined the NERDTreeWinPos and NERDTreeSplitVertical options. See :help
|
||||
NERDTreeWinPos.
|
||||
- applied a patch from Matan Nassau to add the NERDTreeQuitOnOpen option
|
||||
which closes the tree window after opening a file. See :help
|
||||
NERDTreeQuitOnOpen.
|
||||
- optimised the nerd tree rendering. Now it takes just over 1/3 of the
|
||||
time it previously took to render.
|
||||
- now the tree filter mappings toggle the filters "per tree" rather than
|
||||
globally. The global filter variables are used to set the initial filter
|
||||
settings for each new NERD tree.
|
||||
- fix to window resizing when opening a file when NERD tree is the only
|
||||
window open
|
||||
- other fixes
|
||||
|
||||
2.11.0
|
||||
- changes to the 'o' mapping when opening files:
|
||||
- dont clobber "special" windows (eg taglist/quickfix/etc). This should
|
||||
make the NERD tree play nicer with other explorer plugins. Thanks to
|
||||
Yuan Jiang for the suggestion.
|
||||
- if the file is already open in the current tab, just move the cursor
|
||||
to that window
|
||||
- highlight executable files, made some slight changes to other
|
||||
highlighting
|
||||
- if the user resizes the tree window, keep that new size. Dont reset to
|
||||
the default during the <tab> mapping, or :NERDTreeToggle command. Only
|
||||
reset the size if a fresh tree is started with :NERDTree.
|
||||
- remove the "magic" functionality from the <c-j>/<c-k> mappings (it was
|
||||
more confusing than helpful)
|
||||
- other minor fixes
|
||||
|
||||
2.10.0
|
||||
- added bookmarks, see :help NERDTreeBookmarkCommands for details. Thanks
|
||||
to Piotr Czachur for all his testing and suggestions.
|
||||
@@ -893,9 +1041,9 @@ fridge for later ;)
|
||||
and you use <c-j/k> the cursor will jump to its PARENTS next/previous
|
||||
sibling. Go :help NERDTree-c-j and :help NERDTree-c-k for info.
|
||||
- Extended the behaviour of the J/K mappings. Now if the cursor is on the
|
||||
last child of a node and you push J/K it will jump down to the last child
|
||||
of the next/prev of its parents siblings that is open and has children.
|
||||
Go :help NERDTree-J and :help NERDTree-K for info.
|
||||
last child of a node and you push J/K it will jump down to the last
|
||||
child of the next/prev of its parents siblings that is open and has
|
||||
children. Go :help NERDTree-J and :help NERDTree-K for info.
|
||||
- The goal of these changes is to make tree navigation faster.
|
||||
- Reorganised the help page a bit.
|
||||
- Removed the E mapping.
|
||||
@@ -935,8 +1083,8 @@ fridge for later ;)
|
||||
- Tree navigation changes:
|
||||
- Added J and K mappings to jump to last/first child of the current dir.
|
||||
Options to customise these mappings have also been added.
|
||||
- Remapped the jump to next/prev sibling commands to be <C-j> and <C-k> by
|
||||
default.
|
||||
- Remapped the jump to next/prev sibling commands to be <C-j> and <C-k>
|
||||
by default.
|
||||
These changes should hopefully make tree navigation mappings easier to
|
||||
remember and use as the j and k keys are simply reused 3 times (twice
|
||||
with modifier keys).
|
||||
@@ -1078,7 +1226,8 @@ Thanks to Olivier Yiptong for prompting me to make line numbers in the
|
||||
NERD tree window optional.
|
||||
|
||||
Thanks to Zhang Shuhan for all of his emails and testing to help improve the
|
||||
NERD tree path handling.
|
||||
NERD tree path handling. Thanks also for suggesting the bookmarks gui, and for
|
||||
testing and his many suggestions and bugreports about bookmarks.
|
||||
|
||||
Thanks to Cory Echols for sending a patch to add the :NERDTreeClose command and
|
||||
set the NERD tree buffers filetype to 'nerdtree'
|
||||
@@ -1086,6 +1235,36 @@ set the NERD tree buffers filetype to 'nerdtree'
|
||||
Thanks to Piotr Czachur for all his suggestions and testing for the bookmarks
|
||||
feature.
|
||||
|
||||
Thanks to Yuan Jiang for suggesting the "o" mapping shouldnt clobber "special"
|
||||
windows, like taglist.
|
||||
|
||||
Thanks to Matan Nassau for the patch to add the NERDTreeQuitOnOpen option.
|
||||
|
||||
Thanks to Maxim Kim for reporting a bug with g<tab> and go mappings when
|
||||
NERDTreeQuitOnOpen was set.
|
||||
|
||||
Thanks to Charlton Wang for reporting bugs with the 'o' mapping and with
|
||||
handling named pipes.
|
||||
|
||||
Chur to godlygeek for reporting a bug where &cpo was getting clobbered.
|
||||
|
||||
Cheers to knekk for helping me track down a bug when overwriting dictionary
|
||||
keys that only occurred in some versions of vim.
|
||||
|
||||
Thanks also to Sean Chou for the bug report about the above bug.
|
||||
|
||||
Thanks to Ryan Penn, Simon Peter Nicholls and Michael for pointing out an issue
|
||||
where the script was splitting constantly when using the 'o' mapping while
|
||||
other explorers were open.
|
||||
|
||||
Thanks to Tomasz Chomiuk for the bug report about the script failing when dir
|
||||
names began with a +.
|
||||
|
||||
Thanks to Denis Pokataev for the bug report about the script failing when
|
||||
closing vim with :qa with a tree open in another tab.
|
||||
|
||||
Thanks to tpope for his dope bug reporting.
|
||||
|
||||
==============================================================================
|
||||
9. License *NERDTreeLicense*
|
||||
|
||||
|
||||
2623
plugin/NERD_tree.vim
2623
plugin/NERD_tree.vim
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user