diff options
Diffstat (limited to 'manual/xml/cleaning_up_a_session.xml')
-rw-r--r-- | manual/xml/cleaning_up_a_session.xml | 45 |
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> |