diff --git a/README b/README new file mode 100644 index 0000000..125187e --- /dev/null +++ b/README @@ -0,0 +1,33 @@ +gdb-gui + +This is gdb-gui, a GUI for gdb. This GUI differs from existing gdb +GUIs in a few ways: + +* It runs in-process. + +* It is written in Python. + +* It is intended to interoperate well with the CLI. + You can pick and choose which windows you want to see, and you can + still do whatever you like in the terminal. + +* It is totally incomplete. + + +To get started, install the prerequisites. You'll need a +Python-enabled gdb, PyGtk, and PyGktSourceView. (And maybe more -- if +you trip across something, let me know.) You'll need the Python +development package to compile the small C module that is included +here. + +On Fedora I think this suffices: + + sudo yum install gdb python-devel pygtksourceview pygtk2 + +After you install this, type "make". Now, start gdb and source the +"SourceMe.py" file. This sets everything up. + +This adds a new "gui" command to gdb. Currently the only subcommand +is "gui source", which pops up a source window. The source window +will automatically track your progress when debugging. You can make +multiple source windows; they will be reused in an LRU fashion.