View source for Bugs - Using the Debugger

__NOTOC__
__NOEDITSECTION__
{{Man2top
|lang=en
|rev=2.0.0
|st=d
|Title=Chapter&nbsp;X.&nbsp;Debugging Bluefish
|prev=Man 2 pt03
|Subtitle=Part&nbsp;3.&nbsp;Developing Bluefish
|next=Man 2 ch10s02
}}
== Chapter X. Debugging Bluefish ==
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;">
*[[#1. Using the Debugger|1. Using the Debugger]] 
*[[Man 2 ch10s02|2. Filling a bug report]] 
</div>
== 1. Using the Debugger ==
Here are the detailed steps for sending a useful backtrace to the Bluefish Developer Team.

'''Procedure&nbsp;X.1.&nbsp;Running bluefish under gdb'''

# Get the latest SVN release (see [[Man 2 ch01s04|Section 4, “Latest Developmental Version”]] for info)
# From bluefish, the top directory of the bluefish source, run: <tt>'''./autogen.sh'''</tt><br/> You may have to set some environment variables before running '''autoconf''', as well as providing autoconf with some flags. Also, some patches may need to be applied, depending on your system.
# Then, run <tt>'''./configure --with-debugging-output'''</tt><br/> Again, you may have to add some flags, depending on your system.
# Once you succeed in configuring bluefish, run: <tt>'''make clean'''</tt> in order to remove all unnecessary files.
# Then, run <tt>'''make'''</tt> to compile bluefish.<br/> Do not run make install since it strips the debugging symbols from the executable.
# Execute bluefish under gdb with: <tt>'''gdb src/bluefish'''</tt>. This way, you will get access to a non stripped version of bluefish, which is not the case if you run <tt>'''gdb bluefish'''</tt> or '''gdb /usr/local/bin/bluefish''', since those binaries do not have any debugging symbols anymore.
# Once '''gdb''' has started, type <tt>'''r'''</tt> to start the debugging session.
# Try to reproduce the crash in bluefish.
# Copy and paste the last 50 lines of debugging output to a text file.
# Type <tt>'''bt'''</tt> in gdb to get the backtrace, and copy it to the text file too. If the backtrace is huge, copy only the first 50 lines.
# Save the text file and gzip it by running gzip textfile in a terminal.
# Quit gdb with <tt>'''q'''</tt>
# Fill in the bug report (see [[Man 2 ch10s02|Section 2, “Filling a bug report”]] for instructions).


{{Man2bottom
|prev=Man 2 pt03
|up=Man 2 pt03
|next=Man 2 ch10s02
|prevname= Part&nbsp;3.&nbsp;Developing Bluefish
|nextname=2.&nbsp;Filling a bug report
}}