Bug fix: Strip :args from :mksession output

Author: xolox

README.md

@@ -178,7 +178,7 @@ If you have questions, bug reports, suggestions, etc. the author can be contacte
 ## License
 
 This software is licensed under the [MIT license](http://en.wikipedia.org/wiki/MIT_License).  
-© 2011 Peter Odding &lt;<peter@peterodding.com>&gt;.
+© 2013 Peter Odding &lt;<peter@peterodding.com>&gt;.
 
 ## Sample session script
 

autoload/xolox/session.vim

@@ -1,9 +1,9 @@
 " Vim script
 " Author: Peter Odding
-" Last Change: January 15, 2012
+" Last Change: April 17, 2013
 " URL: http://peterodding.com/code/vim/session/
 
-let g:xolox#session#version = '1.5'
+let g:xolox#session#version = '1.5.1'
 
 " Public API for session persistence. {{{1
 
@@ -106,6 +106,8 @@ function! xolox#session#save_state(commands) " {{{2
     set ssop-=options ssop+=resize
     execute 'mksession' fnameescape(tempfile)
     let lines = readfile(tempfile)
+    " Remove the mode line added by :mksession because we'll add our own in
+    " xolox#session#save_session().
     if lines[-1] == '" vim: set ft=vim :'
       call remove(lines, -1)
     endif
@@ -127,6 +129,13 @@ function! s:state_filter(line)
     " mirrored NERDTree windows.
     return '" ' . a:line
   elseif a:line =~ '^file .\{-}\[BufExplorer\]$'
+    " Same trick (about the E95) for BufExplorer.
+    return '" ' . a:line
+  elseif a:line =~ '^args '
+    " The :mksession command adds an :args line to the session file, but when
+    " :args is executed during a session restore it edits the first file it is
+    " given, thereby breaking the session that the user was expecting to
+    " get... I consider this to be a bug in :mksession, but anyway :-).
     return '" ' . a:line
   else
     return a:line

doc/session.txt

@@ -1,5 +1,38 @@
 *session.txt*  Extended session management for Vim
 
+===============================================================================
+                                                              *session-contents*
+Contents ~
+
+ 1. Introduction                                          |session-introduction|
+ 2. Installation                                          |session-installation|
+ 3. Commands                                                  |session-commands|
+  1. The |:SaveSession| command
+  2. The |:OpenSession| command
+  3. The |:RestartVim| command
+  4. The |:CloseSession| command
+  5. The |:DeleteSession| command
+  6. The |:ViewSession| command
+ 4. Options                                                    |session-options|
+  1. The |sessionoptions| setting
+  2. The |g:session_directory| option
+  3. The |g:session_autoload| option
+  4. The |g:session_autosave| option
+  5. The |g:session_default_to_last| option
+  6. The |g:session_persist_globals| option
+  7. The |g:session_restart_environment| option
+  8. The |g:session_command_aliases| option
+  9. The |g:loaded_session| option
+ 5. Compatibility with other plug-ins |session-compatibility-with-other-plug-ins|
+ 6. Known issues                                          |session-known-issues|
+ 7. Contact                                                    |session-contact|
+ 8. License                                                    |session-license|
+ 9. Sample session script                                |sample-session-script|
+
+===============================================================================
+                                                          *session-introduction*
+Introduction ~
+
 The 'session.vim' plug-in improves upon Vim's built-in |:mksession| command by
 enabling you to easily and (if you want) automatically persist and restore
 your Vim editing sessions. It works by generating a Vim |script| that restores
@@ -322,8 +355,8 @@ If you like the script please vote for it on Vim Online [11].
                                                                *session-license*
 License ~
 
-This software is licensed under the MIT license [12]. Copyright 2011 Peter
-Odding <peter@peterodding.com>.
+This software is licensed under the MIT license [12]. Š 2013 Peter Odding
+<peter@peterodding.com>.
 
 ===============================================================================
                                                          *sample-session-script*