manual/xml/cleaning_up_a_session.xml

   1 <?xml version="1.0" standalone="no"?>
   2
   3 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
   4
   5 ]>
   6
   7 <section id="sn-cleaning-up-a-session">
   8   <title>Cleaning up a Session</title>
   9   <para>
  10     placeholder text: needs editing and references to menu items
  11   </para>
  12
  13   <para>
  14     Cleanup looks for audio files that were recorded by ardour for this
  15     session, but are no longer in use. "In use" means "present in any
  16     playlist in any snapshot of the session". If you have unused playlists
  17     (e.g. alternate takes) cleanup will volunteer to delete them for you.
  18     then it will search all snapshots (including the one you are working
  19     with), and move all unused captured audio files into the "dead_sounds"
  20     directory within the session. At this point, you could still potentially
  21     get material that was "cleaned up" back, though its quite tricky to do.
  22   </para>
  23
  24   <para>
  25     It is advisable, even <emphasis>firmly recommended</emphasis> that after
  26     this cleanup step, you save the session, exit ardour and restart. This
  27     will enable you to confirm that the session still works as expected. If
  28     all goes well (and it should), you can then do the 2nd phase cleanup,
  29     which will remove the files from the <filename>dead_sounds</filename>
  30     directory (at which point, the material is not recoverable without
  31     backups on your part).
  32   </para>
  33
  34   <para>
  35     Note that the presence of snapshots can cause user confusion, as in "why
  36     didn’t cleanup do anything?" The answer is frequently that there are
  37     all capture audio files are in use in this snapshot or in others.
  38   </para>
  39 <!--
  40         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  41                 href="Some_Subsection.xml" />
  42         -->
  43 </section>