When searching for root line num, stop at the end of the file. (#1015)

* When searching for root line num, stop at the end of the file.

When using the following NERDTreeStatusLine, Vim would lock up and not
work anymore. The problem was that when trying to find the root line
number, the loop was continuing past the end of the file, looping
"forever". The fix was to simply stop at the end of the file.

let g:NERDTreeStatusline = "%{exists('g:NERDTreeFileNode')&&" .
      \ "has_key(g:NERDTreeFileNode.GetSelected(),'path')?" .
      \ "g:NERDTreeFileNode.GetSelected().path.getLastPathComponent(0):''}"

* Update change log.

.github/ISSUE_TEMPLATE/bug.md

@@ -22,9 +22,8 @@ After reading, and before submitting your issue, please remove this introductory
 
 #### Environment (for bug reports)
 - [ ] Operating System: 
-- [ ] Vim/Neovim version `:version`: 
+- [ ] Vim/Neovim version `:echo v:version`: 
-- [ ] NERDTree version `git rev-parse --short HEAD`: 
+- [ ] NERDTree version, found on 1st line in NERDTree quickhelp `?`: 
-- [ ] A link to my [vimrc](), or
 - [ ] vimrc settings
     - [ ] NERDTree variables
     ```vim

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,22 +1,20 @@
-<!-- Enter the issue number this PR addresses below. If none, remove the line. -->
 ### Description of Changes
+Closes #  <!-- Issue number this PR addresses. If none, remove this line. -->
 
-Closes #
 
 ---
 ### New Version Info
 
 - [ ] Derive a new version number. Increment the:
-    - [ ] `MAJOR` version when you make incompatible API changes,
+    - [ ] `MAJOR` version when you make incompatible API changes
-    - [ ] `MINOR` version when you add functionality in a backwards-compatible manner, and
+    - [ ] `MINOR` version when you add functionality in a backwards-compatible manner
-    - [ ] `PATCH` version when you make backwards-compatible bug fixes.
+    - [ ] `PATCH` version when you make backwards-compatible bug fixes
-- [ ] Update version number in [autoload/nerdtree.vim](https://github.com/scrooloose/nerdtree/blob/master/autoload/nerdtree.vim#L7)
+- [ ] Update [CHANGELOG.md](https://github.com/scrooloose/nerdtree/blob/master/CHANGELOG.md), following this format/example:
-- [ ] Update the ChangeLog, following this format/example:
     ```
-    MAJOR.MINOR...
+    #### MAJOR.MINOR...
     - **.PATCH**: PR Title (Author) #PR Number
 
-    ### 5.1...
+    #### 5.1...
-    - **.1**: Update Changelog and create PR Template (@PhilRunninger) #1007
+    - **.1**: Update Changelog and create PR Template (PhilRunninger) #1007
     - **.0**: Too many changes for one patch...
     ```

CHANGELOG.md

@@ -1,118 +1,125 @@
 # Change Log
 
-### 5.1...
+#### 5.2...
-- **`.2`**: Fix NERDTree opening with the wrong size. (@PhilRunninger) #1008
+- **.4**: When searching for root line num, stop at end of file. (PhilRunninger) #1015
-- **`.1`**: Update Changelog and create PR Template (@PhilRunninger) #1007
+- **.3**: Fix `<CR>` key map on the bookmark (lkebin) #1014
-- **`.0`**: Too many changes for one patch...
+- **.2**: Make Enter work on the `.. ( up a dir )` line (PhilRunninger) #1013
-    - Refresh a dir_node if the file wasn't found in it, and look once more. (@PhilRunninger) #1005
+- **.1**: Fix nerdtree#version() on Windows. (PhilRunninger) N/A
-    - Add a "copy path to clipboard" menu option (@PhilRunninger) #1002
+- **.0**: Expand functionality of `<CR>` mapping. (PhilRunninger) #1011
-    - Enable root refresh on "vim ." a different way than #999. (@PhilRunninger) #1001
+#### 5.1...
-    - Fix refreshroot (@PhilRunninger) #999
+- **.3**: Remove @mentions from PR template and change log. They weren't working. (PhilRunninger) #1009
-    - Change version check to look for 703 not 730 (@vhalis) #994
+- **.2**: Fix NERDTree opening with the wrong size. (PhilRunninger) #1008
-    - Change minimum vim (@PhilRunninger) #991
+- **.1**: Update Changelog and create PR Template (PhilRunninger) #1007
-    - Allow multi-character DirArrows (@PhilRunninger) #985
+- **.0**: Too many changes for one patch...
-    - Remove redraw! while still clearing last message empty string. (@PhilRunninger) #979
+    - Refresh a dir_node if the file wasn't found in it, and look once more. (PhilRunninger) #1005
-    - fix _initChildren function value set to numChildrenCached error (@terryding77) #969
+    - Add a "copy path to clipboard" menu option (PhilRunninger) #1002
-    - On Windows, do a case-insensitive comparison of paths. (@PhilRunninger) #967
+    - Enable root refresh on "vim ." a different way than #999. (PhilRunninger) #1001
-    - Remove the "Please wait... DONE" messages. (@PhilRunninger) #966
+    - Fix refreshroot (PhilRunninger) #999
-    - Smarter delimiter default (@PhilRunninger) #963
+    - Change version check to look for 703 not 730 (vhalis) #994
-    - Update directory .vimdc readme example (@spencerdcarlson) #961
+    - Change minimum vim (PhilRunninger) #991
-    - Preview bookmarks (@PhilRunninger) #956
+    - Allow multi-character DirArrows (PhilRunninger) #985
-    - Add new value to NERDTreeQuitOnOpen to close bookmark table (@PhilRunninger) #955
+    - Remove redraw! while still clearing last message empty string. (PhilRunninger) #979
-    - Add an :EditBookmarks command to edit the bookmarks file (@PhilRunninger) #954
+    - fix _initChildren function value set to numChildrenCached error (terryding77) #969
-    - Before copying, turn off &shellslash. Restore after copy is finished. (@PhilRunninger) #952
+    - On Windows, do a case-insensitive comparison of paths. (PhilRunninger) #967
-    - Set a maximum window size when zooming. (@PhilRunninger) #950
+    - Remove the "Please wait... DONE" messages. (PhilRunninger) #966
-    - Confirm the wipeout of a unsaved buffer whose file has been renamed. (@PhilRunninger) #949
+    - Smarter delimiter default (PhilRunninger) #963
-    - Escape a backslash so it can be used in a key mapping. (@PhilRunninger) #948
+    - Update directory .vimdc readme example (spencerdcarlson) #961
-    - Add a NERDTreeMinimalMenu feature (@tuzz) #938
+    - Preview bookmarks (PhilRunninger) #956
-    - fixed root path error for windows (@zcodes) #935
+    - Add new value to NERDTreeQuitOnOpen to close bookmark table (PhilRunninger) #955
-    - Restore getDirChildren for use in nerdtree-project-plugin. (@PhilRunninger) #929
+    - Add an :EditBookmarks command to edit the bookmarks file (PhilRunninger) #954
-    - Document NERDTreeNodeDelimiter #912 (@PhilRunninger) #926
+    - Before copying, turn off &shellslash. Restore after copy is finished. (PhilRunninger) #952
-    - Allow modification of menu keybindings (@Leandros) #923
+    - Set a maximum window size when zooming. (PhilRunninger) #950
-    - Add two more disqualifications for isCascadable(). (@PhilRunninger) #914
+    - Confirm the wipeout of a unsaved buffer whose file has been renamed. (PhilRunninger) #949
-    - Allow highlighting more than one flag. (@kristijanhusak) #908
+    - Escape a backslash so it can be used in a key mapping. (PhilRunninger) #948
-    - Support sorting files and directories by modification time. (@PhilRunninger) #901
+    - Add a NERDTreeMinimalMenu feature (tuzz) #938
-    - Parse . and .. from path string with trailing slash. (@PhilRunninger) #899
+    - fixed root path error for windows (zcodes) #935
-    - Force sort to recalculate the cached sortKey. (@PhilRunninger) #898
+    - Restore getDirChildren for use in nerdtree-project-plugin. (PhilRunninger) #929
-    - Add NERDTreeRefreshRoot command (@wgfm) #897
+    - Document NERDTreeNodeDelimiter #912 (PhilRunninger) #926
-    - Call Resolve on the file's path when calling :NERDTreeFind. (@PhilRunninger) #896
+    - Allow modification of menu keybindings (Leandros) #923
-    - Catch all errors, not just NERDTree errors. (@PhilRunninger) #894
+    - Add two more disqualifications for isCascadable(). (PhilRunninger) #914
-    - Fix typo in help file (@lvoisin) #892
+    - Allow highlighting more than one flag. (kristijanhusak) #908
-    - Make NERDTreeCreator set the `'nolist'` option (@lifecrisis) #889
+    - Support sorting files and directories by modification time. (PhilRunninger) #901
-    - Refresh buffers after `m`, `m` operation on a folder (@PhilRunninger) #888
+    - Parse . and .. from path string with trailing slash. (PhilRunninger) #899
-    - Use a better arg for FINDSTR when using the m,l command in Windows. (@PhilRunninger) #887
+    - Force sort to recalculate the cached sortKey. (PhilRunninger) #898
-    - Fix the <C-J>/<C-K> motions, which currently fail with cascades (@lifecrisis) #886
+    - Add NERDTreeRefreshRoot command (wgfm) #897
-    - Function "s:UI.getLineNum()" doesn't always work on cascades. (@lifecrisis) #882
+    - Call Resolve on the file's path when calling :NERDTreeFind. (PhilRunninger) #896
-    - NERDTreeCWD: reset CWD if changed by NERDTreeFocus (@PhilRunninger) #878
+    - Catch all errors, not just NERDTree errors. (PhilRunninger) #894
-    - Use <count>tabnext instead of <count>gt to allow users to remap gt. (@PhilRunninger) #877
+    - Fix typo in help file (lvoisin) #892
-    - Do a case sensitive comparison of new/existing buffers. (@PhilRunninger) #875
+    - Make NERDTreeCreator set the `'nolist'` option (lifecrisis) #889
-    - Fix opening sub-directories that have commas in their name. (@PhilRunninger) #873
+    - Refresh buffers after `m`, `m` operation on a folder (PhilRunninger) #888
-    - Add new command to open NERDTree in the root of a VCS repository. (@PhilRunninger) #872
+    - Use a better arg for FINDSTR when using the m,l command in Windows. (PhilRunninger) #887
-    - Make sure the path to the bookmarks file exists before writing it. (@PhilRunninger) #871
+    - Fix the <C-J>/<C-K> motions, which currently fail with cascades (lifecrisis) #886
-    - Unzoom NERDTree when opening a file (@PhilRunninger) #870
+    - Function "s:UI.getLineNum()" doesn't always work on cascades. (lifecrisis) #882
-    - Support unusual characters in file and directory names (@PhilRunninger) #868
+    - NERDTreeCWD: reset CWD if changed by NERDTreeFocus (PhilRunninger) #878
-    - Reword renamed-buffer prompt to be more clear (@aflock) #867
+    - Use <count>tabnext instead of <count>gt to allow users to remap gt. (PhilRunninger) #877
-    - Default to placing cursor on root when closing bookmark table (@lifecrisis) #866
+    - Do a case sensitive comparison of new/existing buffers. (PhilRunninger) #875
-    - Fix issues with sorting of nodes (@PhilRunninger) #856
+    - Fix opening sub-directories that have commas in their name. (PhilRunninger) #873
-    - Better OSX detection (@bubba-h57) #853
+    - Add new command to open NERDTree in the root of a VCS repository. (PhilRunninger) #872
-    - Bugfix - ensure keymaps dictionary exists before using it (@mnussbaum) #852
+    - Make sure the path to the bookmarks file exists before writing it. (PhilRunninger) #871
-    - Decrease startup-time by avoiding linear-time iteration over key mappings (@mnussbaum) #851
+    - Unzoom NERDTree when opening a file (PhilRunninger) #870
-    - Add code to sort mappings in quickhelp (@lifecrisis) #849
+    - Support unusual characters in file and directory names (PhilRunninger) #868
-    - Use ":clearjumps" in new NERDTree windows (@lifecrisis) #844
+    - Reword renamed-buffer prompt to be more clear (aflock) #867
-    - Like m-c did before, create parent directories if needed on m-m. (@PhilRunninger) #840
+    - Default to placing cursor on root when closing bookmark table (lifecrisis) #866
-    - BUGFIX: Repair a problem with the `'u'` mapping. (@lifecrisis) #838
+    - Fix issues with sorting of nodes (PhilRunninger) #856
-    - Make the NERDTree buffer writable when rendering it. (@PhilRunninger) #837
+    - Better OSX detection (bubba-h57) #853
-    - Code cleanup: Remove unsupported bookmark table mappings (@lifecrisis) #835
+    - Bugfix - ensure keymaps dictionary exists before using it (mnussbaum) #852
-    - Replace strcharpart() with substitute() for backward compatibility (@bravestarr) #834
+    - Decrease startup-time by avoiding linear-time iteration over key mappings (mnussbaum) #851
-    - Fixed error `unknown function strcharpart` for older versions of Vim (@hav4ik) #833
+    - Add code to sort mappings in quickhelp (lifecrisis) #849
-    - Clear output when NERDTree menu is aborted (@lifecrisis) #832
+    - Use ":clearjumps" in new NERDTree windows (lifecrisis) #844
-    - Display a path with multi-byte characters correctly when it is truncated (@bravestarr) #830
+    - Like m-c did before, create parent directories if needed on m-m. (PhilRunninger) #840
-    - Support revealing file and executing file with xdg-open for Linux (@ngnmhieu) #824
+    - BUGFIX: Repair a problem with the `'u'` mapping. (lifecrisis) #838
-    - If node isn't open, count children on disk before deleting. (@PhilRunninger) #822
+    - Make the NERDTree buffer writable when rendering it. (PhilRunninger) #837
-    - Add new variable g:NERDTreeRemoveFileCmd (@kutsan) #816
+    - Code cleanup: Remove unsupported bookmark table mappings (lifecrisis) #835
-    - Use a better check for existence of the NERDTree buffer. (@PhilRunninger) #814
+    - Replace strcharpart() with substitute() for backward compatibility (bravestarr) #834
-    - Fix focussing previous buffer when closing NERDTree (@mrubli) #801
+    - Fixed error `unknown function strcharpart` for older versions of Vim (hav4ik) #833
-    - Update the docs for "NERDTreeStatusline" (@lifecrisis) #796
+    - Clear output when NERDTree menu is aborted (lifecrisis) #832
-    - BUGFIX: Unstable behavior in the "getPath()" method (@lifecrisis) #795
+    - Display a path with multi-byte characters correctly when it is truncated (bravestarr) #830
-    - Revert the bugfix from pull request #785 (@lifecrisis) #794
+    - Support revealing file and executing file with xdg-open for Linux (ngnmhieu) #824
-    - BUGFIX: Allow ":NERDTreeFind" to discover hidden files (@lifecrisis) #786
+    - If node isn't open, count children on disk before deleting. (PhilRunninger) #822
-    - BUGFIX: Allow ":NERDTreeFind" to reveal new files (@lifecrisis) #785
+    - Add new variable g:NERDTreeRemoveFileCmd (kutsan) #816
-    - Add modelines (@lifecrisis) #782
+    - Use a better check for existence of the NERDTree buffer. (PhilRunninger) #814
-    - Change the type of completion used by NERDTreeFind (@lifecrisis) #781
+    - Fix focussing previous buffer when closing NERDTree (mrubli) #801
-    - change NERDTreeFind with args (@zhenyangze) #778
+    - Update the docs for "NERDTreeStatusline" (lifecrisis) #796
-    - Style Choice: Using confirm() when deleting a bookmark (@lifecrisis) #777
+    - BUGFIX: Unstable behavior in the "getPath()" method (lifecrisis) #795
-    - remove useless substitute when `file =~# "/$"` (@skyblueee) #773
+    - Revert the bugfix from pull request #785 (lifecrisis) #794
-    - remove useless removeLeadingSpaces in _stripMarkup (@skyblueee) #772
+    - BUGFIX: Allow ":NERDTreeFind" to discover hidden files (lifecrisis) #786
-    - Make the "o" mapping consistent with "x" (@lifecrisis) #769
+    - BUGFIX: Allow ":NERDTreeFind" to reveal new files (lifecrisis) #785
-    - Fix a problem with the "x" handler (@lifecrisis) #768
+    - Add modelines (lifecrisis) #782
-    - Clean up the handler for the "x" mapping (@lifecrisis) #767
+    - Change the type of completion used by NERDTreeFind (lifecrisis) #781
-    - Revert change to tab opening method (@lifecrisis) #766
+    - change NERDTreeFind with args (zhenyangze) #778
-    - BUGFIX: Add back support for "b:NERDTreeRoot" (@lifecrisis) #765
+    - Style Choice: Using confirm() when deleting a bookmark (lifecrisis) #777
-    - Fix broken "t" and "T" mappings, tabs now open at end (@lifecrisis) #759
+    - remove useless substitute when `file =~# "/$"` (skyblueee) #773
-    - Update doc with already existing mapping variables (@asnr) #699
+    - remove useless removeLeadingSpaces in _stripMarkup (skyblueee) #772
-    - Fix the broken g:NERDTreeBookmarksSort setting (@lifecrisis) #696
+    - Make the "o" mapping consistent with "x" (lifecrisis) #769
-    - Correct NERDTreeIgnore pattern in doc (@cntoplolicon) #648
+    - Fix a problem with the "x" handler (lifecrisis) #768
-    - Remove empty segments when splitting path (@sooth-sayer) #574
+    - Clean up the handler for the "x" mapping (lifecrisis) #767
-    - Suppress autocmds less agressively (@wincent) #578 #691
+    - Revert change to tab opening method (lifecrisis) #766
+    - BUGFIX: Add back support for "b:NERDTreeRoot" (lifecrisis) #765
+    - Fix broken "t" and "T" mappings, tabs now open at end (lifecrisis) #759
+    - Update doc with already existing mapping variables (asnr) #699
+    - Fix the broken g:NERDTreeBookmarksSort setting (lifecrisis) #696
+    - Correct NERDTreeIgnore pattern in doc (cntoplolicon) #648
+    - Remove empty segments when splitting path (sooth-sayer) #574
+    - Suppress autocmds less agressively (wincent) #578 #691
     - Add an Issues template to ask for more info initially.
-    - Fix markdown headers in readme (@josephfrazier) #676
+    - Fix markdown headers in readme (josephfrazier) #676
     - Don't touch @o and @h registers when rendering
-    - Fix bug with files and directories with dollar signs (@alegen) #649
+    - Fix bug with files and directories with dollar signs (alegen) #649
     - Reuse/reopen existing window trees where possible #244
     - Remove NERDTree.previousBuf()
-    - Change color of arrow (@Leeiio) #630
+    - Change color of arrow (Leeiio) #630
-    - Improved a tip in README.markdown (@ggicci) #628
+    - Improved a tip in README.markdown (ggicci) #628
-    - Shorten delete confimration of empty directory to `y` (@mikeperri) #530
+    - Shorten delete confimration of empty directory to `y` (mikeperri) #530
-    - Fix API call to open directory tree in window (@devm33) #533
+    - Fix API call to open directory tree in window (devm33) #533
-    - Change default arrows on non-Windows platforms (@gwilk) #546
+    - Change default arrows on non-Windows platforms (gwilk) #546
-    - Update to README - combine cd and git clone (@zwhitchcox) #584
+    - Update to README - combine cd and git clone (zwhitchcox) #584
-    - Update to README - Tip: start NERDTree when vim starts (@therealplato) #593 
+    - Update to README - Tip: start NERDTree when vim starts (therealplato) #593 
-    - Escape filename when moving an open buffer (@zacharyvoase) #595
+    - Escape filename when moving an open buffer (zacharyvoase) #595
-    - Fixed incorrect :helptags command in README (@curran) #619
+    - Fixed incorrect :helptags command in README (curran) #619
-    - Fixed incomplete escaping of folder arrows (@adityanatraj) #548
+    - Fixed incomplete escaping of folder arrows (adityanatraj) #548
-    - Added NERDTreeCascadeSingleChildDir option (@juanibiapina) #558
+    - Added NERDTreeCascadeSingleChildDir option (juanibiapina) #558
     - Replace strchars() with backward compatible workaround.
-    - Add support for copy command in Windows (@SkylerLipthay) #231
+    - Add support for copy command in Windows (SkylerLipthay) #231
     - Fixed typo in README.markdown - :Helptags -> :helptags
     - Rename "primary" and "secondary" trees to "tab" and "window" trees.
     - Move a bunch of buffer level variables into the NERDTree and UI classes.
@@ -121,7 +128,7 @@
     - On windows default to + and ~ for expand/collapse directory symbols.
     - Lots more refactoring. Move a bunch of b: level vars into b:NERDTree and friends.
 
-### 5.0.0
+#### 5.0.0
 - Refactor the code significantly:
     * Break the classes out into their own files.
     * Make the majority of the code OO - previously large parts were effectively a tangle of "global" methods.
@@ -130,110 +137,76 @@
 - add magic [[dir]] and [[file]] flags to NERDTreeIgnore
 - add support for custom path filters. See :help NERDTreeAddPathFilter()
 - add path listener API. See :help NERDTreePathListenerAPI.
-- expand the fs menu functionality to list file properties (@PhilRunninger, @apbarrero, @JESii)
+- expand the fs menu functionality to list file properties (PhilRunninger, apbarrero, JESii)
-- make bookmarks work with `~` home shortcuts (@hiberabyss)
+- make bookmarks work with `~` home shortcuts (hiberabyss)
-- show OSX specific fsmenu options in regular vim on mac (@evindor)
+- show OSX specific fsmenu options in regular vim on mac (evindor)
-- make dir arrow icons configurable (@PickRelated)
+- make dir arrow icons configurable (PickRelated)
-- optimise node sorting performance when opening large dirs (@vtsang)
+- optimise node sorting performance when opening large dirs (vtsang)
-- make the root note render prettier by truncating it at a path slash (@gcmt)
+- make the root note render prettier by truncating it at a path slash (gcmt)
 - remove NERDChristmasTree option - its always christmas now
-- add "cascade" open and closing for dirs containing only another single dir. See :help NERDTreeCascadeOpenSingleChildDir (@pendulm)
+- add "cascade" open and closing for dirs containing only another single dir. See :help NERDTreeCascadeOpenSingleChildDir (pendulm)
-- Many other fixes, doc updates and contributions from:
+- Many other fixes, doc updates and contributions from: **actionshrimp**, **agrussellknives**, **alvan**, **AndrewRadev**, **cperl82** (*many small fixes*), **devmanhinton**, **egalpin**, **franksort**, **gastropoda**, **handcraftedbits**, **kelaban**, **lucascaton**, **mixvin**, **pendulm**, **SchDen**, **shanesmith**, **staeff**, **stephenprater**, **toiffel**, **Twinside**, **WoLpH**, **xiaodili**, **zhangoose**
-    - @actionshrimp
-    - @SchDen
-    - @egalpin
-    - @cperl82 - many small fixes
-    - @toiffel
-    - @WoLpH
-    - @handcraftedbits
-    - @devmanhinton
-    - @xiaodili
-    - @zhangoose
-    - @gastropoda
-    - @mixvin
-    - @alvan
-    - @lucascaton
-    - @kelaban
-    - @shanesmith
-    - @staeff
-    - @pendulm
-    - @stephenprater
-    - @franksort
-    - @agrussellknives
-    - @AndrewRadev
-    - @Twinside
 
-### 4.2.0
+#### 4.2.0
-- Add NERDTreeDirArrows option to make the UI use pretty arrow chars instead of the old +~| chars to define the tree structure (@sickill)
+- Add NERDTreeDirArrows option to make the UI use pretty arrow chars instead of the old +~| chars to define the tree structure (sickill)
-- shift the syntax highlighting out into its own syntax file (@gnap)
+- shift the syntax highlighting out into its own syntax file (gnap)
-- add some mac specific options to the filesystem menu - for macvim only (@andersonfreitas)
+- add some mac specific options to the filesystem menu - for macvim only (andersonfreitas)
-- Add NERDTreeMinimalUI option to remove some non functional parts of the nerdtree ui (@camthompson)
+- Add NERDTreeMinimalUI option to remove some non functional parts of the nerdtree ui (camthompson)
-- tweak the behaviour of :NERDTreeFind - see :help :NERDTreeFind for the new behaviour (@benjamingeiger)
+- tweak the behaviour of :NERDTreeFind - see :help :NERDTreeFind for the new behaviour (benjamingeiger)
-- if no name is given to :Bookmark, make it default to the name of the target file/dir (@minyoung)
+- if no name is given to :Bookmark, make it default to the name of the target file/dir (minyoung)
-- use `file` completion when doing copying, create, and move operations (@EvanDotPro)
+- use `file` completion when doing copying, create, and move operations (EvanDotPro)
-- lots of misc bug fixes from:
+- lots of misc bug fixes from: **AndrewRadev**, **Bogdanov**, **camthompson**, **kml**, **mathias**, **paddyoloughlin**, **scottstvnsn**, **sdewald**, **Vitaly**, **wycats**, me RAWR!
-    - @paddyoloughlin
-    - @sdewald
-    - @camthompson
-    - @Vitaly
-    - @Bogdanov
-    - @AndrewRadev
-    - @mathias
-    - @scottstvnsn
-    - @kml
-    - @wycats
-    - me RAWR!
 
-### 4.1.0
+#### 4.1.0
 - features:
-    - NERDTreeFind to reveal the node for the current buffer in the tree, see `|NERDTreeFind|`. This effectively merges the FindInNERDTree plugin (by Doug McInnes) into the script.
+    - NERDTreeFind to reveal the node for the current buffer in the tree, see `|NERDTreeFind|`. This effectively merges the FindInNERDTree plugin (by **Doug McInnes**) into the script.
-    - make NERDTreeQuitOnOpen apply to the t/T keymaps too. Thanks to Stefan Ritter and Rémi Prévost.
+    - make NERDTreeQuitOnOpen apply to the t/T keymaps too. Thanks to **Stefan Ritter** and **Rémi Prévost**.
-    - truncate the root node if wider than the tree window. Thanks to Victor Gonzalez.
+    - truncate the root node if wider than the tree window. Thanks to **Victor Gonzalez**.
 
 - bugfixes:
     - really fix window state restoring
-    - fix some win32 path escaping issues. Thanks to Stephan Baumeister, Ricky, jfilip1024, and Chris Chambers
+    - fix some win32 path escaping issues. Thanks to **Stephan Baumeister**, **Ricky**, **jfilip1024**, and **Chris Chambers**.
 
-### 4.0.0
+#### 4.0.0
 - add a new programmable menu system (see `:help NERDTreeMenu`).
 - add new APIs to add menus/menu-items to the menu system as well as custom key mappings to the NERD tree buffer (see `:help NERDTreeAPI`).
 - removed the old API functions
 - added a mapping to maximize/restore the size of nerd tree window, thanks to Guillaume Duranceau for the patch. See :help NERDTree-A for details.
-- fix a bug where secondary nerd trees (netrw hijacked trees) and NERDTreeQuitOnOpen didnt play nicely, thanks to Curtis Harvey.
+- fix a bug where secondary nerd trees (netrw hijacked trees) and NERDTreeQuitOnOpen didnt play nicely, thanks to **Curtis Harvey**.
-- fix a bug where the script ignored directories whose name ended in a dot, thanks to Aggelos Orfanakos for the patch.
+- fix a bug where the script ignored directories whose name ended in a dot, thanks to **Aggelos Orfanakos** for the patch.
-- fix a bug when using the x mapping on the tree root, thanks to Bryan Venteicher for the patch.
+- fix a bug when using the x mapping on the tree root, thanks to **Bryan Venteicher** for the patch.
-- fix a bug where the cursor position/window size of the nerd tree buffer wasnt being stored on closing the window, thanks to Richard Hart.
+- fix a bug where the cursor position/window size of the nerd tree buffer wasnt being stored on closing the window, thanks to **Richard Hart**.
 - fix a bug where NERDTreeMirror would mirror the wrong tree
 
-### 3.1.1
+#### 3.1.1
-- fix a bug where a non-listed no-name buffer was getting created every time the tree windows was created, thanks to Derek Wyatt and owen1
+- fix a bug where a non-listed no-name buffer was getting created every time the tree windows was created, thanks to **Derek Wyatt** and **owen1**
 - make `<CR>` behave the same as the `o` mapping
-- some helptag fixes in the doc, thanks @strull
+- some helptag fixes in the doc, thanks **strull**.
-- fix a bug when using `:set nohidden` and opening a file where the previous buf was modified. Thanks @iElectric
+- fix a bug when using `:set nohidden` and opening a file where the previous buf was modified. Thanks **iElectric**.
 - other minor fixes
 
-### 3.1.0
+#### 3.1.0
 - New features:
     - add mappings to open files in a vsplit, see `:help NERDTree-s` and `:help NERDTree-gs`
     - make the statusline for the nerd tree window default to something hopefully more useful. See `:help 'NERDTreeStatusline'`
 - Bugfixes:
-    - make the hijack netrw functionality work when vim is started with `vim <some dir>` (thanks to Alf Mikula for the patch).
+    - make the hijack netrw functionality work when vim is started with `vim <some dir>` (thanks to **Alf Mikula** for the patch).
-    - fix a bug where the CWD wasnt being changed for some operations even when NERDTreeChDirMode==2 (thanks to Lucas S. Buchala)
+    - fix a bug where the CWD wasnt being changed for some operations even when NERDTreeChDirMode==2 (thanks to **Lucas S. Buchala**)
-    - add -bar to all the nerd tree :commands so they can chain with other :commands (thanks to @tpope)
+    - add -bar to all the nerd tree :commands so they can chain with other :commands (thanks to **tpope**)
-    - fix bugs when ignorecase was set (thanks to @nach)
+    - fix bugs when ignorecase was set (thanks to **nach**)
-    - fix a bug with the relative path code (thanks to @nach)
+    - fix a bug with the relative path code (thanks to **nach**)
-    - fix a bug where doing a `:cd` would cause `:NERDTreeToggle` to fail (thanks @nach)
+    - fix a bug where doing a `:cd` would cause `:NERDTreeToggle` to fail (thanks **nach**)
 
 
-### 3.0.1
+#### 3.0.1
 - Bugfixes:
     - fix bugs with :NERDTreeToggle and :NERDTreeMirror when `'hidden'` was not set
-    - fix a bug where `:NERDTree <path>` would fail if `<path>` was relative and didnt start with a `./` or `../`  Thanks to James Kanze.
+    - fix a bug where `:NERDTree <path>` would fail if `<path>` was relative and didnt start with a `./` or `../`  Thanks to **James Kanze**.
-    - make the `q` mapping work with secondary (`:e <dir>`  style) trees, thanks to @jamessan
+    - make the `q` mapping work with secondary (`:e <dir>`  style) trees, thanks to **jamessan**
     - fix a bunch of small bugs with secondary trees
 - More insane refactoring.
 
-### 3.0.0
+#### 3.0.0
 - hijack netrw so that doing an `:edit <directory>`  will put a NERD tree in the window rather than a netrw browser. See :help 'NERDTreeHijackNetrw'
 - allow sharing of trees across tabs, see `:help :NERDTreeMirror`
 - remove "top" and "bottom" as valid settings for NERDTreeWinPos

autoload/nerdtree.vim

@@ -3,13 +3,38 @@ if exists("g:loaded_nerdtree_autoload")
 endif
 let g:loaded_nerdtree_autoload = 1
 
-function! nerdtree#version()
+let s:rootNERDTreePath = resolve(expand("<sfile>:p:h:h"))
-    return '5.1.2'
+function! nerdtree#version(...)
+    let l:changelog = readfile(join([s:rootNERDTreePath, "CHANGELOG.md"], nerdtree#slash()))
+    let l:text = 'Unknown'
+    let l:line = 0
+    while l:line <= len(l:changelog)
+        if l:changelog[l:line] =~ '\d\+\.\d\+'
+            let l:text = substitute(l:changelog[l:line], '.*\(\d\+.\d\+\).*', '\1', '')
+            let l:text .= substitute(l:changelog[l:line+1], '^.\{-}\(\.\d\+\).\{-}:\(.*\)', a:0>0 ? '\1:\2' : '\1', '')
+            break
+        endif
+        let l:line += 1
+    endwhile
+    return l:text
 endfunction
 
 " SECTION: General Functions {{{1
 "============================================================
 
+function! nerdtree#slash()
+
+    if nerdtree#runningWindows()
+        if exists('+shellslash') && &shellslash
+            return '/'
+        endif
+
+        return '\'
+    endif
+
+    return '/'
+endfunction
+
 "FUNCTION: nerdtree#and(x,y) {{{2
 " Implements and() function for Vim <= 7.2
 function! nerdtree#and(x,y)

autoload/nerdtree/ui_glue.vim

@@ -14,6 +14,10 @@ function! nerdtree#ui_glue#createDefaultBindings()
     call NERDTreeAddKeyMap({ 'key': '<2-LeftMouse>', 'scope': "Bookmark", 'callback': s."activateBookmark" })
     call NERDTreeAddKeyMap({ 'key': '<2-LeftMouse>', 'scope': "all", 'callback': s."activateAll" })
 
+    call NERDTreeAddKeyMap({ 'key': g:NERDTreeMapCustomOpen, 'scope':'FileNode', 'callback': s."customOpenFile"})
+    call NERDTreeAddKeyMap({ 'key': g:NERDTreeMapCustomOpen, 'scope':'DirNode', 'callback': s."customOpenDir"})
+    call NERDTreeAddKeyMap({ 'key': g:NERDTreeMapCustomOpen, 'scope':'Bookmark', 'callback': s."customOpenBookmark"})
+    call NERDTreeAddKeyMap({ 'key': g:NERDTreeMapCustomOpen, 'scope':'all', 'callback': s."activateAll" })
 
     call NERDTreeAddKeyMap({ 'key': g:NERDTreeMapActivateNode, 'scope': "DirNode", 'callback': s."activateDirNode" })
     call NERDTreeAddKeyMap({ 'key': g:NERDTreeMapActivateNode, 'scope': "FileNode", 'callback': s."activateFileNode" })
@@ -76,6 +80,35 @@ endfunction
 "SECTION: Interface bindings {{{1
 "============================================================
 
+"FUNCTION: s:customOpenFile() {{{1
+" Open file node with the "custom" key, initially <CR>.
+function! s:customOpenFile(node)
+    call a:node.activate(s:initCustomOpenArgs().file)
+endfunction
+
+"FUNCTION: s:customOpenDir() {{{1
+" Open directory node with the "custom" key, initially <CR>.
+function! s:customOpenDir(node)
+    call s:activateDirNode(a:node, s:initCustomOpenArgs().dir)
+endfunction
+
+"FUNCTION: s:customOpenBookmark() {{{1
+" Open bookmark node with the "custom" key, initially <CR>.
+function! s:customOpenBookmark(node)
+    if a:node.path.isDirectory
+        call a:node.activate(b:NERDTree, s:initCustomOpenArgs().dir)
+    else
+        call a:node.activate(b:NERDTree, s:initCustomOpenArgs().file)
+    endif
+endfunction
+
+"FUNCTION: s:initCustomOpenArgs() {{{1
+" Make sure NERDTreeCustomOpenArgs has needed keys
+function! s:initCustomOpenArgs()
+    let g:NERDTreeCustomOpenArgs = get(g:, 'NERDTreeCustomOpenArgs', {})
+    return extend(g:NERDTreeCustomOpenArgs, {'file':{'reuse': 'all', 'where': 'p'}, 'dir':{}}, 'keep')
+endfunction
+
 "FUNCTION: s:activateAll() {{{1
 "handle the user activating the updir line
 function! s:activateAll()
@@ -84,15 +117,16 @@ function! s:activateAll()
     endif
 endfunction
 
-" FUNCTION: s:activateDirNode(directoryNode) {{{1
+" FUNCTION: s:activateDirNode(directoryNode, options) {{{1
-function! s:activateDirNode(directoryNode)
+" Open a directory with optional options
+function! s:activateDirNode(directoryNode, ...)
 
     if a:directoryNode.isRoot() && a:directoryNode.isOpen
         call nerdtree#echo('cannot close tree root')
         return
     endif
 
-    call a:directoryNode.activate()
+    call a:directoryNode.activate((a:0 > 0) ? a:1 : {})
 endfunction
 
 "FUNCTION: s:activateFileNode() {{{1

doc/NERDTree.txt

@@ -247,12 +247,12 @@ i........Open selected file in a split window.......................|NERDTree-i|
 gi.......Same as i, but leave the cursor on the NERDTree...........|NERDTree-gi|
 s........Open selected file in a new vsplit.........................|NERDTree-s|
 gs.......Same as s, but leave the cursor on the NERDTree...........|NERDTree-gs|
+<CR>.....User-definable custom open action.......................|NERDTree-<CR>|
 O........Recursively open the selected directory....................|NERDTree-O|
 x........Close the current nodes parent.............................|NERDTree-x|
 X........Recursively close all children of the current node.........|NERDTree-X|
 e........Edit the current dir.......................................|NERDTree-e|
 
-<CR>............same as |NERDTree-o|.
 double-click....same as |NERDTree-o|.
 middle-click....same as |NERDTree-i| for files, and |NERDTree-e| for dirs.
 
@@ -319,7 +319,7 @@ The default key combo for this mapping is "g" + NERDTreeMapActivateNode (see
 ------------------------------------------------------------------------------
                                                                     *NERDTree-t*
 Default key: t
-Map setting: NERDTreeMapOpenInTab
+Map setting: *NERDTreeMapOpenInTab*
 Applies to: files and directories.
 
 Opens the selected file in a new tab. If a directory is selected, a fresh
@@ -332,7 +332,7 @@ in a new tab.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-T*
 Default key: T
-Map setting: NERDTreeMapOpenInTabSilent
+Map setting: *NERDTreeMapOpenInTabSilent*
 Applies to: files and directories.
 
 The same as |NERDTree-t| except that the focus is kept in the current tab.
@@ -340,7 +340,7 @@ The same as |NERDTree-t| except that the focus is kept in the current tab.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-i*
 Default key: i
-Map setting: NERDTreeMapOpenSplit
+Map setting: *NERDTreeMapOpenSplit*
 Applies to: files.
 
 Opens the selected file in a new split window and puts the cursor in the new
@@ -349,7 +349,7 @@ window.
 ------------------------------------------------------------------------------
                                                                    *NERDTree-gi*
 Default key: gi
-Map setting: NERDTreeMapPreviewSplit
+Map setting: *NERDTreeMapPreviewSplit*
 Applies to: files.
 
 The same as |NERDTree-i| except that the cursor is not moved.
@@ -360,7 +360,7 @@ The default key combo for this mapping is "g" + NERDTreeMapOpenSplit (see
 ------------------------------------------------------------------------------
                                                                     *NERDTree-s*
 Default key: s
-Map setting: NERDTreeMapOpenVSplit
+Map setting: *NERDTreeMapOpenVSplit*
 Applies to: files.
 
 Opens the selected file in a new vertically split window and puts the cursor
@@ -369,7 +369,7 @@ in the new window.
 ------------------------------------------------------------------------------
                                                                    *NERDTree-gs*
 Default key: gs
-Map setting: NERDTreeMapPreviewVSplit
+Map setting: *NERDTreeMapPreviewVSplit*
 Applies to: files.
 
 The same as |NERDTree-s| except that the cursor is not moved.
@@ -377,10 +377,19 @@ The same as |NERDTree-s| except that the cursor is not moved.
 The default key combo for this mapping is "g" + NERDTreeMapOpenVSplit (see
 |NERDTree-s|).
 
+------------------------------------------------------------------------------
+                                                                 *NERDTree-<CR>*
+Default key: <CR>
+Map setting: *NERDTreeMapCustomOpen*
+Applies to: files, directories, and bookmarks
+
+Performs a customized open action on the selected node. This allows the user
+to define an action that behaves differently from any of the standard
+keys. See |NERDTreeCustomOpenArgs| for more details.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-O*
 Default key: O
-Map setting: NERDTreeMapOpenRecursively
+Map setting: *NERDTreeMapOpenRecursively*
 Applies to: directories.
 
 Recursively opens the selected directory.
@@ -393,7 +402,7 @@ cached. This is handy, especially if you have .svn directories.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-x*
 Default key: x
-Map setting: NERDTreeMapCloseDir
+Map setting: *NERDTreeMapCloseDir*
 Applies to: files and directories.
 
 Closes the parent of the selected node.
@@ -401,7 +410,7 @@ Closes the parent of the selected node.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-X*
 Default key: X
-Map setting: NERDTreeMapCloseChildren
+Map setting: *NERDTreeMapCloseChildren*
 Applies to: directories.
 
 Recursively closes all children of the selected directory.
@@ -411,7 +420,7 @@ Tip: To quickly "reset" the tree, use |NERDTree-P| with this mapping.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-e*
 Default key: e
-Map setting: NERDTreeMapOpenExpl
+Map setting: *NERDTreeMapOpenExpl*
 Applies to: files and directories.
 
 |:edit|s the selected directory, or the selected file's directory. This could
@@ -421,7 +430,7 @@ result in a NERDTree or a netrw being opened, depending on
 ------------------------------------------------------------------------------
                                                                     *NERDTree-D*
 Default key: D
-Map setting: NERDTreeMapDeleteBookmark
+Map setting: *NERDTreeMapDeleteBookmark*
 Applies to: lines in the bookmarks table
 
 Deletes the currently selected bookmark.
@@ -429,7 +438,7 @@ Deletes the currently selected bookmark.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-P*
 Default key: P
-Map setting: NERDTreeMapJumpRoot
+Map setting: *NERDTreeMapJumpRoot*
 Applies to: no restrictions.
 
 Jump to the tree root.
@@ -437,7 +446,7 @@ Jump to the tree root.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-p*
 Default key: p
-Map setting: NERDTreeMapJumpParent
+Map setting: *NERDTreeMapJumpParent*
 Applies to: files and directories.
 
 Jump to the parent node of the selected node.
@@ -445,7 +454,7 @@ Jump to the parent node of the selected node.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-K*
 Default key: K
-Map setting: NERDTreeMapJumpFirstChild
+Map setting: *NERDTreeMapJumpFirstChild*
 Applies to: files and directories.
 
 Jump to the first child of the current nodes parent.
@@ -458,7 +467,7 @@ If the cursor is already on the first node then do the following:
 ------------------------------------------------------------------------------
                                                                     *NERDTree-J*
 Default key: J
-Map setting: NERDTreeMapJumpLastChild
+Map setting: *NERDTreeMapJumpLastChild*
 Applies to: files and directories.
 
 Jump to the last child of the current nodes parent.
@@ -471,7 +480,7 @@ If the cursor is already on the last node then do the following:
 ------------------------------------------------------------------------------
                                                                   *NERDTree-C-J*
 Default key: <C-J>
-Map setting: NERDTreeMapJumpNextSibling
+Map setting: *NERDTreeMapJumpNextSibling*
 Applies to: files and directories.
 
 Jump to the next sibling of the selected node.
@@ -479,7 +488,7 @@ Jump to the next sibling of the selected node.
 ------------------------------------------------------------------------------
                                                                   *NERDTree-C-K*
 Default key: <C-K>
-Map setting: NERDTreeMapJumpPrevSibling
+Map setting: *NERDTreeMapJumpPrevSibling*
 Applies to: files and directories.
 
 Jump to the previous sibling of the selected node.
@@ -487,7 +496,7 @@ Jump to the previous sibling of the selected node.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-C*
 Default key: C
-Map setting: NERDTreeMapChangeRoot
+Map setting: *NERDTreeMapChangeRoot*
 Applies to: files and directories.
 
 Make the selected directory node the new tree root. If a file is selected, its
@@ -496,7 +505,7 @@ parent is used.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-u*
 Default key: u
-Map setting: NERDTreeMapUpdir
+Map setting: *NERDTreeMapUpdir*
 Applies to: no restrictions.
 
 Move the tree root up a dir (like doing a "cd ..").
@@ -504,7 +513,7 @@ Move the tree root up a dir (like doing a "cd ..").
 ------------------------------------------------------------------------------
                                                                     *NERDTree-U*
 Default key: U
-Map setting: NERDTreeMapUpdirKeepOpen
+Map setting: *NERDTreeMapUpdirKeepOpen*
 Applies to: no restrictions.
 
 Like |NERDTree-u| except that the old tree root is kept open.
@@ -512,7 +521,7 @@ Like |NERDTree-u| except that the old tree root is kept open.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-r*
 Default key: r
-Map setting: NERDTreeMapRefresh
+Map setting: *NERDTreeMapRefresh*
 Applies to: files and directories.
 
 If a dir is selected, recursively refresh that dir, i.e. scan the filesystem
@@ -523,7 +532,7 @@ If a file node is selected then the above is done on it's parent.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-R*
 Default key: R
-Map setting: NERDTreeMapRefreshRoot
+Map setting: *NERDTreeMapRefreshRoot*
 Applies to: no restrictions.
 
 Recursively refresh the tree root.
@@ -531,7 +540,7 @@ Recursively refresh the tree root.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-m*
 Default key: m
-Map setting: NERDTreeMapMenu
+Map setting: *NERDTreeMapMenu*
 Applies to: files and directories.
 
 Display the NERDTree menu. See |NERDTreeMenu| for details.
@@ -539,7 +548,7 @@ Display the NERDTree menu. See |NERDTreeMenu| for details.
 ------------------------------------------------------------------------------
                                                                    *NERDTree-cd*
 Default key: cd
-Map setting: NERDTreeMapChdir
+Map setting: *NERDTreeMapChdir*
 Applies to: files and directories.
 
 Change Vim's current working directory to that of the selected node.
@@ -547,7 +556,7 @@ Change Vim's current working directory to that of the selected node.
 ------------------------------------------------------------------------------
                                                                    *NERDTree-CD*
 Default key: CD
-Map setting: NERDTreeMapCWD
+Map setting: *NERDTreeMapCWD*
 Applies to: no restrictions.
 
 Change the NERDTree root to Vim's current working directory.
@@ -555,7 +564,7 @@ Change the NERDTree root to Vim's current working directory.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-I*
 Default key: I
-Map setting: NERDTreeMapToggleHidden
+Map setting: *NERDTreeMapToggleHidden*
 Applies to: no restrictions.
 
 Toggles whether hidden files (i.e. "dot files") are displayed.
@@ -563,7 +572,7 @@ Toggles whether hidden files (i.e. "dot files") are displayed.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-f*
 Default key: f
-Map setting: NERDTreeMapToggleFilters
+Map setting: *NERDTreeMapToggleFilters*
 Applies to: no restrictions.
 
 Toggles whether file filters are used. See |NERDTreeIgnore| for details.
@@ -571,7 +580,7 @@ Toggles whether file filters are used. See |NERDTreeIgnore| for details.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-F*
 Default key: F
-Map setting: NERDTreeMapToggleFiles
+Map setting: *NERDTreeMapToggleFiles*
 Applies to: no restrictions.
 
 Toggles whether file nodes are displayed.
@@ -579,7 +588,7 @@ Toggles whether file nodes are displayed.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-B*
 Default key: B
-Map setting: NERDTreeMapToggleBookmarks
+Map setting: *NERDTreeMapToggleBookmarks*
 Applies to: no restrictions.
 
 Toggles whether the bookmarks table is displayed.
@@ -587,7 +596,7 @@ Toggles whether the bookmarks table is displayed.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-q*
 Default key: q
-Map setting: NERDTreeMapQuit
+Map setting: *NERDTreeMapQuit*
 Applies to: no restrictions.
 
 Closes the NERDTree window.
@@ -595,7 +604,7 @@ Closes the NERDTree window.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-A*
 Default key: A
-Map setting: NERDTreeMapToggleZoom
+Map setting: *NERDTreeMapToggleZoom*
 Applies to: no restrictions.
 
 Maximize (zoom) and minimize the NERDTree window.
@@ -603,7 +612,7 @@ Maximize (zoom) and minimize the NERDTree window.
 ------------------------------------------------------------------------------
                                                                     *NERDTree-?*
 Default key: ?
-Map setting: NERDTreeMapHelp
+Map setting: *NERDTreeMapHelp*
 Applies to: no restrictions.
 
 Toggles whether the quickhelp is displayed.
@@ -625,7 +634,7 @@ Related tags: |NERDTree-m| |NERDTreeApi|
 ------------------------------------------------------------------------------
                                                                 *NERDTreeMenu-j*
 Default key: j
-Map option: NERDTreeMenuDown
+Map option: *NERDTreeMenuDown*
 Applies to: The NERDTree menu.
 
 Moves the cursor down.
@@ -633,7 +642,7 @@ Moves the cursor down.
 ------------------------------------------------------------------------------
                                                                 *NERDTreeMenu-k*
 Default key: k
-Map option: NERDTreeMenuUp
+Map option: *NERDTreeMenuUp*
 Applies to: The NERDTree menu.
 
 Moves the cursor up.
@@ -754,6 +763,9 @@ the NERDTree. These settings should be set in your vimrc, using `:let`.
                             file or directory name from the rest of the
                             characters on the line of text.
 
+|NERDTreeCustomOpenArgs|      A dictionary with values that control how a node
+                            is opened with the |NERDTree-<CR>| key.
+
 ------------------------------------------------------------------------------
 3.2. Customisation details                             *NERDTreeSettingsDetails*
 
@@ -1233,6 +1245,32 @@ when specifying by hex or Unicode. >
     let NERDTreeNodeDelimiter="\u00a0"   "non-breaking space
     let NERDTreeNodeDelimiter="😀"       "smiley face
 <
+------------------------------------------------------------------------------
+                                                        *NERDTreeCustomOpenArgs*
+Values: A nested dictionary, as described below
+Default: {'file': {'reuse': 'all', 'where': 'p'}, 'dir': {}}
+
+This dictionary contains two keys, 'file' and 'dir', whose values each are
+another dictionary. The inner dictionary is a set of parameters used by
+|NERDTree-<CR>| to open a file or directory. Setting these parameters allows you
+to customize the way the node is opened. The default value matches what
+|NERDTree-o| does. To change that behavior, use these keys and
+values in the inner dictionaries:
+
+'where':    specifies whether the node should be opened in a new split ("h" or
+            "v"), in a new tab ("t") or, in the last window ("p").
+'reuse':    if file is already shown in a window, jump there; takes values
+            "all", "currenttab", or empty
+'keepopen': boolean (0 or 1); if true, the tree window will not be closed
+'stay':     boolean (0 or 1); if true, remain in tree window after opening
+
+For example:
+To open files and directories (creating a new NERDTree) in a new tab, >
+    {'file':{'where': 't'}, 'dir':{'where':'t'}}
+<
+To open a file always in the current tab, and expand directories in place, >
+    {'file': {'reuse':'currenttab', 'where':'p', 'keepopen':1, 'stay':1}}
+<
 ==============================================================================
 4. The NERDTree API                                                *NERDTreeAPI*
 

lib/nerdtree/creator.vim

@@ -13,9 +13,6 @@ let g:NERDTreeCreator = s:Creator
 
 " FUNCTION: s:Creator._bindMappings() {{{1
 function! s:Creator._bindMappings()
-    "make <cr> do the same as the activate node mapping
-    nnoremap <silent> <buffer> <cr> :call nerdtree#ui_glue#invokeKeyMap(g:NERDTreeMapActivateNode)<cr>
-
     call g:NERDTreeKeyMap.BindAll()
 
     command! -buffer -nargs=? Bookmark :call nerdtree#ui_glue#bookmarkNode('<args>')

lib/nerdtree/ui.vim

@@ -28,7 +28,6 @@ function! s:UI._dumpHelp()
         let help .= "\" ============================\n"
         let help .= "\" File node mappings~\n"
         let help .= "\" ". (g:NERDTreeMouseMode ==# 3 ? "single" : "double") ."-click,\n"
-        let help .= "\" <CR>,\n"
         if self.nerdtree.isTabTree()
             let help .= "\" ". g:NERDTreeMapActivateNode .": open in prev window\n"
         else
@@ -44,6 +43,7 @@ function! s:UI._dumpHelp()
         let help .= "\" ". g:NERDTreeMapPreviewSplit .": preview split\n"
         let help .= "\" ". g:NERDTreeMapOpenVSplit .": open vsplit\n"
         let help .= "\" ". g:NERDTreeMapPreviewVSplit .": preview vsplit\n"
+        let help .= "\" ". g:NERDTreeMapCustomOpen .": custom open\n"
 
         let help .= "\"\n\" ----------------------------\n"
         let help .= "\" Directory node mappings~\n"
@@ -52,6 +52,7 @@ function! s:UI._dumpHelp()
         let help .= "\" ". g:NERDTreeMapOpenRecursively .": recursively open node\n"
         let help .= "\" ". g:NERDTreeMapOpenInTab.": open in new tab\n"
         let help .= "\" ". g:NERDTreeMapOpenInTabSilent .": open in new tab silently\n"
+        let help .= "\" ". g:NERDTreeMapCustomOpen .": custom open\n"
         let help .= "\" ". g:NERDTreeMapCloseDir .": close parent of node\n"
         let help .= "\" ". g:NERDTreeMapCloseChildren .": close all child nodes of\n"
         let help .= "\"    current node recursively\n"
@@ -66,6 +67,7 @@ function! s:UI._dumpHelp()
         let help .= "\" ". g:NERDTreeMapPreview .": find dir in tree\n"
         let help .= "\" ". g:NERDTreeMapOpenInTab.": open in new tab\n"
         let help .= "\" ". g:NERDTreeMapOpenInTabSilent .": open in new tab silently\n"
+        let help .= "\" ". g:NERDTreeMapCustomOpen .": custom open\n"
         let help .= "\" ". g:NERDTreeMapDeleteBookmark .": delete bookmark\n"
 
         let help .= "\"\n\" ----------------------------\n"
@@ -252,7 +254,7 @@ endfunction
 " gets the line number of the root node
 function! s:UI.getRootLineNum()
     let rootLine = 1
-    while getline(rootLine) !~# '^\(/\|<\)'
+    while rootLine <= line('$') && getline(rootLine) !~# '^\(/\|<\)'
         let rootLine = rootLine + 1
     endwhile
     return rootLine

plugin/NERD_tree.vim

@@ -121,6 +121,7 @@ endif
 
 
 "SECTION: Init variable calls for key mappings {{{2
+call s:initVariable("g:NERDTreeMapCustomOpen", "<CR>")
 call s:initVariable("g:NERDTreeMapActivateNode", "o")
 call s:initVariable("g:NERDTreeMapChangeRoot", "C")
 call s:initVariable("g:NERDTreeMapChdir", "cd")