summaryrefslogtreecommitdiff
path: root/manual/xml/cleaning_up_a_session.xml
diff options
context:
space:
mode:
Diffstat (limited to 'manual/xml/cleaning_up_a_session.xml')
-rw-r--r--manual/xml/cleaning_up_a_session.xml45
1 files changed, 45 insertions, 0 deletions
diff --git a/manual/xml/cleaning_up_a_session.xml b/manual/xml/cleaning_up_a_session.xml
new file mode 100644
index 0000000000..8b0077137f
--- /dev/null
+++ b/manual/xml/cleaning_up_a_session.xml
@@ -0,0 +1,45 @@
+<?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-cleaning-up-a-session">
+
+ <title>Cleaning up a Session</title>
+
+ <para>
+ placeholder text: needs editing and references to menu items
+ </para>
+
+ <para> Cleanup looks for audio files that were recorded by ardour for this
+ session, but are no longer in use. "In use" means "present in any
+ playlist in any snapshot of the session". If you have unused playlists
+ (e.g. alternate takes) cleanup will volunteer to delete them for you.
+ then it will search all snapshots (including the one you are working
+ with), and move all unused captured audio files into the "dead_sounds"
+ directory within the session. At this point, you could still
+ potentially get material that was "cleaned up" back, though its quite
+ tricky to do.
+ </para>
+
+ <para>
+ It is advisable, even <emphasis>firmly recommended</emphasis> that after this cleanup
+ step, you save the session, exit ardour and restart. This will enable
+ you to confirm that the session still works as expected. If all goes
+ well (and it should), you can then do the 2nd phase cleanup, which will
+ remove the files from the <filename>dead_sounds</filename> directory (at which point,
+ the material is not recoverable without backups on your part).
+ </para>
+
+ <para>
+ Note that the presence of snapshots can cause user confusion, as in
+ "why didn’t cleanup do anything?" The answer is frequently that there
+ are all capture audio files are in use in this snapshot or in others.
+ </para>
+
+ <!--
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="Some_Subsection.xml" />
+ -->
+
+</section>