summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/BUGS51
-rw-r--r--doc/ChangeLog56
-rw-r--r--doc/DOWNLOAD43
-rw-r--r--doc/FAQ41
-rw-r--r--doc/NEWS3
5 files changed, 192 insertions, 2 deletions
diff --git a/doc/BUGS b/doc/BUGS
new file mode 100644
index 000000000..5d9d29539
--- /dev/null
+++ b/doc/BUGS
@@ -0,0 +1,51 @@
+How to report a bug in Debian Live
+==================================
+
+"No software is perfect... we need your help!"
+
+Debian Live is far from being perfect, but we want to make it as close as
+possible to perfect - with your help.
+
+Do not hesitate to report a bug: it is better to fill a report twice than never.
+However, here are some recommendations how to file good bug reports.
+
+
+1. Where does the bug appear?
+-----------------------------
+
+...at build time while bootstrapping?
+
+make-live first bootstraps a basic Debian system with cdebootstrap(1) or
+debootstrap(8). Depending on both cdebootstrap/debootstrap and the Debian
+distribution it is bootstrapping, it runs sucessful or not. If a bug appears
+here, check if the error is related to a specific Debian package (most likely),
+or if it is related to cdebootstrap/debootstrap itself.
+
+In both cases, this is not a bug in Debian Live, but rather in Debian itself. We
+can not fix this directly. Instead, report such a bug against the cdebootstrap
+package, or the failing package.
+
+
+...at build time while installing packages?
+
+Debian Live installs additional packages from the Debian archive. Depending on
+the Debian distribution used and the daily archive state, it can fail. If a bug
+appears here, check if the error is also reproducible on a normal system.
+
+If this is the case, this is not a bug in Debian Live, but rather in Debian
+again. Report it against the failing package.
+
+
+...at run time?
+
+If a package was successfully installed, but fails while actually running the
+Live system, this is probably a bug in Debian Live.
+
+
+2. Where to send the bug report?
+--------------------------------
+
+Report error logs of build time errors to live-package and run time errors to
+casper in the Debian Bug Tracking System. If you are unsure or need more help
+before submitting a bug report, you can always send a message to
+<debian-devel-live@lists.alioth.debian.org>. We will help you to figure it out.
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 65b509420..307058002 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,59 @@
+2007-04-23 Daniel Baumann <daniel@debian.org>
+
+ * Makefile:
+ - Added simple test rule.
+ * functions/*, helpers/*:
+ - Added LH_ROOT_COMMAND to support sudo.
+ * functions/package.sh:
+ - Added. Helper dependencies in-chroot can now be handled by
+ functions.
+ * helpers/make-live:
+ - Added trap to unmount proc and sys on exit and failure.
+ * Uploaded 1.0~a7-1.
+
+2007-04-22 Daniel Baumann <daniel@debian.org>
+
+ * functions/defaults.sh:
+ - In ubuntu mode, setting default sections to main restricted.
+ * helpers/lh_binary_grub:
+ - Making copy call of grub arch independent.
+ * helpers/lh_chroot_sources:
+ - In debian mode, checking for non-sid rather than if-etch.
+ - Fixed wrong Ubuntu security URL.
+
+2007-04-20 Daniel Baumann <daniel@debian.org>
+
+ * helpers/lh_binary_rootfs, lh_binary_iso:
+ - Added mksquashfs/genisoimage quiet/verbose options.
+
+2007-04-19 Daniel Baumann <daniel@debian.org>
+
+ * helpers/lh_binary_grub, lh_binary_syslinux:
+ - Added check for splash in config directory.
+
+2007-04-18 Daniel Baumann <daniel@debian.org>
+
+ * debian/cron.daily, default:
+ - Added.
+ * doc/BUGS, DOWNLOAD:
+ - Added.
+ * examples/edu.sources.list, fai.sources.list:
+ - Added.
+ * manpages/*:
+ - Added language suffix.
+ - Added German translations.
+
+2007-04-17 Daniel Baumann <daniel@debian.org>
+
+ * helpers/lh_chroot_hooks:
+ - Also check for tasks specific hooks, not just for package lists.
+ * helpers/lh_chroot_tasks:
+ - Allowing to use either aptitude or tasksel.
+ * hooks/kde-desktop:
+ - Added.
+ * manpages/lh_build.1, lh_source.1:
+ - Added.
+
2007-04-16 Daniel Baumann <daniel@debian.org>
* functions/defaults.sh:
diff --git a/doc/DOWNLOAD b/doc/DOWNLOAD
new file mode 100644
index 000000000..60b67533e
--- /dev/null
+++ b/doc/DOWNLOAD
@@ -0,0 +1,43 @@
+Download of prebuilt images
+===========================
+
+Although Debian Live is about creating your own customized Live system, we offer
+some prebuilt images as well. Currently, builds for the three desktop
+environments GNOME[0], KDE[1] and Xfce[2] as well as the standard system are
+available. Builds based on testing are created every week and the ones based on
+unstable are build daily. For stable, we build update them when needed.
+
+Currently, the following flavours are autobuilt here (.iso for CD/DVD images,
+.img for USB stick images):
+
+ * debian-live-${DIST}-${ARCH}-standard
+
+ only packages of priority standard or higher and a few live specific
+ packages (eject, file and sudo).
+
+ * debian-live-${DIST}-${ARCH}-gnome-desktop
+
+ the standard system, laptop related packages (laptop task) and the GNOME[1]
+ desktop environment (desktop and gnome-desktop tasks).
+
+ * debian-live-${DIST}-${ARCH}-kde-desktop
+
+ the standard system, laptop related packages (laptop task) and the KDE[2]
+ desktop environment (desktop and kde-desktop tasks).
+
+ * debian-live-${DIST}-${ARCH}-xfce-desktop
+
+ the standard system, laptop related packages (laptop task) and the Xfce[3]
+ desktop environment (desktop and xfce-desktop tasks).
+
+Note: Currently, we build images for lenny (aka "testing") and sid (aka
+"unstable"). Due to the nature of unreleased Debian versions, it is possible
+that no or not all images could be built because of uninstallable packages.
+Please be patient then and wait for the next builds, use the previous, or do it
+on your own by using live-helper. If you want something which works for sure,
+use the etch (aka "stable") builds.
+
+ [0] http://packages.debian.org/live-helper
+ [1] http://www.gnome.org/
+ [2] http://www.kde.org/
+ [3] http://www.xfce.org/
diff --git a/doc/FAQ b/doc/FAQ
index 593346bfc..ceb87d6e7 100644
--- a/doc/FAQ
+++ b/doc/FAQ
@@ -1,5 +1,5 @@
-Debian Live: Frequently Asked Questions (FAQ)
-=============================================
+Frequently Asked Questions (FAQ)
+================================
Build Time
----------
@@ -9,10 +9,22 @@ A: live-helper supports Debian and Ubuntu right now. Adding automatic defaults
for other Debian derivatives is easy - let us know about them and we may
include it.
+
+Q: How can I build images with an unprevileged user account?
+A: You can use --root-command sudo or set LH_ROOT_COMMAND="sudo" in
+ config/common.
+
+ *BIG* *FAT* *WARNING*: Building an image as non-root can make your image
+ different compared to a regular Debian system (different owners of files). It
+ is *NOT* recommended to build images as non-root. Do *NOT* use this feature
+ yet.
+
+
Q: How do I drop in to a shell during make-live chroot process?
A: Use "--interactive shell", then exit with 'logout' when you have made the
setting changes you want and the build process will continue.
+
Q: Where to set the username or the hostname?
A: casper uses default username 'casper' and hostname 'live'. You can specify
them by passing 'username=' and 'hostname=' as kernel parameters.
@@ -22,6 +34,30 @@ A: casper uses default username 'casper' and hostname 'live'. You can specify
--hostname to make-live, or alter LIVE_USERNAME and LIVE_HOSTNAME in
config/image.
+
+Q: How can I make my own grub bootsplash?
+A: To add a grub splash screen, you can use --grub-splash FILE, or copy your
+ custom splash to config/binary_grub/splash.xpm.gz.
+
+ Documentation about creating a bootsplash for grub can be found at:
+ <http://ruslug.rutgers.edu/~mcgrof/grub-images/>
+
+
+Q: How can I make my own syslinux bootsplash?
+A: To add a syslinux splash screen, you can use --syslinux-splash FILE, or copy
+ your custom splash to config/binary_syslinux/splash.rle.
+
+ Documentation about creating a bootsplash for grub can be found at:
+ <http://www.sweb.cz/Frantisek.Rysanek/splash/isolinux-splash-HOWTO.html>
+ contrib/syslinux-splash/COPYING in the live-helper sources.
+
+ Basically, you need to install netpbm and syslinux, and run this:
+ anytopnm < $your_splash > $your_splash.pnm
+ pnmcolormap 15 < $your_splash.pnm > $your_splash.map
+ pnmremap -map=$your_splash.map $your_splash.pnm | \
+ ppmtolss16 '#ffffff=7' > splash.rle
+
+
Run Time
--------
@@ -29,5 +65,6 @@ Q: What is the root password?
A: There is none set. You can switch to root with 'sudo -i' or set a password
with 'sudo passwd'.
+
Q: What is the user password?
A: The password for the default user is 'live'.
diff --git a/doc/NEWS b/doc/NEWS
index d5b9c786e..94460a321 100644
--- a/doc/NEWS
+++ b/doc/NEWS
@@ -25,3 +25,6 @@ News:
http://lists.alioth.debian.org/pipermail/debian-live-devel/2007-February/000836.html
* 2007-03-12: Uploaded first live-helper to Debian unstable.
+
+ * 2007-04-19: Google Summer of Code 2007
+ http://lists.alioth.debian.org/pipermail/debian-live-devel/2007-April/001221.html