[Debian-live-changes] r1081 - dists/trunk/live-helper/doc

[Daniel Baumann]

Author: daniel
Date: 2007-04-18 06:39:02 +0000 (Wed, 18 Apr 2007)
New Revision: 1081

Added:
   dists/trunk/live-helper/doc/BUGS
   dists/trunk/live-helper/doc/DOWNLOAD
Modified:
   dists/trunk/live-helper/doc/ChangeLog
Log:


Added: dists/trunk/live-helper/doc/BUGS
===================================================================
--- dists/trunk/live-helper/doc/BUGS	2007-04-18 06:32:04 UTC (rev 1080)
+++ dists/trunk/live-helper/doc/BUGS	2007-04-18 06:39:02 UTC (rev 1081)
@@ -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 at lists.alioth.debian.org>. We will help you to figure it out.

Modified: dists/trunk/live-helper/doc/ChangeLog
===================================================================
--- dists/trunk/live-helper/doc/ChangeLog	2007-04-18 06:32:04 UTC (rev 1080)
+++ dists/trunk/live-helper/doc/ChangeLog	2007-04-18 06:39:02 UTC (rev 1081)
@@ -1,6 +1,6 @@
 2007-04-18  Daniel Baumann  <daniel at debian.org>
 
-	* doc/BUGS:
+	* doc/BUGS, DOWNLOAD:
 	  - Added.
 	* manpages/*:
 	  - Added language suffix.

Added: dists/trunk/live-helper/doc/DOWNLOAD
===================================================================
--- dists/trunk/live-helper/doc/DOWNLOAD	2007-04-18 06:32:04 UTC (rev 1080)
+++ dists/trunk/live-helper/doc/DOWNLOAD	2007-04-18 06:39:02 UTC (rev 1081)
@@ -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/