[This is preliminary documentation and is subject to change.]
Save the session under a new file name.
A new session object will be created from this new saved file (and returned by this method)
and added to the project. The original session wil not be saved.
- theCurrentSession (Session)
The new created session object, null if save as a new session has been cancelled or failed.