summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/BUGS100
1 files changed, 0 insertions, 100 deletions
diff --git a/docs/BUGS b/docs/BUGS
deleted file mode 100644
index a3dc08735..000000000
--- a/docs/BUGS
+++ /dev/null
@@ -1,100 +0,0 @@
-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.
-
-As such, do not hesitate to report a bug: it is better to fill a report twice or
-even to report a potential non-bug than no bug at all.
-
-However, here are some recommendations how to file good bug reports so that they
-are the most effective.
-
-For the impatient:
-
- * Do always reproduce with the most current version of live-helper and
- live-initramfs before submitting a bugreport.
-
- * Do always try to give as *specific* as possible information about the bug.
- This not just includes the version of live-helper and live-initramfs used,
- the distribution of the live system you are building.
-
-
-1. Where does the bug appear?
------------------------------
-
-...at build time while bootstrapping?
-
-live-helper first bootstraps a basic Debian system with debootstrap(8) or
-cdebootstrap(1). Depending on both debootstrap/cdebootstrap 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 debootstrap/cdebootstrap itself. Running lh_bootstrap
-with --debug gives you more information.
-
-Also, if you are using a local mirror or any of sort of (package) proxy and you
-are experiencing a problem with bootstrapping, always reproduce it first by
-bootstrapping from an official Debian mirror.
-
-In all cases above, these are not a bug in live-helper, but rather in Debian
-itself. We can not fix this directly. Instead, report such a bug against the
-failing package, or in case of a bug in the bootstrapping tool, against
-debootstrap or cdebootstrap, or the (package) proxy software you are using.
-
-
-...at build time while installing packages?
-
-live-helper 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 installed
-(non-live) system.
-
-Also, if you are including any sort of unofficial package to your live system
-and you are experiencing problems, rebuild without those before filling a bug
-to make sure that they are not the cause of the failure.
-
-In all cases above, these are not a bug in live-helper, but rather in Debian
-again. Report it against the failing package(s).
-
-
-...at boot time?
-
-If your image does not boot, please report it to the mailing list together with
-the information requested in 2. Do not forget to mention, how/when the image
-failed, in qemu, vmware or real hardware. If you are using a virtualization
-technology of any kind, do always run it on real hardware before reporting a
-bug. Nevertheless, providing a screenshot of the failure is also very helpful.
-
-
-...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 and you are welcome to report
-it to us.
-
-
-2. Where to send the bug report?
---------------------------------
-
-Report error logs of build time errors to live-helper and run time errors to
-live-initramfs 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.
-
-To make the most out of your bug report, we require at least the following
-information:
-
- * Architecture of the host system
- * Version of live-helper on the host system
- * Version of live-initramfs on the live system
- * Version of debootstrap and/or cdebootstrap on the host system
-
- * Architecture of the live system
- * Distribution of the live system
- * Version of the kernel on the live system
-
-Additionally, to rule out other errors, it is always a good idea to tar up your
-config directory and upload it somewhere (do *not* send it as an attachment to
-the mailinglist), so that we can try to reproduce the errors you encountered.