aboutsummaryrefslogtreecommitdiffhomepage
path: root/markup/pod/live-manual/media/text/ro/project_bugs.ssi
diff options
context:
space:
mode:
authorRalph Amissah <ralph.amissah@gmail.com>2021-11-27 21:54:49 -0500
committerRalph Amissah <ralph.amissah@gmail.com>2021-11-27 21:54:49 -0500
commit78b1b83be0cf04b4cba707751b7ad4d97787fe37 (patch)
tree0260daae62c3c0c055b7ec73b274fa82b31b344f /markup/pod/live-manual/media/text/ro/project_bugs.ssi
track document samples used
Diffstat (limited to 'markup/pod/live-manual/media/text/ro/project_bugs.ssi')
-rw-r--r--markup/pod/live-manual/media/text/ro/project_bugs.ssi206
1 files changed, 206 insertions, 0 deletions
diff --git a/markup/pod/live-manual/media/text/ro/project_bugs.ssi b/markup/pod/live-manual/media/text/ro/project_bugs.ssi
new file mode 100644
index 0000000..76a0eba
--- /dev/null
+++ b/markup/pod/live-manual/media/text/ro/project_bugs.ssi
@@ -0,0 +1,206 @@
+:B~ Reporting bugs
+
+1~bugs Reporting bugs
+
+Live systems are 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, this chapter includes
+recommendations on how to file good bug reports.
+
+For the impatient:
+
+_* Always check first the image status updates on our homepage at
+http://live-systems.org/ for known issues.
+
+_* Before submitting a bug report always try to reproduce the bug with the
+*{most recent versions}* of the branch of live-build, live-boot, live-config
+and live-tools that you're using (like the newest 4.x version of live-build
+if you're using live-build 4).
+
+_* Try to give *{as specific information as possible}* about the bug. This
+includes (at least) the version of live-build, live-boot, live-config, and
+live-tools used and the distribution of the live system you are building.
+
+2~ Known issues
+
+Since Debian *{testing}* and Debian *{unstable}* distributions are moving
+targets, when you specify either of them as the target system distribution,
+a successful build may not always be possible.
+
+% FIXME:
+
+If this causes too much difficulty for you, do not build a system based on
+*{testing}* or *{unstable}*, but rather, use *{stable}*. live-build always
+defaults to the *{stable}* release.
+
+Currently known issues are listed under the section 'status' on our homepage
+at http://live-systems.org/.
+
+It is out of the scope of this manual to train you to correctly identify and
+fix problems in packages of the development distributions, however, there
+are two things you can always try: If a build fails when the target
+distribution is *{testing}*, try *{unstable}*. If *{unstable}* does not work
+either, revert to *{testing}* and pin the newer version of the failing
+package from *{unstable}* (see {APT pinning}#apt-pinning for details).
+
+2~ Rebuild from scratch
+
+To ensure that a particular bug is not caused by an uncleanly built system,
+please always rebuild the whole live system from scratch to see if the bug
+is reproducible.
+
+2~ Use up-to-date packages
+
+Using outdated packages can cause significant problems when trying to
+reproduce (and ultimately fix) your problem. Make sure your build system is
+up-to-date and any packages included in your image are up-to-date as well.
+
+2~collect-information Collect information
+
+Please provide enough information with your report. Include, at least, the
+exact version of live-build where the bug is encountered and the steps to
+reproduce it. Please use your common sense and provide any other relevant
+information if you think that it might help in solving the problem.
+
+To make the most out of your bug report, we require at least the following
+information:
+
+_* Architecture of the host system
+
+_* Distribution of the host system
+
+_* Version of live-build on the host system
+
+_* Version of /{debootstrap}/ on the host system
+
+_* Architecture of the live system
+
+_* Distribution of the live system
+
+_* Version of live-boot on the live system
+
+_* Version of live-config on the live system
+
+_* Version of live-tools on the live system
+
+You can generate a log of the build process by using the #{tee}# command. We
+recommend doing this automatically with an #{auto/build}# script (see
+{Managing a configuration}#managing-a-configuration for details).
+
+code{
+
+ # lb build 2>&1 | tee build.log
+
+}code
+
+At boot time, live-boot and live-config store their logfiles in
+#{/var/log/live/}#. Check them for error messages.
+
+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 mailing list), so that we can try to reproduce the errors
+you encountered. If this is difficult (e.g. due to size) you can use the
+output of #{lb config --dump}# which produces a summary of your config tree
+(i.e. lists files in subdirectories of #{config/}# but does not include
+them).
+
+Remember to send in any logs that were produced with English locale
+settings, e.g. run your live-build commands with a leading #{LC_ALL=C}# or
+#{LC_ALL=en_US}#.
+
+2~ Isolate the failing case if possible
+
+If possible, isolate the failing case to the smallest possible change that
+breaks. It is not always easy to do this so if you cannot manage it for your
+report, do not worry. However, if you plan your development cycle well,
+using small enough change sets per iteration, you may be able to isolate the
+problem by constructing a simpler 'base' configuration that closely matches
+your actual configuration plus just the broken change set added to it. If
+you have a hard time sorting out which of your changes broke, it may be that
+you are including too much in each change set and should develop in smaller
+increments.
+
+2~ Use the correct package to report the bug against
+
+If you do not know what component is responsible for the bug or if the bug
+is a general bug concerning live systems, you can fill a bug against the
+debian-live pseudo-package.
+
+However, we would appreciate it if you try to narrow it down according to
+where the bug appears.
+
+3~ At build time while bootstrapping
+
+live-build first bootstraps a basic Debian system with /{debootstrap}/. If a
+bug appears here, check if the error is related to a specific Debian package
+(most likely), or if it is related to the bootstrapping tool itself.
+
+In both cases, this is not a bug in the live system, but rather in Debian
+itself and probably we cannot fix it directly. Please report such a bug
+against the bootstrapping tool or the failing package.
+
+3~ At build time while installing packages
+
+live-build installs additional packages from the Debian archive and
+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 the live system, but rather in
+Debian - please report it against the failing package. Running
+/{debootstrap}/ separately from the Live system build or running #{lb
+bootstrap --debug}# will give you more information.
+
+Also, if you are using a local mirror and/or any sort of proxy and you are
+experiencing a problem, please always reproduce it first by bootstrapping
+from an official mirror.
+
+3~ At boot time
+
+If your image does not boot, please report it to the mailing list together
+with the information requested in {Collect
+information}#collect-information. Do not forget to mention, how/when the
+image failed exactly, whether using virtualization or real hardware. If you
+are using a virtualization technology of any kind, please always run it on
+real hardware before reporting a bug. Providing a screenshot of the failure
+is also very helpful.
+
+3~ At run time
+
+If a package was successfully installed, but fails while actually running
+the Live system, this is probably a bug in the live system. However:
+
+2~ Do the research
+
+Before filing the bug, please search the web for the particular error
+message or symptom you are getting. As it is highly unlikely that you are
+the only person experiencing a particular problem. There is always a chance
+that it has been discussed elsewhere and a possible solution, patch, or
+workaround has been proposed.
+
+You should pay particular attention to the live systems mailing list, as
+well as the homepage, as these are likely to contain the most up-to-date
+information. If such information exists, always include the references to it
+in your bug report.
+
+In addition, you should check the current bug lists for live-build,
+live-boot, live-config and live-tools to see whether something similar has
+already been reported.
+
+2~ Where to report bugs
+
+The ${project} keeps track of all bugs in the Bug Tracking System (BTS). For
+information on how to use the system, please see
+https://bugs.debian.org/. You can also submit the bugs by using the
+#{reportbug}# command from the package with the same name.
+
+In general, you should report build time errors against the live-build
+package, boot time errors against live-boot, and run time errors against
+live-config. If you are unsure of which package is appropriate or need more
+help before submitting a bug report, please report it against the
+debian-live pseudo-package. We will then take care about it and reassign it
+where appropriate.
+
+Please note that bugs found in distributions derived from Debian (such as
+Ubuntu and others) should *{not}* be reported to the Debian BTS unless they
+can be also reproduced on a Debian system using official Debian packages.