Add noDoc option to Vocabulary writer to eliminate the Yard documentation.

Author: gkellogg

lib/rdf/vocab/rdfs.rb

@@ -6,6 +6,7 @@ module RDF
   # @!parse
   #   # Vocabulary for <http://www.w3.org/2000/01/rdf-schema#>
   #   #
+  #   # The RDF Schema vocabulary (RDFS)
   #   class RDFS < RDF::StrictVocabulary
   #     # The class of classes.
   #     # @return [RDF::Vocabulary::Term]

lib/rdf/vocab/writer.rb

@@ -65,31 +65,37 @@ def self.options
             on: ["--class-name NAME"],
             use: :required,
             description: "Name of created Ruby class (vocabulary format)."),
+          RDF::CLI::Option.new(
+            symbol: :extra,
+            datatype: String,
+            control: :none,
+            on: ["--extra URIEncodedJSON"],
+            description: "URI Encoded JSON representation of extra data"
+          ) do |arg|
+            ::JSON.parse(::CGI.unescape(arg)).inject({}) do |m1, (term, defs)|
+              d1 = defs.inject({}) {|m, (k,v)| m.merge(k.to_sym => v)}
+              m1.merge(term.to_sym => d1)
+            end
+          end,
           RDF::CLI::Option.new(
             symbol: :module_name,
             datatype: String,
             control: :text,
             on: ["--module-name NAME"],
             description: "Name of Ruby module containing class-name (vocabulary format)."),
+          RDF::CLI::Option.new(
+            symbol: :noDoc,
+            datatype: TrueClass,
+            control: :checkbox,
+            on: ["--noDoc"],
+            description: "Do not output Yard documentation."),
           RDF::CLI::Option.new(
             symbol: :strict,
             datatype: TrueClass,
             control: :checkbox,
             on: ["--strict"],
             description: "Make strict vocabulary"
           ) {true},
-          RDF::CLI::Option.new(
-            symbol: :extra,
-            datatype: String,
-            control: :none,
-            on: ["--extra URIEncodedJSON"],
-            description: "URI Encoded JSON representation of extra data"
-          ) do |arg|
-            ::JSON.parse(::CGI.unescape(arg)).inject({}) do |m1, (term, defs)|
-              d1 = defs.inject({}) {|m, (k,v)| m.merge(k.to_sym => v)}
-              m1.merge(term.to_sym => d1)
-            end
-          end,
         ]
       end
 
@@ -144,14 +150,23 @@ def write_epilogue
           # This file generated automatically using rdf vocabulary format from #{source}
           require 'rdf'
           module #{module_name}
-            # @!parse
+          ).gsub(/^          /, '')
+
+          @output.print %(  # @!parse
             #   # Vocabulary for <#{base_uri}>
             #   #
-          ).gsub(/^          /, '')
+          ).gsub(/^          /, '') unless @options[:noDoc]
 
-        if vocab.ontology
+        if vocab.ontology && !@options[:noDoc]
           ont_doc = []
-          [:"dc:title", :"dc11:title", :label, :comment, :"dc:description", :"dc11:description"].each do |attr|
+          %i(
+            http://purl.org/dc/terms/title
+            http://purl.org/dc/elements/1.1/title
+            label
+            comment
+            http://purl.org/dc/terms/description
+            http://purl.org/dc/elements/1.1/description
+          ).each do |attr|
             next unless vocab.ontology.attributes[attr]
             Array(vocab.ontology.attributes[attr]).each do |v|
               ont_doc << "  #   # " + v.to_s.gsub(/\n/, ' ')
@@ -167,7 +182,7 @@ module #{module_name}
             @output.puts "  #   # @see #{see}"
           end
         end
-        @output.puts %(  #   class #{class_name} < RDF::#{"Strict" if strict}Vocabulary)
+        @output.puts %(  #   class #{class_name} < RDF::#{"Strict" if strict}Vocabulary) unless @options[:noDoc]
 
         # Split nodes into Class/Property/Datatype/Other
         term_nodes = {
@@ -213,10 +228,10 @@ module #{module_name}
             @output.puts "  #     attr_reader :#{name}"
             @output.puts "  #"
           end
-        end
+        end unless @options[:noDoc]
 
         # End of yard preamble
-        @output.puts "  #   end"
+        @output.puts "  #   end" unless @options[:noDoc]
         @output.puts %(  #{class_name} = Class.new(RDF::#{"Strict" if strict}Vocabulary("#{base_uri}")) do)
 
         # Output term definitions