aboutsummaryrefslogtreecommitdiff
path: root/doc/bugs.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/bugs.txt')
-rw-r--r--doc/bugs.txt46
1 files changed, 0 insertions, 46 deletions
diff --git a/doc/bugs.txt b/doc/bugs.txt
deleted file mode 100644
index 55579343..00000000
--- a/doc/bugs.txt
+++ /dev/null
@@ -1,46 +0,0 @@
-
-Reporting bugs
---------------
-
- Naturally it is easiest for me if you already know what causes the
- unexpected behavior. Even better if you have a patch to propose.
- However, quite often the reason for unexpected behavior is unknown,
- so below are a few things what to do before sending a bug report.
-
- In case of a crash (usually segmentation violation):
-
- 1. Try to create a small example how to reprocude the issue.
-
- 2. If you are writing an application using liblzma or libzfile,
- double check that you are using the libraries correctly (for
- example, that you didn't forget to call lzma_init()). If it is
- the command line tool included in LZMA Utils that is crashing,
- ignore this step.
-
- 3. Compile LZMA Utils with debugging code using configure switch
- `--enable-debug'. If you are using GCC as the compiler, use
- CFLAGS='-O0 -ggdb'. Don't strip the resulting binaries.
-
- 4. Turn on core dumps. The exact command depends on your shell;
- for example in GNU bash it is done with `ulimit -c unlimited',
- and in tcsh with `limit coredumpsize unlimited'.
-
- 5. Try to reproduce the suspected bug. If you get `assertion failed'
- message, be sure to include the complete message in your bug
- report. If the application leaves a coredump, get a backtrace
- using gdb:
- $ gdb /path/to/app-binary # Loads the app to the debugger.
- (gdb) core core # Opens the coredump.
- (gdb) bt # Prints the backtrace. Copy & paste to bug report.
- (gdb) quit # Quits gdb.
-
- Send your bug report to Lasse Collin <lasse.collin@tukaani.org>. Don't
- send the core dump file or the actual executables. If you have a small
- example file(s) (total size less than 100 KiB), please include it/them
- as an attachment.
-
- Do NOT complain about problems with LZMA Utils to Igor Pavlov.
- Although the code of LZMA Utils is derived from his code, there are
- a lot of changes, which may have introduced bugs not present in
- the original version.
-