realgud.el, autogen.el: More things to make dbgr->realgud renmaming w…

…ork. README.textile->README.md: revise.

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)
+.

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 $@"

realgud.el

@@ -1,5 +1,65 @@
-;;; Copyright (C) 2010-2013 Rocky Bernstein <rocky@gnu.org>
-;;; 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 <rocky@gnu.org>
+
+;; 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
+;; <http://www.gnu.org/licenses/>.
+
+;;; 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