Added an rdoc task.

Small RDoc improvements.

.gitignore

@@ -1,2 +1,3 @@
+/doc/rdoc
 /pkg
 *~

Rakefile

@@ -2,6 +2,7 @@ require 'rake'
 require 'rake/gempackagetask'
 require 'fileutils'
 include FileUtils
+require 'rake/rdoctask'
 
 spec = Gem::Specification.new do |s|
     s.name = "ruby-dbus"
@@ -29,3 +30,10 @@ task :gemspec do
     f.write spec.to_ruby
   end
 end 
+
+Rake::RDocTask.new do |rd|
+  rd.rdoc_dir = 'doc/rdoc'
+  rd.rdoc_files.include("README", "lib/**/*.rb")
+#  rd.options << "--diagram"
+#  rd.options << "--all"
+end

lib/dbus/bus.rb

@@ -16,7 +16,7 @@
 #
 # Module containing all the D-Bus modules and classes.
 module DBus
-  # This represents a remote service. It should not be instancied directly
+  # This represents a remote service. It should not be instantiated directly
   # Use Bus::service()
   class Service
     # The service name.
@@ -48,7 +48,7 @@ def introspect
       self
     end
 
-    # Retrieves an object at the given _path_.
+    # Retrieves an object (ProxyObject) at the given _path_.
     def object(path)
       node = get_node(path, true)
       if node.object.nil?
@@ -543,7 +543,7 @@ def process(m)
       end
     end
 
-    # Retrieves the service with the given _name_.
+    # Retrieves the Service with the given _name_.
     def service(name)
       # The service might not exist at this time so we cannot really check
       # anything

lib/dbus/introspect.rb

@@ -309,7 +309,7 @@ def check_for_quoted_eval(s)
       raise RuntimeException, "invalid internal data" if not s.to_s =~ /^[^"]+$/
     end
 
-    # Defines a method on the interface from the descriptor _m_.
+    # Defines a method on the interface from the Method descriptor _m_.
     def define_method_from_descriptor(m)
       check_for_eval(m.name)
       check_for_quoted_eval(@name)