###############
Persistent data
###############

    Implementation of "persistent mode" has changed in this version. And the
"persistent data" will be saved in a squashfs image. If you are upgrading from
an older version, your "persistent data" won't lost. They'll be converted to
the new format automatically.

    In case you do want to keep a copy of your data in the old format, please
backup before upgrading.

#################
X keyboard layout
#################

    Since version 0.9.1, CDlinux will try to guess your keyboard layout. In
most case, CDlinux will choose the best keyboard layout for X automatically.

    E.g. if you choose a ja_JP locale, CDlinux will set your XkbModel to
"jp106", and XkbLayout to "jp".

    But sometimes CDlinux may choose a xkb layout that you don't want. In this
case, you can always press "alt+shift" to switch to the standard "us" XkbLayout
and then modify /etc/X11/xorg.conf as you wish.

####################
Upgrading from 0.6.x
####################

    If you're upgrading from an older version, your own packages (in the local/
folder) and persistent data (in the settings/ folder) will be kept. But if your
original CDlinux version is 0.6.x or earlier, X Window may not run properly.

    This is due to changes from Xorg 7.4 to Xorg 7.3. In this case, you can use
the "Safe Graphics Mode" by either select it from the boot menu or using the
kernel command line option:

	CDL_SAFEG=yes

    Then remove the old /etc/X11/xorg.conf (backup first!), and reboot. CDlinux
will re-create a new correct version for you.

##############
Known Problems
##############

    Sometimes you may lost the input focus in X. If this happened, just switch
to another window, then switch back. This is caused by a patch applied to SCIM
to make Java applications work with SCIM. There's no fix for this problem yet.
But fortunately, this rarely happens.

######
Cramfs
######

    Old style cramfs based CDlinux modules are not supported anymore. It's been
5 years since the introduction of the new style squashfs based modules. Now it
is the time to say bye-bye to cramfs modules. If you are still using cramfs for
your modules, please consider upgrade to squashfs now.

#############
ISO emulation
#############

    This version supports boot directly from the ISO image via GRUB4DOS. Recent
versions of GRUB4DOS supports ISO emulation, here is a example menu.lst entry
to boot the CDlinux ISO:

#============================== begin ==============================#
title GNU/CDlinux (ISO emulation)
        map --mem (hd0,0)/boot/CDlinux/CDlinux.iso (hd32)
        map --hook
        map --status
        kernel (hd32)/boot/CDlinux/bzImage quiet CDL_IMG=CDlinux.iso
        initrd (hd32)/boot/CDlinux/initrd
        map --unhook
        boot
#=============================== end ===============================#


##########
Auto mount
##########

    By default, this version will auto detect and mount all available disks and
partitions (cold-plug and hot-plug). If for any reason you do not want this
feature, you can use the following kernel command line option:

	CDL_AMOUNT=no