                                 Disc Logging

*****************************************************************************
 PLEASE REMEMBER THIS SOFTWARE COMES WITH NO WARRANTY AND YOU USE IT AT YOUR
 OWN RISK.  See the file LICENSE for more information.
*****************************************************************************

I am currently using this system to log the discs I burn.  There is currently
a limitation on it logging the discs, however, it cannot deal with discs that
have subdirectories, all of the files must be in the root directory.  I hope
to have this problem fixed in the near future (Feature Request #1848644).

The procedure I use is as follows:

  1) I create a directory with the id of the disc:

         mkdir /tmp/20071224-001

     The 20071224 is of course the date in YYYYMMDD format.  If I burn more 
     than one disc on a particular day, I increment the last three digits,
     for example: 20071224-002.

  2) I then move or create the files I want to save into that directory:

         cd /tmp/20071224-001
         compress_sparse compressed-071224 | tee compress_sparse-071224.txt
         diff_compressed /media/cdrom0/compressed-070825 compressed-071224 \
          diff-070825-071224 | tee diff-070825-071224.txt
	 md5sum compressed-071224 > compressed-071224.md5

     (See Document_Storage.txt for more information on compress_sparse and
      diff_compressed.)

  3) Create a disc list in the system:

         disc_list /tmp/20071224-001

         Disk id: 20071224-001

  4) Burn the disc to both a DVD+R and a DVD-R (who knows which lasts longer):

         growisofs -Z /dev/hdd -speed=4 -R -V 20071224-001 /tmp/20071224-001/
         growisofs -Z /dev/hdd -speed=4 -R -V 20071224-001 /tmp/20071224-001/

  5) Put the first disc in the drive and log it:

         mount /media/cdrom0
         log_disc /media/cdrom0
           ....
         Copy number: 1

         Available locations:

            0=create new
            P=person

         Selection: 0
         name: bookcase

     **********************************************************************
     * PLEASE NOTE: there is currently a restriction on what words can be *
     * used in the name.  You can only use words that are in the Public   *
     * Objects.  See the file Public_Spellings.txt for a complete list.   *
     * Please check this file for any words you want to use before using  *
     * the log_disc program.  Hopefully, I can fix this limitation in the *
     * near future.  If you would like any words added to the Public      *
     * Objects please e-mail me at j.scott.edwards.nwos@gmail.com.        *
     *                                                                    *
     * Sorry for the inconvience!                                         *
     **********************************************************************

  6) Put the second disc in the drive and log it:

         mount /media/cdrom0
         log_disc /media/cdrom0
           ....
         Copy number: 2

         Available locations:

            0=create new
            1=Bookcase
            P=person

         Selection: 0
         name: safe deposit box

  7) You can list the discs that have been logged with the list_discs command:

         list_discs

     and you can use the --contents option to list the files on each disc:

         list_discs --contents

  8) You can get the MD5 (or SHA1 or SHA256) checksums of any of the files
     with the list_files command:

         list_files --md5


One additional thing: when I store photos I usually burn one DVD with the
photos untouched, exactly as they were on the camera, using the same procedure
as I outlined above.  Then after I have modified some of the photos (for
example rotate the portrait ones to the correct orientation) I burn a second
disc.  When I log the second disc I use the --add-revision option to disc_list:

         disc_list --add-revision /tmp/20071224-003

This way the system knows the second file is a revision of the first file.

