[SCM] live-manual branch, debian-next, updated. debian/3.0_a15-1-40-g6b9f24d

[chals]

The following commit has been merged in the debian-next branch:
commit 6b9f24d96fbe8bc544f06af3976424d3c177d560
Author: chals <chals at altorricon.com>
Date:   Mon Sep 10 15:10:42 2012 +0200

    Clarifying the use of the live-persistence.conf file and adding an example of how to use an image file for persistence.

diff --git a/manual/en/user_customization-runtime.ssi b/manual/en/user_customization-runtime.ssi
index 96890aa..1acd1c1 100644
--- a/manual/en/user_customization-runtime.ssi
+++ b/manual/en/user_customization-runtime.ssi
@@ -112,9 +112,9 @@ _* a partition, identified by its GPT name.
 
 _* a filesystem, identified by its filesystem label.
 
-_* an image file located on the root of any readable filesystem (even an NTFS partition of a foreign OS), identified by its file name. In this case the file name must also use the containing filesystem as the file extension, e.g. "persistence.ext4".
+_* an image file located on the root of any readable filesystem (even an NTFS partition of a foreign OS), identified by its file name.
 
-The volume label for overlays must be #{persistence}#. And in order to fully customize the volume's persistence there must be a file named #{live-persistence.conf}#. See {The live-persistence.conf file}#live-persistence-conf
+The volume label for overlays must be #{persistence}# but it will be ignored unless it contains in its root a file named #{live-persistence.conf}# which is used to fully customize the volume's persistence, this is to say, specifying the directories that you want to save in your persistence volume after a reboot. See {The live-persistence.conf file}#live-persistence-conf for more details.
 
 Here are some examples of how to prepare a volume to be used for persistence. It can be, for instance, an ext4 partition on a hard disk or on a usb key created with, e.g.:
 
@@ -143,7 +143,20 @@ code{
 
 }code
 
-Then copy the #{persistence}# file to the root of a writable partition.
+Then copy the #{persistence}# file to the root of a writable partition. Mount it and create the #{live-persistence.conf}# file *{inside}* the image file.
+
+Imagine you have created your image file in your home directory with an ext4 filesystem. You can copy it to the root of your hard drive's filesystem under #{/persistence}# and mount it in #{/mnt}#, then, if you want to make #{/usr}# persistent but you only want to save the changes you make to that directory and not all the contents of #{/usr}# you can use the "union" option. You can proceed as follows:
+
+code{
+
+ # cp persistence /
+ # mount -t ext4 /persistence /mnt
+ # echo "/usr union" >> /mnt/live-persistence.conf
+ # umount /mnt
+
+}code
+
+You can now reboot and boot your live media with the boot parameter "persistence".
 
 3~live-persistence-conf The live-persistence.conf file
 

-- 
live-manual