Update changelog and docs for new release (0.9.13)

diff --git a/debian/NEWS b/debian/NEWS
index 7f7e465..4ff5fba 100644 (file)
--- a/debian/NEWS
+++ b/debian/NEWS
@@ -6,15 +6,18 @@ grml2usb (0.9.13) unstable; urgency=low
 
   * This release provides decent support for multi-ISO within the
     new vesamenu bootsplash, providing a menu based system.  We had
-    to break backward compability (otherwise the isolinux/syslinux
-    code would be unmaintainable).  Therefore support for older
-    ISOs (everything before grml release 2009.10) had to be
-    dropped. If you still need an old version of Grml on your usb
-    device just use an older version of grml2usb as well (the
-    old grml2usb versions support recent ISOs too, they just
-    don't use/support the new vesamenu bootsplash then).
-
- -- Michael Prokop <mika@grml.org>  Mon, 19 Oct 2009 02:14:29 +0200
+    to break backward compatibility (otherwise the isolinux/syslinux
+    code would be unmaintainable). Therefore support for older ISOs
+    (everything before grml release 2009.10) had to be dropped. If
+    you still need an old version of Grml on your usb device just
+    use an older version of grml2usb (the old grml2usb versions
+    support recent ISOs too, they just don't use/support the new
+    vesamenu bootsplash then). The grml team supports old
+    grml2usb versions through the grml2usb-compat Debian package.
+    Further details are available in the FAQ at
+    http://grml.org/grml2usb/#grml2usb-compat
+
+ -- Michael Prokop <mika@grml.org>  Wed, 21 Oct 2009 23:32:08 +0200
 
 grml2usb (0.9.2) unstable; urgency=low
 

diff --git a/debian/changelog b/debian/changelog
index 9b19400..a7b4e2c 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,9 +1,10 @@
-grml2usb (0.9.13) UNRELEASED; urgency=low
+grml2usb (0.9.13) unstable; urgency=low
 
   [ Ulrich Dangel ]
   * Modified syslinux configuration handling to generate new vesa
     menu entries.
   * Support adding additional isos to existing grml2usb installation.
+  * grml2iso supports new grml2usb using syslinux now.
 
   [ Michael Prokop ]
   * Update documentation regarding syslinux and FAT32 (thanks to
@@ -11,7 +12,7 @@ grml2usb (0.9.13) UNRELEASED; urgency=low
   * Changes with regards to Ulrich's work:
     - Add a check to identify old ISOs which do not ship
       a default.cfg file and abort then. We have to break
-      backward compability, otherwise the isolinux/syslinux
+      backward compatibility, otherwise the isolinux/syslinux
       code would become worse than it's already nowadays.
     - Search for isolinux files in /boot/isolinux/ so the
       correct grml.png is used.
@@ -27,7 +28,7 @@ grml2usb (0.9.13) UNRELEASED; urgency=low
   * Make syslinux the default bootloader (drop --syslinux,
     add --grub instead). Grub fails just too often.
 
- -- Michael Prokop <mika@grml.org>  Mon, 19 Oct 2009 02:43:23 +0200
+ -- Michael Prokop <mika@grml.org>  Wed, 21 Oct 2009 22:25:57 +0200
 
 grml2usb (0.9.12) unstable; urgency=low
 

diff --git a/grml2usb b/grml2usb
index 1b429a6..b3daac1 100755 (executable)
--- a/grml2usb
+++ b/grml2usb
@@ -19,7 +19,7 @@ import datetime, logging, os, re, subprocess, sys, tempfile, time, os.path
 import fileinput
 
 # global variables
-PROG_VERSION = "0.9.13-pre1"
+PROG_VERSION = "0.9.13"
 MOUNTED = set()  # register mountpoints
 TMPFILES = set() # register tmpfiles
 DATESTAMP = time.mktime(datetime.datetime.now().timetuple()) # unique identifier for syslinux.cfg
@@ -1133,6 +1133,7 @@ def copy_bootloader_files(iso_mount, target):
         logging.critical("Fatal: file default.cfg could not be found.")
         logging.critical("Note:  this grml2usb version requires an ISO generated by grml-live >=0.9.24 ...")
         logging.critical("       ... either use grml releases >=2009.10 or switch to an older grml2usb version.")
+        logging.critical("       Please visit http://grml.org/grml2usb/#grml2usb-compat for further information.")
         raise
 
     for filename in 'addons.cfg', 'default.cfg', 'distri.cfg', \

diff --git a/grml2usb.8.txt b/grml2usb.8.txt
index 43b7ac6..61b97c2 100644 (file)
--- a/grml2usb.8.txt
+++ b/grml2usb.8.txt
@@ -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/?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~