summaryrefslogtreecommitdiff
path: root/manual/xml/cleaning_up_a_session.xml
diff options
context:
space:
mode:
authorTim Mayberry <mojofunk@gmail.com>2007-02-02 04:29:55 +0000
committerTim Mayberry <mojofunk@gmail.com>2007-02-02 04:29:55 +0000
commit56e384349b1c64b56e4c26faa6df788358d511e1 (patch)
tree45b56ab37919399abdf5f1aec05dbfd06a84df93 /manual/xml/cleaning_up_a_session.xml
parente0991be04d5fad5715a90b1fa6e38bcb5a0e5bce (diff)
Add the ardour manual converted to docbook format with only a few minor
additions. Add dbhelper.vim key stroke mappings I use for working with docbook source. There are no xsl or css files for customizing the html output so it will look really boring...this will only be temporary. Support for content localization and generation of pdf's is planned. git-svn-id: svn://localhost/ardour2/trunk@1405 d708f5d6-7413-0410-9779-e7cbd77b26cf
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>