lib/redlander.rb in redlander-0.3.6 vs lib/redlander.rb in redlander-0.4.0

@@ -7,29 +7,31 @@
 require 'redlander/uri'
 require 'redlander/node'
 require 'redlander/model'
 require 'redlander/statement'
 
+# Main Redlander namespace
 module Redlander
-
   class << self
+    # @api private
     def rdf_world
       unless @rdf_world
         @rdf_world = Redland.librdf_new_world
-        raise RedlandError.new("Could not create a new RDF world") if @rdf_world.null?
+        raise RedlandError, "Could not create a new RDF world" if @rdf_world.null?
         ObjectSpace.define_finalizer(self, proc { Redland.librdf_free_world(@rdf_world) })
         Redland.librdf_world_open(@rdf_world)
       end
       @rdf_world
     end
 
+    # @api private
     # Convert options hash into a string for librdf.
     # What it does:
     #   1) Convert boolean values into 'yes/no' values
     #   2) Change underscores in key names into dashes ('dhar_ma' => 'dhar-ma')
     #   3) Join all options as "key='value'" pairs in a comma-separated string
     #
-    # E.g.:
+    # @example
     #   to_rdf_options {:key => true, "key_board" => 3}
     #   # => "key='yes',key-board='3'"
     def to_rdf_options(options = {})
       options.inject([]){|opts, option_pair|
         key = option_pair[0].to_s.gsub(/_/, '-')