Added documentation to clarify that term canonicalization is not the same as Graph/Dataset canonicalization, which is impleented in the rdf-normalize gem.

Author: gkellogg

lib/rdf/cli.rb

@@ -60,7 +60,7 @@ module RDF
   #         RDF::CLI::Option.new(
   #           symbol: :canonicalize,
   #           on: ["--canonicalize"],
-  #           description: "Canonicalize input/output.") {true},
+  #           description: "Canonicalize URI/literal forms.") {true},
   #         RDF::CLI::Option.new(
   #           symbol: :uri,
   #           on: ["--uri STRING"],

lib/rdf/model/statement.rb

@@ -411,7 +411,7 @@ def terms
     end
 
     ##
-    # Canonicalizes each unfrozen term in the statement
+    # Canonicalizes each unfrozen term in the statement.
     #
     # @return [RDF::Statement] `self`
     # @since  1.0.8

lib/rdf/reader.rb

@@ -133,7 +133,7 @@ def self.options
           on: ["--canonicalize"],
           control: :checkbox,
           default: false,
-          description: "Canonicalize input/output.") {true},
+          description: "Canonicalize URI/literal forms") {true},
         RDF::CLI::Option.new(
           symbol: :encoding,
           datatype: Encoding,
@@ -271,7 +271,7 @@ def to_sym
     #   the base URI to use when resolving relative URIs (not supported by
     #   all readers)
     # @param [Boolean]  canonicalize (false)
-    #   whether to canonicalize parsed literals
+    #   whether to canonicalize parsed URIs and Literals.
     # @param [Encoding] encoding     (Encoding::UTF_8)
     #   the encoding of the input stream
     # @param [Boolean]  intern       (true)
@@ -608,7 +608,9 @@ def validate?
     end
 
     ##
-    # Returns `true` if parsed values should be canonicalized.
+    # Returns `true` if parsed values should be in canonical form.
+    #
+    # @note This is for term canonicalization, for graph/dataset canonicalization use `RDF::Normalize`.
     #
     # @return [Boolean] `true` or `false`
     # @since  0.3.0

lib/rdf/writer.rb

@@ -392,7 +392,9 @@ def validate?
     end
 
     ##
-    # Returns `true` if terms should be canonicalized.
+    # Returns `true` if terms should be in canonical form.
+    #
+    # @note This is for term canonicalization, for graph/dataset canonicalization use `RDF::Normalize`.
     #
     # @return [Boolean] `true` or `false`
     # @since  1.0.8