From bacf8f325d846be017e5bf27316ef4641fd2399e Mon Sep 17 00:00:00 2001 From: Michael Prokop Date: Wed, 21 Oct 2009 23:51:26 +0200 Subject: [PATCH] Update changelog and docs for new release (0.9.13) --- debian/NEWS | 21 +++++++++++--------- debian/changelog | 7 ++++--- grml2usb | 3 ++- grml2usb.8.txt | 59 ++++++++++++++++++++++++++++++++------------------------ 4 files changed, 52 insertions(+), 38 deletions(-) diff --git a/debian/NEWS b/debian/NEWS index 7f7e465..4ff5fba 100644 --- 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 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 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 --- 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 Mon, 19 Oct 2009 02:43:23 +0200 + -- Michael Prokop 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 --- 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 --- 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/? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- 2.1.4