Update changelog and docs for new release (0.9.13)
[grml2usb.git] / grml2usb.8.txt
index 43b7ac6..61b97c2 100644 (file)
@@ -145,7 +145,7 @@ file no matter whether you're using grub or syslinux as bootloader.
 
   *\--syslinux*::
 
-This option is deprecated and is being left only for backwards compability
+This option is deprecated and is being left only for backwards compatibility
 reasons. Syslinux is the default bootloader of grml2usb and therefore the
 '--syslinux' option doesn't have any effects. If you do not want to use syslinux
 as bootloader consider using the '--grub' option.
@@ -215,24 +215,14 @@ Directory layout on usb device
     |       |-- linux26
     |       |-- initrd.gz
     |-- grub/
-    |   |-- grml.png         [splash screen for grub2]
+    |   |-- grml.png         [graphical bootsplash background image for grub2]
     |   |-- grub.cfg         [configuration file for grub2]
     |   |-- menu.lst         [configuration file for grub1]
     |   |-- splash.xpm.gz    [splash screen for grub1]
     `-- syslinux/
-        |-- boot.msg         [boot splash for syslinux]
-        |-- f1               [screen when pressing f1]
-        |-- f2               [screen when pressing f2]
-        |-- f3               [...]
-        |-- f4
-        |-- f5
-        |-- f6
-        |-- f7
-        |-- f8
-        |-- f9
-        |-- f10
-        |-- logo.16          [graphical part of boot splash]
-        `-- syslinux.cfg     [configuration file for syslinux]
+        |-- grml.png         [graphical bootsplash background image for syslinux]
+        |-- syslinux.cfg     [main configuration file for syslinux]
+        `-- [....]           [several further config files for syslinux]
 
   grml/
     |-- grml2usb.txt         [not yet implemented]
@@ -389,30 +379,30 @@ grml2usb) and you can carry additional files on a writable medium with yourself.
 Why can't I just dd the ISO to a USB device?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Well, you can. :)
+Well, you can. :) Starting with grml 2009.10 the ISOs are dd-able straight out-of-the-box.
 
 [IMPORTANT]
 Note that ANY existing data on your USB device will be destroyed when
 using the dd approach.
 
+///////////////////////////////////////////////////////////////////////////////////////////////////
 Grab a recent grml ISO and use
 link:http://syslinux.zytor.com/wiki/index.php/Doc/isolinux#HYBRID_CD-ROM.2FHARD_DISK_MODE[isohybrid
 from the syslinux project]:
 
   % isohybrid grml_2009.05.iso
+///////////////////////////////////////////////////////////////////////////////////////////////////
 
-This allows you to dd the grml ISO to your USB device (use for example
+This allows you to dd the Grml ISO to your USB device (use for example
 link:http://www.chrysocome.net/rawwrite[rawwrite] if you've just a Windows
 system available) running:
 
-  % dd if=grml_2009.05.iso of=/dev/sdX
+  % dd if=grml_2009.10.iso of=/dev/sdX
 
-where /dev/sdX is your USB device.
-
-[TIP]
-Upcoming stable versions of grml will provide dd-able ISOs straight
-out-of-the-box (and current link:http://daily.grml.org/[daily snapshots] already
-do) using a so called manifold boot method.
+where /dev/sdX is your USB device. Of course this doesn't provide such a
+flexible system like with grml2usb (no multi-ISO setup, no additional default
+bootoptions,...) but it's a nice way to get a working USB boot setup if you
+don't have grml2usb available.
 
 [[grml2usb-vs-dd]]
 What's the difference between grml2usb and just using dd?
@@ -420,7 +410,7 @@ What's the difference between grml2usb and just using dd?
 
 grml2usb does not remove any data from your USB device and does not alter the
 partition table at all. grml2usb provides multi-ISO support, support for adding
-default bootoptions and selecting the bootloader (grub vs. syslinux) without
+default bootoptions and selecting the bootloader (syslinux vs. grub) without
 having to manually touch the ISO at all.
 
 [[grml2iso]]
@@ -430,6 +420,25 @@ What's grml2iso?
 grml2iso is a script which uses grml2usb to generate a multiboot ISO out of
 several grml ISOs. See 'man grml2iso' for further details.
 
+[[grml2usb-compat]]
+grml2usb fails with "Fatal: file default.cfg could not be found."
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you are trying to install an older grml ISO (older than grml 2009.10) with a
+recent version of grml2usb then you might notice:
+
+  Fatal: file default.cfg could not be found.
+  Note:  this grml2usb version requires an ISO generated by grml-live >=0.9.24 ...
+         ... either use grml releases >=2009.10 or switch to an older grml2usb version.
+         Please visit http://grml.org/grml2usb/#grml2usb-compat for further information
+  Fatal: a critical error happend during execution (not a grml ISO?), giving up
+
+Breaking the backward compatibility was necessary to avoid maintainability hell.
+If you want to install older grml ISOs please grab the grml2usb-compat Debian
+package which provides support for older releases or the
+link:http://grml.org/grml2usb/grml2usb-compat.tgz[grml2usb-compat tarball]
+(link:http://grml.org/grml2usb/grml2usb-compat.tgz.md5.asc[gpg signature/md5]).
+
 [[menu-lst]]
 Why is there a menu.lst and a grub.cfg inside /boot/grub/?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~