Readme for Source Mage ISO release 0.9.5, codename "disrupt undead"
This file describes known issues with the ISO, and other post-release notes.

First of all, this is the first of the ISOs with the new line of installer
menus and the new generation scripts. Therefore, not everything may be perfect
yet. Specifically, error handling can be stupid sometimes, and the user is not
warned when doing Silly Things (tm).

=== Errata:
 = It is recommended that you rebuild your system after finishing the install
   and setting up compilation options and networking. This does take some time
   and needs to download all sources of the installed packages, but it ensures
   that all of your system is built tailored for your architecture and with
   your chosen optimizations.
   If you do NOT want to rebuild, please note:
   - An optimized (i.e. compiled, not installed from ISO) g++ does not work
     without an equally optimized gcc. This means:
   - If you install a package that needs g++ and get strange errors/behavior
     that break the compilation, you need to rebuild gcc and g++. The command
     for this is "cast -c gcc g++" (without the quotes)
   - It is recommended to rebuild at least glibc and gcc for your system
     anyway, since those will have the most impact on the speed of your system
     and the speed at which packages are built.
     "cast -c glibc gcc" is the appropriate command.

 = The ISO does not install an /etc/hosts file. To fix this, cast -c
   netkit-base (this is included in the above sorcery rebuild)

 = If you have trouble unpacking the ISO:
   Do not use tar to unpack it: tar -xjvf smgl-[...].iso.bz2 does not work.
   The ISO is a bzip2 compressed ISO image, not a bzip2 compressed tarball.
   The command to run is:
     bunzip2 smgl-[...].iso.bz2
   You will then get a .iso file that you can burn onto a CD-R[W] and boot.