Merged with trunk R1612.

git-svn-id: svn://localhost/ardour2/branches/midi@1614 d708f5d6-7413-0410-9779-e7cbd77b26cf

1 files changed, 85 insertions, 0 deletions

diff --git a/manual/xml/closing_a_session.xml b/manual/xml/closing_a_session.xml
new file mode 100644
index 0000000000..4a1449761c
--- /dev/null
+++ b/manual/xml/closing_a_session.xml
@@ -0,0 +1,85 @@
+<?xml version="1.0" standalone="no"?>
+
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+
+]>
+
+<section id="sn-closing-a-session">
+  <title>Closing a Session</title>
+  <para>
+    Ardour only allows you to work on one session at a time (although your
+    computer may be able to run multiple instances of Ardour at one time).
+    This means that to work on a different session than the current one, you
+    will be forced to close the current session. You can either
+  </para>
+
+  <itemizedlist>
+    <listitem>
+      <para>
+        <menuchoice> <guimenu>Session</guimenu>
+        <guisubmenu>Close</guisubmenu> </menuchoice> will close the current
+        session.
+      </para>
+    </listitem>
+
+    <listitem>
+      <para>
+        <menuchoice> <guimenu>Session</guimenu>
+        <guisubmenu>Open</guisubmenu> </menuchoice> will prompt you for the
+        name of a session to work on, and will then close the current
+        session.
+      </para>
+    </listitem>
+
+    <listitem>
+      <para>
+        <menuchoice> <guimenu>Session</guimenu> <guisubmenu>New</guisubmenu>
+        </menuchoice> will open the New Session dialog to collect
+        configuration information for the new session, and will then close
+        the current session.
+      </para>
+    </listitem>
+  </itemizedlist>
+
+  <para>
+    Whenever a session is closed but has been modified since last saved, the
+    Save dialog will appear.
+  </para>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="images/save_session_dialog.png"/>
+    </imageobject>
+  </mediaobject>
+  <para>
+    You have three options when this dialog appears:
+  </para>
+  <orderedlist>
+    <listitem>
+      <para>
+        Save the session before closing it
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        Close the session without saving it
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        Do not close the session
+      </para>
+    </listitem>
+  </orderedlist>
+  <note>
+    <para>
+      If you choose the final option, whatever operation initiated the
+      closing of the session will be stopped. For example, if you were
+      loading a new session while working on an existing one, no new session
+      will be loaded.
+    </para>
+  </note>
+<!--
+	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
+		href="Some_Subsection.xml" />
+	-->
+</section>