From dae6210c30e21b315eca3ee6f67b7425107848cf Mon Sep 17 00:00:00 2001 From: rocky Date: Mon, 1 Apr 2013 08:38:55 -0400 Subject: [PATCH] realgud.el, autogen.el: More things to make dbgr->realgud renmaming work. README.textile->README.md: revise. --- README.md | 31 +++++++++++++++++++++++ README.textile | 26 ------------------- autogen.sh | 2 +- realgud.el | 68 +++++++++++++++++++++++++++++++++++++++++++++++--- 4 files changed, 97 insertions(+), 30 deletions(-) create mode 100644 README.md delete mode 100644 README.textile diff --git a/README.md b/README.md new file mode 100644 index 00000000..093d2281 --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +A modular GNU Emacs front-end for interacting with external debuggers. + +Debuggers we currently support are: + +|NAME | INVOCATION | WHAT | +---------------------------------------------------------------------------------------------------------------- +|[bashdb](http://bashdb.sf.net) | `bashdb` | *bash* | +|[Devel::Trepan](https://github.com/rocky/Perl-Devel-Trepan/wiki) | trepan.pl | Perl5 | +|gdb | `realgud-gdb` | *gdb* | +|[kshdb](https://github.com/rocky/kshdb/wiki) | `kshdb` | Korn Shell 93 | +|perldb (Perl) | `perldb` | stock Perl5 debugger | +|pdb | `pdb` | Stock C Python debugger | +|[pydb](http://bashdb.sourceforge.net/pydb/) | `pydb` | slighly enhanced *pdb* for Python 2.x | +| [pydbgr](http://code.google.com/p/pydbgr/) | `pydbgr` | trepanning debugger for Python 2.x | +|[trepanning](https://github.com/rocky/rb-trepanning/wiki)| `trepan` | trepanning debugger for a patched Ruby 1.9 | +|[rb8-trepanning](https://github.com/rocky/rb8-trepanning/wiki)|`trepan8`| MRI Ruby 1.8 and an unpatched YARV 1.9)| +|[rbx-trepanning](https://github.com/rocky/rbx-trepanning/wiki)|`trepanx`|trepanning debugger for Rubinius Ruby| +|[remake](http://bashdb.sf.net/remake) | `remake` |GNU Make| +|[ruby-debug](http://bashdb.sf.net/ruby-debug) | `rdebug` | Ruby | +|[zshdb](https://github.com/rocky/zshdb/wiki) | `zshdb` | Zsh | + +The debugger is run out of a *comint* process buffer, or you can use a +`M-x track-mode` inside an existing shell. + +To install you'll need a couple of other Emacs packages installed. See +[the installation instructions](http://wiki.github.com/rocky/emacs-dbgr/how-to-install) +for details. + +To get started using see the +[notes on using emacs-dbgr](http://wiki.github.com/rocky/emacs-dbgr/how-to-use) +. diff --git a/README.textile b/README.textile deleted file mode 100644 index 785a3c65..00000000 --- a/README.textile +++ /dev/null @@ -1,26 +0,0 @@ -h1. Introduction - -Towards a modular framework for interacting with external debuggers. - -Debuggers we currently support are: - - * "bashdb":http://bashdb.sf.net (BASH) - * gdb - * "kshdb":https://github.com/rocky/kshdb/wiki (Korn Shell) - * perldb (Perl) - * "Devel::Trepan":https://github.com/rocky/Perl-Devel-Trepan/wiki (Perl) - * pdb (Stock C Python debugger) - * "pydb":http://bashdb.sourceforge.net/pydb/ (Python) - * "pydbgr":http://code.google.com/p/pydbgr/ (Python) - * "trepanning":https://github.com/rocky/rb-trepanning/wiki (Ruby 1.9) - * "rb8-trepanning":https://github.com/rocky/rb8-trepanning/wiki (MRI Ruby 1.8 and an unpatched YARV 1.9) - * "rbx-trepanning":https://github.com/rocky/rbx-trepanning/wiki (for Rubinius) - * "remake":http://bashdb.sf.net/remake (GNU Make) - * ruby-debug (Ruby) - * "zshdb":https://github.com/rocky/zshdb/wiki (Zsh) - -The debugger is run out of a comint process buffer, or you can use a "track-mode" inside an existing shell. - -To install you'll need a couple of other Emacs packages installed. See "the installation instructions":http://wiki.github.com/rocky/emacs-dbgr/how-to-install for details. - -To get started using see the "notes on using emacs-dbgr":http://wiki.github.com/rocky/emacs-dbgr/how-to-use . diff --git a/autogen.sh b/autogen.sh index 613f66b2..8948b34a 100755 --- a/autogen.sh +++ b/autogen.sh @@ -1,5 +1,5 @@ #!/bin/sh -ln -fs README.textile README +ln -fs README.md README autoreconf -vi && \ autoconf && { echo "Running configure with --enable-maintainer-mode $@" diff --git a/realgud.el b/realgud.el index 9bc732bc..68f943ac 100644 --- a/realgud.el +++ b/realgud.el @@ -1,5 +1,65 @@ -;;; Copyright (C) 2010-2013 Rocky Bernstein -;;; Things related to loading and loading the dbgr package. +;;; realgud.el --- A modular front-end for interacting with external debuggers + +;; Author: Rocky Bernstein +;; Version: 0.1.0 +;; URL: http://github.com/rocky/emacs-loc-changes +;; Compatibility: GNU Emacs 24.x + +;; Copyright (C) 2013 Rocky Bernstein + +;; This program is free software: you can redistribute it and/or +;; modify it under the terms of the GNU General Public License as +;; published by the Free Software Foundation, either version 3 of the +;; License, or (at your option) any later version. + +;; This program is distributed in the hope that it will be useful, but +;; WITHOUT ANY WARRANTY; without even the implied warranty of +;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +;; General Public License for more details. + +;; You should have received a copy of the GNU General Public License +;; along with this program. If not, see +;; . + +;;; Commentary: + +;; A modular font-end for interacting with external debuggers. +;; +;; Debuggers we currently support are: + +;; NAME INVOCATION* WHAT +; ----------------------------------- +;; * bashdb bashdb bash +;; * Devel::Trepan trepan.pl Perl5 +;; * gdb realgud-gdb gdb +;; * kshdb kshdb Korn Shell 93u+ +;; * pdb pdb stock C Python debugger +;; * perldb perldb stock Perl5 debugger +;; * pydb pydb slighly enhanced pdb for Python 2.x +;; * pydbgr pydbgr trepanning debugger for Python 2.x +;; * rb8-trepanning trepan8 MRI Ruby 1.8 and an unpatched YARV 1.9 +;; * rbx-trepanning trepanx trepanning debugger for Rubinius Ruby +;; * remake remake GNU Make +;; * ruby-debug rdebug Ruby +;; * trepanning trepan trepanning debugger for a patched Ruby 1.9 +;; * trepan trepan3k trepanning debugger for Python 3.x +;; * zshdb zshdb Zsh + +;; *gdb invication requires the realgud- preface to disambiguate it +;; from the older, preexisting emacs command. The other invocations +;; also accept realgud- prefaces, e.g. realgud-bashdb or realgud-pdb. +;; Alas there is older obsolete Emacs code out there for bashdb, +;; kshdb, and rdebug. + +;; The debugger is run out of a comint process buffer, or you can use +;; a “track-mode” inside an existing shell. + +;; To install you’ll need a couple of other Emacs packages +;; installed. Should be available via Melpa. See the installation +;; instructions for details. + +;;; Code: + (require 'load-relative) (defgroup realgud nil @@ -17,9 +77,9 @@ "./realgud/debugger/gdb/gdb" "./realgud/debugger/kshdb/kshdb" "./realgud/debugger/pdb/pdb" + "./realgud/debugger/perldb/perldb" "./realgud/debugger/pydb/pydb" "./realgud/debugger/pydbgr/pydbgr" - "./realgud/debugger/perldb/perldb" "./realgud/debugger/rdebug/rdebug" "./realgud/debugger/remake/remake" "./realgud/debugger/trepan/trepan" @@ -93,3 +153,5 @@ development version and you already have this package loaded." (realgud-load-features) (provide-me) + +;;; realgud.el ends here