switch vertion to 2.10.0

refactor out the code that actually opens the explorer window into
s:OpenExplorerFor(treenode) so that we can call it separately

.gitignore

@@ -1,2 +1,3 @@
 *~
 *.swp
+tags

Rakefile

@@ -0,0 +1,18 @@
+desc "Copy the vim/doc files into ~/.vim"
+task :deploy_local do
+  run "cp plugin/NERD_tree.vim ~/.vim/plugin"
+  run "cp doc/NERD_tree.txt ~/.vim/doc"
+end
+
+
+desc "Create a zip archive for release to vim.org"
+task :zip do
+  abort "NERD_tree.zip already exists, aborting" if File.exist?("NERD_tree.zip")
+  run "zip NERD_tree.zip plugin/NERD_tree.vim doc/NERD_tree.txt"
+end
+
+def run(cmd)
+  puts "Executing: #{cmd}"
+  system cmd
+end
+

doc/NERD_tree.txt

@@ -2,7 +2,7 @@
 
 
 
-
+    omg its ... ~
 
     ________  ________   _   ____________  ____     __________  ____________~
    /_  __/ / / / ____/  / | / / ____/ __ \/ __ \   /_  __/ __ \/ ____/ ____/~
@@ -17,13 +17,14 @@
 
 
 ==============================================================================
-CONTENTS                                                   *NERDTree-contents* 
+CONTENTS                                                   *NERDTree-contents*
 
     1.Intro...................................|NERDTree|
     2.Functionality provided..................|NERDTreeFunctionality|
-        2.1 Commands..........................|NERDTreeCommands|
+        2.1 Global commands...................|NERDTreeGlobalCommands|
-        2.2 NERD tree mappings................|NERDTreeMappings|
+        2.2 Bookmark commands.................|NERDTreeBookmarkCommands|
-        2.3 The filesystem menu...............|NERDTreeFilesysMenu|
+        2.3 NERD tree mappings................|NERDTreeMappings|
+        2.4 The filesystem menu...............|NERDTreeFilesysMenu|
     3.Options.................................|NERDTreeOptions|
         3.1 Option summary....................|NERDTreeOptionSummary|
         3.2 Option details....................|NERDTreeOptionDetails|
@@ -32,6 +33,7 @@ CONTENTS                                                   *NERDTree-contents*
     6.The Author..............................|NERDTreeAuthor|
     7.Changelog...............................|NERDTreeChangelog|
     8.Credits.................................|NERDTreeCredits|
+    9.License.................................|NERDTreeLicense|
 
 ==============================================================================
 1. Intro                                                            *NERDTree*
@@ -53,50 +55,99 @@ The following features and functionality are provided by the NERD tree:
         * read-only 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     
+        * Mappings to open files in new/existing windows/tabs
-        * Mappings to change the current root of the tree 
+        * Mappings to change the current root of the tree
-        * Mappings to navigate around the tree 
+        * Mappings to navigate around the tree
         * ...
-    * Most NERD tree navigation can also be done with the mouse  
+    * Directories and files can be bookmarked.
+    * Most NERD tree navigation can also be done with the mouse
     * Dynamic customisation of tree content
         * custom file filters to prevent e.g. vim backup files being displayed
         * 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
+      create/delete/rename file and directory nodes as well as copy (for
-    * The position and size of the NERD tree window can be customised 
+      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.
     * A model of your filesystem is created/maintained as you explore it. This
       has several advantages:
         * All filesystem information is cached and is only re-read on demand
         * If you revisit a part of the tree that you left earlier in your
-          session, the directory nodes will be opened/closed as you left them       
+          session, the directory nodes will be opened/closed as you left them
     * The script remembers the cursor position and window position in the NERD
       tree so you can toggle it off (or just close the tree window) and then
       reopen it (with NERDTreeToggle) the NERD tree window will appear EXACTLY
       as you left it
-    * You can have a separate NERD tree for each tab   
+    * You can have a separate NERD tree for each tab
 
 ==============================================================================
-2. Functionality provided                              *NERDTreeFunctionality* 
+2. Functionality provided                              *NERDTreeFunctionality*
 
 ------------------------------------------------------------------------------
-2.1. Commands                                               *NERDTreeCommands*
+2.1. Global Commands                                  *NERDTreeGlobalCommands*
 
-:NERDTree [start-directory]                                 *:NERDTree*
+:NERDTree [<start-directory> | <bookmark>]                         *:NERDTree*
-                Opens a fresh NERD tree in [start-directory] or the current
+    Opens a fresh NERD tree. The root of the tree depends on the argument
-                directory if [start-directory] isn't specified.
+    given. There are 3 cases: If no argument is given, the current directory
-                For example: >
+    will be used.  If a directory is given, that will be used. If a bookmark
-                    :NERDTree /home/marty/vim7/src
+    name is given, the corresponding directory will be used.  For example: >
-<               will open a NERD tree in /home/marty/vim7/src.
+        :NERDTree /home/marty/vim7/src
+        :NERDTree foo   (foo is the name of a bookmark)
+<
+:NERDTreeFromBookmark <bookmark>                       *:NERDTreeFromBookmark*
+    Opens a fresh NERD tree with the root initialized to the dir for
+    <bookmark>.  This only reason to use this command over :NERDTree is for
+    the completion (which is for bookmarks rather than directories).
 
-:NERDTreeToggle [start-directory]                           *:NERDTreeToggle*
+:NERDTreeToggle [<start-directory> | <bookmark>]             *:NERDTreeToggle*
-                If a NERD tree already exists for this tab, it is reopened and
+    If a NERD tree already exists for this tab, it is reopened and rendered
-                rendered again.  If no NERD tree exists for this tab then this
+    again.  If no NERD tree exists for this tab then this command acts the
-                command acts the same as the |:NERDTree| command.
+    same as the |:NERDTree| command.
+
+:NERDTreeClose
+    Close the NERD tree in this tab.
 
 ------------------------------------------------------------------------------
-2.2. NERD tree Mappings                                     *NERDTreeMappings*
+2.2. Bookmark Commands                              *NERDTreeBookmarkCommands*
+
+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|.
+
+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.
+
+:BookmarkToRoot <bookmark>
+    Make the directory corresponding to <bookmark> the new root. If a treenode
+    corresponding to <bookmark> is already cached somewhere in the tree then
+    the current tree will be used, otherwise a fresh tree will be opened.
+    Note that if <bookmark> points to a file then its parent will be used
+    instead.
+
+:RevealBookmark <bookmark>
+    If the node is cached under the current root then it will be revealed
+    (i.e. directory nodes above it will be opened) and the cursor will be
+    placed on it.
+
+:OpenBookmark <bookmark>
+    <bookmark> must point to a file. The file is opened as though |NERDTree-o|
+    was applied. If the node is cached under the current root then it will be
+    revealed and the cursor will be placed on it.
+
+:ClearBookmarks [<bookmarks>]
+    Remove all the given bookmarks. If no bookmarks are given then remove all
+    bookmarks on the current node.
+
+:ClearAllBookmarks
+    Remove all bookmarks.
+
+------------------------------------------------------------------------------
+2.3. NERD tree Mappings                                     *NERDTreeMappings*
 
 Default  Description~                                             help-tag~
 Key~
@@ -114,7 +165,7 @@ X.......Recursively close all children of the current node.......|NERDTree-X|
 e.......Open a netrw for the current dir.........................|NERDTree-e|
 
 double-click.......same as the |NERDTree-o| map.
-middle-click.......same as |NERDTree-tab| for files, same as 
+middle-click.......same as |NERDTree-tab| for files, same as
                    |NERDTree-e| for dirs.
 
 P.......Jump to the root node....................................|NERDTree-P|
@@ -311,7 +362,8 @@ Default key: C
 Map option: NERDTreeMapChdir
 Applies to: directories.
 
-Made the selected directory node the new tree root.
+Make the selected directory node the new tree root. If a file is selected, its
+parent is used.
 
 ------------------------------------------------------------------------------
                                                                   *NERDTree-u*
@@ -401,7 +453,7 @@ Toggles whether the quickhelp is displayed.
 2.3. The filesystem menu                                 *NERDTreeFilesysMenu*
 
 The purpose of the filesystem menu is to allow you to perform basic filesystem
-operations quickly from the NERD tree rather than the console.  
+operations quickly from the NERD tree rather than the console.
 
 The filesystem menu can be accessed with 'm' mapping and has four supported
 operations: >
@@ -428,7 +480,7 @@ on the renamed node.
 To delete a node put the cursor on it and select the 'delete' option from the
 filesystem menu. After confirmation the node will be deleted. If a file is
 deleted but still exists as a buffer you will be given the option to delete
-that buffer. 
+that buffer.
 
 4. Copying nodes:
 To copy a node put the cursor on it and select the 'copy' option from the
@@ -468,6 +520,8 @@ NERD tree. These options should be set in your vimrc.
 
 |NERDTreeIgnore|                Tells the NERD tree which files to ignore.
 
+|NERDTreeBookmarksFile|         Where the bookmarks are stored.
+
 |NERDTreeMouseMode|             Tells the NERD tree how to handle mouse
                                 clicks.
 
@@ -489,7 +543,7 @@ NERD tree. These options should be set in your vimrc.
 
 |NERDTreeWinPos|                Tells the script where to put the NERD tree
                                 window.
-                               
+
 
 |NERDTreeWinSize|               Sets the window size when the NERD tree is
                                 opened.
@@ -497,10 +551,10 @@ NERD tree. These options should be set in your vimrc.
 ------------------------------------------------------------------------------
 3.2. Customisation details                             *NERDTreeOptionDetails*
 
-To enable any of the below options you should put the given line in your 
+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
@@ -516,21 +570,21 @@ 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.
 
-This is ONLY done in response to tree navigation mappings, 
+This is ONLY done in response to tree navigation mappings,
 i.e. |NERDTree-J| |NERDTree-K| |NERDTree-C-J| |NERDTree-c-K| |NERDTree-p|
 |NERDTree-P|
 
 The centering is done with a |zz| operation.
 
 ------------------------------------------------------------------------------
-                                                 *NERDTreeAutoCenterThreshold*                
+                                                 *NERDTreeAutoCenterThreshold*
 Values: Any natural number.
 Default: 3
 
@@ -538,7 +592,7 @@ This option controls the "sensitivity" of the NERD tree auto centering. See
 |NERDTreeAutoCenter| for details.
 
 ------------------------------------------------------------------------------
-                                                   *NERDTreeCaseSensitiveSort*        
+                                                   *NERDTreeCaseSensitiveSort*
 Values: 0 or 1.
 Default: 0.
 
@@ -559,7 +613,7 @@ account. The above nodes would then be sorted like this: >
     boner.c
 <
 ------------------------------------------------------------------------------
-                                                           *NERDTreeChDirMode*                
+                                                           *NERDTreeChDirMode*
 
 Values: 0, 1 or 2.
 Default: 1.
@@ -581,10 +635,6 @@ 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.
 
-Note to windows users: it is highly recommended that you have this option set
-to either 1 or 2 or else the script wont function properly if you attempt to
-open a NERD tree on a different drive to the one vim is currently in.
-
 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
@@ -599,18 +649,18 @@ 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$', '\~$']
 <
-then all files ending in .vim or ~ will be ignored. 
+then all files ending in .vim or ~ will be ignored.
 
 Note: to tell the NERD tree not to ignore any files you must use the following
 line: >
@@ -621,11 +671,18 @@ The file filters can be turned on and off dynamically with the |NERDTree-f|
 mapping.
 
 ------------------------------------------------------------------------------
-                                                           *NERDTreeMouseMode*                
+                                                       *NERDTreeBookmarksFile*
+Values: a path
+Default: $HOME/.NERDTreeBookmarks
+
+This is where bookmarks are saved. See |NERDTreeBookmarkCommands|.
+
+------------------------------------------------------------------------------
+                                                           *NERDTreeMouseMode*
 Values: 1, 2 or 3.
 Default: 1.
 
-If set to 1 then a double click on a node is required to open it. 
+If set to 1 then a double click on a node is required to open it.
 If set to 2 then a single click will open directory nodes, while a double
 click will still be required for file nodes.
 If set to 3 then a single click will open any node.
@@ -639,7 +696,7 @@ then (to single click activate it) you must click somewhere in
 'application.rb'.
 
 ------------------------------------------------------------------------------
-                                                           *NERDTreeShowFiles*            
+                                                           *NERDTreeShowFiles*
 Values: 0 or 1.
 Default: 1.
 
@@ -651,7 +708,7 @@ 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.
 
@@ -672,7 +729,7 @@ window.  Use one of the follow lines to set this option: >
     let NERDTreeShowLineNumbers=0
     let NERDTreeShowLineNumbers=1
 <
-                                                       
+
 ------------------------------------------------------------------------------
                                                            *NERDTreeSortOrder*
 Values: a list of regular expressions.
@@ -702,7 +759,7 @@ Other examples: >
     (3) ['\/$', '\.rb$', '\.php$', '*', '\.swp$',  '\.bak$', '\~$']
 <
 1. Directories will appear last, everything else will appear above.
-2. Every will simply appear in alphabetical order.
+2. Everything will simply appear in alphabetical order.
 3. Dirs will appear first, then ruby and php. Swap files, bak files and vim
    backup files will appear last with everything else preceding them.
 
@@ -712,7 +769,7 @@ Values: 0 or 1.
 Default: 1.
 
 This option, along with |NERDTreeWinPos|, is used to determine where the NERD
-tree window appears. 
+tree window appears.
 
 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).
@@ -729,7 +786,7 @@ 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. 
+the window will appear on the right or bottom of the screen.
 
 This option is makes it possible to use two different explorer type
 plugins simultaneously. For example, you could have the taglist plugin on the
@@ -782,7 +839,27 @@ Don't be shy --- the worst he can do is slaughter you and stuff you in the
 fridge for later ;)
 
 ==============================================================================
-7. Changelog                                               *NERDTreeChangelog* 
+7. Changelog                                               *NERDTreeChangelog*
+
+2.10.0
+    - added bookmarks, see :help NERDTreeBookmarkCommands for details. Thanks
+      to Piotr Czachur for all his testing and suggestions.
+    - fixed screen jumping bug with when &scrolloff != 0
+    - fixed some bugs with copying nodes
+    - other random fixes
+    - change license to wtfpl
+
+2.9.0
+
+    - path handling improvements, thanks to Zhang Shuhan for heaps of
+      testing/bug reports
+        * improved how paths are stored, now the script will no longer get
+          confused about drives on MF Windows
+        * made the script way better at handling paths with strange characters
+          in them (eg '$@; etc)
+    - applied a patch from Cory Echols
+        * add the command :NERDTreeClose to close the tree for the current tab
+        * set the filetype for the NERD tree buffer to "nerdtree"
 
 2.8.0
     - added an option to enable/disable line numbers in the NERD tree window,
@@ -796,7 +873,7 @@ fridge for later ;)
 2.7.0
     - Bug fix: Now when you have the tree on the right and you open it with
       multiple windows stacked, it will take up the full height of the vim
-      window. 
+      window.
     - Now line numbers always turned off in the tree by default
     - Implemented copying of nodes (via the filesystem menu) for *nix/macosx
     - took the help doc out of the script and repackaged the whole thing as a
@@ -871,13 +948,13 @@ fridge for later ;)
     - Made the quickhelp correctly display the current single/double click
       mappings for opening nodes as specified by the NERDTreeMouseMode option.
     - Fixed a bug where the script was spazzing after prompting you to delete
-      a modified buffer when using the filesystem menu.  
+      a modified buffer when using the filesystem menu.
     - Refactoring
 2.2.3
     - Refactored the :echo output from the script.
     - Fixed some minor typos in the doc.
     - Made some minor changes to the output of the 'Tree filtering mappings'
-      part of the quickhelp 
+      part of the quickhelp
 
 2.2.2
     - More bugfixes... doh.
@@ -982,7 +1059,7 @@ Thanks to Michael Madsen for emailing me about making case sensitivity
 optional when sorting nodes.
 
 Thanks to AOYAMA Shotaro for suggesting that i echo a "please wait" message
-when opening large directories. 
+when opening large directories.
 
 Thanks to Michael Madsen for requesting the NERDTreeCaseSensitiveSort option.
 
@@ -999,3 +1076,18 @@ the &hidden option is set.
 
 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.
+
+Thanks to Cory Echols for sending a patch to add the :NERDTreeClose command and
+set the NERD tree buffers filetype to 'nerdtree'
+
+Thanks to Piotr Czachur for all his suggestions and testing for the bookmarks
+feature.
+
+==============================================================================
+9. License                                                   *NERDTreeLicense*
+
+The NERD tree is released under the wtfpl.
+See http://sam.zoy.org/wtfpl/COPYING.