debugger 1.1.3 → 1.1.4

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 1.1.4
+* Bump ruby_core_source dependency
+
 ## 1.1.3
 * Bump dependencies
 

data/README.md

@@ -14,10 +14,13 @@ For Windows install instructions, see OLD\_README.
 
 
 ## Supported Rubies
-On install, debugger tries to find your ruby's headers. If it's unable to find them and your ruby is a patch release,
-it will use headers included with [debugger-ruby_core_source](https://github.com/cldwalker/debugger-ruby_core_source).
-For the list of rubies supported by debugger [see here](https://github.com/cldwalker/debugger-ruby_core_source/tree/master/lib/debugger/ruby_core_source).
-*If your ruby is not a patch release i.e. head, dev or an rc, you are responsible for having headers and setting them with --with-ruby-include.*
+On install, debugger tries to find your ruby's headers. If it's unable to find them and your ruby is
+a patch release, it will use headers included with
+[debugger-ruby_core_source](https://github.com/cldwalker/debugger-ruby_core_source).  For the list
+of rubies supported by debugger [see
+here](https://github.com/cldwalker/debugger-ruby_core_source/tree/master/lib/debugger/ruby_core_source).
+*If your ruby is not an official patch release i.e. head, dev or an rc, you are responsible for
+having headers and setting them with --with-ruby-include.*
 
 ## Usage
 
@@ -31,6 +34,41 @@ To use with bundler, drop in your Gemfile:
 
     gem 'debugger'
 
+### Configuration
+
+At initialization time, debugger loads config files, executing their lines
+as if they were actual commands a user has typed. config files are loaded
+from two locations:
+
+* ~/.rdebugrc (~/rdebug.ini for windows)
+* $PWD/.rdebugrc ($PWD/rdebug.ini for windows)
+
+Here's a common configuration (yeah, I should make this the default):
+
+    set autolist
+    set autoeval
+    set autoreload
+
+To see debugger's current settings, use the `set` command.
+
+### Using Commands
+
+For a list of commands:
+
+    (rdb: 1) help
+
+Most commands are described in rdebug's man page
+
+    $ gem install gem-man
+    $ man rdebug
+
+### More documentation
+
+Some thorough documentation of debugger is found with [this bashdb
+tutorial](http://bashdb.sourceforge.net/ruby-debug.html). For emacs and debugger
+usage, see [another bashdb
+tutorial](http://bashdb.sourceforge.net/ruby-debug/rdebug-emacs.html)
+
 ## Reason for Fork
 
 * ruby-debug19 maintainer isn't maintaining:
@@ -64,17 +102,29 @@ To use with bundler, drop in your Gemfile:
 ## Issues
 Please report them [on github](http://github.com/cldwalker/debugger/issues).
 
+## Known Issues
+* If you place a debugger call at the end of a block, debugging will start at the next step and
+  outside of your block. A simple work-around is to place a meaningless step (i.e. puts "STAY")
+  at the end of your block and before debugger.
+
 ## Contributing
 [See here](http://tagaholic.me/contributing.html) for contribution policies.
 Let's keep this working for the ruby community!
 
+## Related projects
+
+* [debugger-pry](https://github.com/pry/debugger-pry) - using pry within debugger
+* [pry-debugger](https://github.com/nixme/pry-debugger) - using debugger within pry
+
 ## Credits
 
 * Thanks to the original authors: Kent Sibilev and Mark Moseley
-* Contributors: ericpromislow, jnimety, adammck
+* Contributors: ericpromislow, jnimety, adammck, hipe
 * Fork started on awesome @relevance fridays!
 
 ## TODO
 
 * Fix test/test-*.rb
+* Port some of bashdb's docs
+* Use ~/.debuggerrc and bin/debugger and gracefully deprecate rdebug*
 * Work with others willing to tackle jruby, rubinius or windows support

data/debugger.gemspec

@@ -20,7 +20,7 @@ handling, bindings for stack frames among other things.
   s.extensions << "ext/ruby_debug/extconf.rb"
   s.executables = ["rdebug"]
   s.add_dependency "columnize", ">= 0.3.1"
-  s.add_dependency "debugger-ruby_core_source", '~> 1.1.2'
+  s.add_dependency "debugger-ruby_core_source", '~> 1.1.3'
   s.add_dependency "debugger-linecache", '~> 1.1.1'
   s.add_development_dependency 'rake', '~> 0.9.2.2'
   s.add_development_dependency 'rake-compiler', '~> 0.8.0'

data/lib/debugger/version.rb

@@ -1,5 +1,5 @@
 module Debugger
   # TODO: remove version from C ext
   send :remove_const, :VERSION if const_defined? :VERSION
-  VERSION = '1.1.3'
+  VERSION = '1.1.4'
 end

data/man/rdebug.1

@@ -143,7 +143,7 @@ goes the other direction and is like the down command
 Display all or \fIcount\fR items of the program stack.
 .PP
 For full details on rdebug, see \c
-http://rubyforge.org/projects/ruby-debug/
+https://github.com/cldwalker/debugger
 .SH OPTIONS
 .PP
 .TP 10
@@ -235,7 +235,7 @@ Show invocation help and exit.
 .PD
 .SH "SEE ALSO"
 .Sp
-http://rubyforge.org/projects/ruby-debug/
+https://github.com/cldwalker/debugger
 .SH AUTHOR
 rdebug was written by Kent Siblev. This manual page was written by
 Rocky Bernstein <rocky@gnu.org>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: debugger
 version: !ruby/object:Gem::Version
-  version: 1.1.3
+  version: 1.1.4
   prerelease: 
 platform: ruby
 authors:
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-01 00:00:00.000000000 Z
+date: 2012-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: columnize
@@ -36,7 +36,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.1.2
+        version: 1.1.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -44,7 +44,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.1.2
+        version: 1.1.3
 - !ruby/object:Gem::Dependency
   name: debugger-linecache
   requirement: !ruby/object:Gem::Requirement
@@ -394,7 +394,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.6
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.21
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Fast Ruby debugger - base + cli