diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/BUGS | 51 | ||||
| -rw-r--r-- | doc/ChangeLog | 56 | ||||
| -rw-r--r-- | doc/DOWNLOAD | 43 | ||||
| -rw-r--r-- | doc/FAQ | 41 | ||||
| -rw-r--r-- | doc/NEWS | 3 |
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/ @@ -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'. @@ -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 |