om 1.0.0 → 1.0.1

data/Gemfile

@@ -0,0 +1,11 @@
+source "http://rubygems.org"
+
+gem 'nokogiri'
+gem 'facets'
+
+group :development, :test do
+  gem "jeweler"
+  gem "rspec", "<2.0.0"
+  gem "mocha", ">= 0.9.8"
+  gem "ruby-debug"
+end

data/Gemfile.lock

@@ -0,0 +1,32 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    columnize (0.3.2)
+    facets (2.9.0)
+    git (1.2.5)
+    jeweler (1.5.1)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    linecache (0.43)
+    mocha (0.9.10)
+      rake
+    nokogiri (1.4.4)
+    rake (0.8.7)
+    rspec (1.3.1)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  facets
+  jeweler
+  mocha (>= 0.9.8)
+  nokogiri
+  rspec (< 2.0.0)
+  ruby-debug

data/History.textile

@@ -1,3 +1,11 @@
+1.0.1
+
+HYDRA-329: Allow for NamedTermProxies at root of Terminology
+
+1.0.0
+
+Stable release 
+
 0.1.10
 
 Improving generation of constrained xpath queries

data/Rakefile

@@ -37,7 +37,7 @@ Spec::Rake::SpecTask.new(:rcov) do |spec|
   spec.rcov = true
 end
 
-task :spec => :check_dependencies
+# task :spec => :check_dependencies
 
 task :default => :spec
 

data/VERSION

@@ -1 +1 @@
-1.0.0
+1.0.1

data/lib/om/xml/named_term_proxy.rb

@@ -1,20 +1,32 @@
 class OM::XML::NamedTermProxy
   
-  attr_accessor :proxy_pointer, :name
+  attr_accessor :proxy_pointer, :name, :terminology
   
   include OM::TreeNode
   
-  def initialize(name, proxy_pointer, opts={})
+  # Creates a Named Proxy that points to another term in the Terminology.
+  # Unlike regular terms, NamedTermProxy requires you to provide a reference to the containing Terminology.
+  # This is to ensure that it will always be able to look up the term that it's referencing.
+  # @param [Symbol] name of the proxy term
+  # @param [Array] proxy_pointer that points to the Term we're proxying
+  # @param [OM::XML::Terminology] terminology that this Term is being built for
+  # @param [Hash] opts additional Term options
+  def initialize(name, proxy_pointer, terminology, opts={})
     opts = {:namespace_prefix=>"oxns", :ancestors=>[], :children=>{}}.merge(opts)
     [:children, :ancestors].each do |accessor_name|
       instance_variable_set("@#{accessor_name}", opts.fetch(accessor_name, nil) )     
     end
+    @terminology = terminology
     @name = name
     @proxy_pointer = proxy_pointer
   end
   
   def proxied_term
-    self.parent.retrieve_term(*self.proxy_pointer)
+    if self.parent.nil?
+      self.terminology.retrieve_term(*self.proxy_pointer)
+    else
+      self.parent.retrieve_term(*self.proxy_pointer)
+    end
   end
   
   # do nothing -- this is to prevent errors when the parent term calls generate_xpath_queries! on its children
@@ -22,6 +34,12 @@ class OM::XML::NamedTermProxy
     # do nothing
   end
   
+  # A proxy term can never serve as the root term of a Terminology.
+  # Explicitly setting is_root_term? to return false to support proxies that are _at_ the root of the Terminology but aren't _the_ root term.
+  def is_root_term?
+    return false
+  end
+  
   def method_missing
   end
   

data/lib/om/xml/term.rb

@@ -35,7 +35,7 @@ class OM::XML::Term
         end
         
         # Fail on circular references and return an intelligible error message
-        if nodes_visited.contains?(target)
+        if nodes_visited.include?(target)
           nodes_visited << self
           nodes_visited << target
           trail = ""
@@ -87,10 +87,11 @@ class OM::XML::Term
     # Builds a new OM::XML::Term based on the Builder object's current settings
     # If no path has been provided, uses the Builder object's name as the term's path
     # Recursively builds any children, appending the results as children of the Term that's being built.
-    def build
+    # @param [OM::XML::Terminology] terminology that this Term is being built for
+    def build(terminology=nil)
       self.resolve_refs!
       if term.self.settings.has_key?(:proxy)
-        term = OM::XML::NamedTermProxy.new(self.name, self.settings[:proxy])
+        term = OM::XML::NamedTermProxy.new(self.name, self.settings[:proxy], terminology, self.settings)
       else
         term = OM::XML::Term.new(self.name)
       
@@ -100,7 +101,7 @@ class OM::XML::Term
           end
         end
         @children.each_value do |child|
-          term.add_child child.build
+          term.add_child child.build(terminology)
         end
         term.generate_xpath_queries!
       end

data/lib/om/xml/term_xpath_generator.rb

@@ -136,7 +136,7 @@ module OM::XML::TermXpathGenerator
       # If we've encountered a NamedTermProxy, insert path sections corresponding to 
       # terms corresponding to each entry in its proxy_pointer rather than just the final term that it points to.
       if term.kind_of? OM::XML::NamedTermProxy
-        current_location = term.parent
+        current_location = term.parent.nil? ? term.terminology : term.parent
         relative_path = ""
         term.proxy_pointer.each_with_index do |proxy_pointer, proxy_pointer_index|
           proxy_term = current_location.retrieve_term(proxy_pointer)

data/lib/om/xml/terminology.rb

@@ -90,7 +90,7 @@ class OM::XML::Terminology
         root_term_builder.children.delete(root_term_builder.name)
       end 
       @term_builders.each_value do |root_builder|
-        terminology.add_term root_builder.build
+        terminology.add_term root_builder.build(terminology)
       end
       terminology
     end
@@ -140,6 +140,7 @@ class OM::XML::Terminology
   
   # Return the appropriate xpath query for retrieving nodes corresponding to the term identified by +pointers+.
   # If the last argument is a String or a Hash, it will be used to add +constraints+ to the resulting xpath query.
+  # If you provide an xpath query as the argument, it will be returne untouched.
   def xpath_for(*pointers)
     if pointers.length == 1 && pointers.first.instance_of?(String)
       xpath_query = pointers.first

data/om.gemspec

@@ -1,103 +1,103 @@
 # Generated by jeweler
 # DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
   s.name = %q{om}
-  s.version = "1.0.0"
+  s.version = "1.0.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Matt Zumwalt"]
-  s.date = %q{2010-09-15}
+  s.date = %q{2010-12-06}
   s.description = %q{OM (Opinionated Metadata): A library to help you tame sprawling XML schemas like MODS.  Wraps Nokogiri documents in objects with miscellaneous helper methods for doing things like retrieve generated xpath queries or look up properties based on a simplified DSL}
   s.email = %q{matt.zumwalt@yourmediashelf.com}
   s.extra_rdoc_files = [
     "LICENSE",
-     "README.rdoc",
-     "README.textile"
+    "README.rdoc",
+    "README.textile"
   ]
   s.files = [
     ".document",
-     ".gitignore",
-     "History.textile",
-     "LICENSE",
-     "README.rdoc",
-     "README.textile",
-     "Rakefile",
-     "VERSION",
-     "container_spec.rb",
-     "lib/om.rb",
-     "lib/om/samples.rb",
-     "lib/om/samples/mods_article.rb",
-     "lib/om/tree_node.rb",
-     "lib/om/xml.rb",
-     "lib/om/xml/accessors.rb",
-     "lib/om/xml/container.rb",
-     "lib/om/xml/document.rb",
-     "lib/om/xml/generator.rb",
-     "lib/om/xml/named_term_proxy.rb",
-     "lib/om/xml/node_generator.rb",
-     "lib/om/xml/properties.rb",
-     "lib/om/xml/property_value_operators.rb",
-     "lib/om/xml/term.rb",
-     "lib/om/xml/term_value_operators.rb",
-     "lib/om/xml/term_xpath_generator.rb",
-     "lib/om/xml/terminology.rb",
-     "lib/om/xml/validation.rb",
-     "lib/om/xml/vocabulary.rb",
-     "om.gemspec",
-     "spec/fixtures/CBF_MODS/ARS0025_016.xml",
-     "spec/fixtures/RUBRIC_mods_article_template.xml",
-     "spec/fixtures/mods-3-2.xsd",
-     "spec/fixtures/mods_articles/hydrangea_article1.xml",
-     "spec/fixtures/test_dummy_mods.xml",
-     "spec/integration/rights_metadata_integration_example_spec.rb",
-     "spec/spec.opts",
-     "spec/spec_helper.rb",
-     "spec/unit/accessors_spec.rb",
-     "spec/unit/container_spec.rb",
-     "spec/unit/document_spec.rb",
-     "spec/unit/generator_spec.rb",
-     "spec/unit/named_term_proxy_spec.rb",
-     "spec/unit/node_generator_spec.rb",
-     "spec/unit/om_spec.rb",
-     "spec/unit/properties_spec.rb",
-     "spec/unit/property_value_operators_spec.rb",
-     "spec/unit/term_builder_spec.rb",
-     "spec/unit/term_spec.rb",
-     "spec/unit/term_value_operators_spec.rb",
-     "spec/unit/term_xpath_generator_spec.rb",
-     "spec/unit/terminology_builder_spec.rb",
-     "spec/unit/terminology_spec.rb",
-     "spec/unit/validation_spec.rb",
-     "spec/unit/xml_spec.rb"
+    "Gemfile",
+    "Gemfile.lock",
+    "History.textile",
+    "LICENSE",
+    "README.rdoc",
+    "README.textile",
+    "Rakefile",
+    "VERSION",
+    "container_spec.rb",
+    "lib/om.rb",
+    "lib/om/samples.rb",
+    "lib/om/samples/mods_article.rb",
+    "lib/om/tree_node.rb",
+    "lib/om/xml.rb",
+    "lib/om/xml/accessors.rb",
+    "lib/om/xml/container.rb",
+    "lib/om/xml/document.rb",
+    "lib/om/xml/generator.rb",
+    "lib/om/xml/named_term_proxy.rb",
+    "lib/om/xml/node_generator.rb",
+    "lib/om/xml/properties.rb",
+    "lib/om/xml/property_value_operators.rb",
+    "lib/om/xml/term.rb",
+    "lib/om/xml/term_value_operators.rb",
+    "lib/om/xml/term_xpath_generator.rb",
+    "lib/om/xml/terminology.rb",
+    "lib/om/xml/validation.rb",
+    "lib/om/xml/vocabulary.rb",
+    "om.gemspec",
+    "spec/fixtures/CBF_MODS/ARS0025_016.xml",
+    "spec/fixtures/RUBRIC_mods_article_template.xml",
+    "spec/fixtures/mods-3-2.xsd",
+    "spec/fixtures/mods_articles/hydrangea_article1.xml",
+    "spec/fixtures/test_dummy_mods.xml",
+    "spec/integration/rights_metadata_integration_example_spec.rb",
+    "spec/spec.opts",
+    "spec/spec_helper.rb",
+    "spec/unit/accessors_spec.rb",
+    "spec/unit/container_spec.rb",
+    "spec/unit/document_spec.rb",
+    "spec/unit/generator_spec.rb",
+    "spec/unit/named_term_proxy_spec.rb",
+    "spec/unit/node_generator_spec.rb",
+    "spec/unit/om_spec.rb",
+    "spec/unit/properties_spec.rb",
+    "spec/unit/property_value_operators_spec.rb",
+    "spec/unit/term_builder_spec.rb",
+    "spec/unit/term_spec.rb",
+    "spec/unit/term_value_operators_spec.rb",
+    "spec/unit/term_xpath_generator_spec.rb",
+    "spec/unit/terminology_builder_spec.rb",
+    "spec/unit/terminology_spec.rb",
+    "spec/unit/validation_spec.rb",
+    "spec/unit/xml_spec.rb"
   ]
   s.homepage = %q{http://github.com/mediashelf/om}
-  s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
   s.rubygems_version = %q{1.3.7}
   s.summary = %q{OM (Opinionated Metadata): A library to help you tame sprawling XML schemas like MODS.}
   s.test_files = [
     "spec/integration/rights_metadata_integration_example_spec.rb",
-     "spec/spec_helper.rb",
-     "spec/unit/accessors_spec.rb",
-     "spec/unit/container_spec.rb",
-     "spec/unit/document_spec.rb",
-     "spec/unit/generator_spec.rb",
-     "spec/unit/named_term_proxy_spec.rb",
-     "spec/unit/node_generator_spec.rb",
-     "spec/unit/om_spec.rb",
-     "spec/unit/properties_spec.rb",
-     "spec/unit/property_value_operators_spec.rb",
-     "spec/unit/term_builder_spec.rb",
-     "spec/unit/term_spec.rb",
-     "spec/unit/term_value_operators_spec.rb",
-     "spec/unit/term_xpath_generator_spec.rb",
-     "spec/unit/terminology_builder_spec.rb",
-     "spec/unit/terminology_spec.rb",
-     "spec/unit/validation_spec.rb",
-     "spec/unit/xml_spec.rb"
+    "spec/spec_helper.rb",
+    "spec/unit/accessors_spec.rb",
+    "spec/unit/container_spec.rb",
+    "spec/unit/document_spec.rb",
+    "spec/unit/generator_spec.rb",
+    "spec/unit/named_term_proxy_spec.rb",
+    "spec/unit/node_generator_spec.rb",
+    "spec/unit/om_spec.rb",
+    "spec/unit/properties_spec.rb",
+    "spec/unit/property_value_operators_spec.rb",
+    "spec/unit/term_builder_spec.rb",
+    "spec/unit/term_spec.rb",
+    "spec/unit/term_value_operators_spec.rb",
+    "spec/unit/term_xpath_generator_spec.rb",
+    "spec/unit/terminology_builder_spec.rb",
+    "spec/unit/terminology_spec.rb",
+    "spec/unit/validation_spec.rb",
+    "spec/unit/xml_spec.rb"
   ]
 
   if s.respond_to? :specification_version then
@@ -105,12 +105,24 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<nokogiri>, [">= 0"])
+      s.add_runtime_dependency(%q<facets>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["< 2.0.0"])
+      s.add_development_dependency(%q<mocha>, [">= 0.9.8"])
+      s.add_development_dependency(%q<ruby-debug>, [">= 0"])
       s.add_runtime_dependency(%q<nokogiri>, [">= 1.4.2"])
       s.add_runtime_dependency(%q<facets>, [">= 0"])
       s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
       s.add_development_dependency(%q<mocha>, [">= 0.9.8"])
       s.add_development_dependency(%q<ruby-debug>, [">= 0"])
     else
+      s.add_dependency(%q<nokogiri>, [">= 0"])
+      s.add_dependency(%q<facets>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["< 2.0.0"])
+      s.add_dependency(%q<mocha>, [">= 0.9.8"])
+      s.add_dependency(%q<ruby-debug>, [">= 0"])
       s.add_dependency(%q<nokogiri>, [">= 1.4.2"])
       s.add_dependency(%q<facets>, [">= 0"])
       s.add_dependency(%q<rspec>, [">= 1.2.9"])
@@ -118,6 +130,12 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<ruby-debug>, [">= 0"])
     end
   else
+    s.add_dependency(%q<nokogiri>, [">= 0"])
+    s.add_dependency(%q<facets>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["< 2.0.0"])
+    s.add_dependency(%q<mocha>, [">= 0.9.8"])
+    s.add_dependency(%q<ruby-debug>, [">= 0"])
     s.add_dependency(%q<nokogiri>, [">= 1.4.2"])
     s.add_dependency(%q<facets>, [">= 0"])
     s.add_dependency(%q<rspec>, [">= 1.2.9"])

data/spec/unit/terminology_builder_spec.rb

@@ -65,6 +65,22 @@ describe "OM::XML::Terminology::Builder" do
       
     end
     
+    it "supports proxy terms at the root of the Terminology" do 
+      t_builder = OM::XML::Terminology::Builder.new do |t| 
+        t.root(:path=>"mods", :xmlns=>"http://www.loc.gov/mods/v3", :schema=>"http://www.loc.gov/standards/mods/v3/mods-3-2.xsd") 
+        t.title_info(:path=>"titleInfo") { 
+          t.main_title(:path=>"title", :label=>"title") 
+          t.language(:path=>{:attribute=>"lang"}) 
+        } 
+        t.title(:proxy=>[:title_info, :main_title]) 
+      end 
+
+      terminology = t_builder.build 
+      terminology.retrieve_term(:title).should be_kind_of OM::XML::NamedTermProxy
+      terminology.xpath_for(:title).should == '//oxns:titleInfo/oxns:title'
+      terminology.xpath_with_indexes({:title=>0}).should == "//oxns:titleInfo/oxns:title"
+    end
+    
     describe '#new' do
       it "should return an instance of OM::XML::Terminology::Builder" do
         OM::XML::Terminology::Builder.new.should be_instance_of OM::XML::Terminology::Builder

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: om
 version: !ruby/object:Gem::Version 
-  hash: 23
+  hash: 21
   prerelease: false
   segments: 
   - 1
   - 0
-  - 0
-  version: 1.0.0
+  - 1
+  version: 1.0.1
 platform: ruby
 authors: 
 - Matt Zumwalt
@@ -15,13 +15,102 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-15 00:00:00 -05:00
+date: 2010-12-06 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
   name: nokogiri
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  type: :runtime
   prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  name: facets
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: jeweler
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: rspec
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - <
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 0
+        - 0
+        version: 2.0.0
+  requirement: *id004
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: mocha
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 43
+        segments: 
+        - 0
+        - 9
+        - 8
+        version: 0.9.8
+  requirement: *id005
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: ruby-debug
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id006
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
+  name: nokogiri
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -32,12 +121,12 @@ dependencies:
         - 4
         - 2
         version: 1.4.2
-  type: :runtime
-  version_requirements: *id001
+  requirement: *id007
 - !ruby/object:Gem::Dependency 
-  name: facets
+  type: :runtime
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  name: facets
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -46,12 +135,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  type: :runtime
-  version_requirements: *id002
+  requirement: *id008
 - !ruby/object:Gem::Dependency 
-  name: rspec
+  type: :development
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  name: rspec
+  version_requirements: &id009 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -62,12 +151,12 @@ dependencies:
         - 2
         - 9
         version: 1.2.9
-  type: :development
-  version_requirements: *id003
+  requirement: *id009
 - !ruby/object:Gem::Dependency 
-  name: mocha
+  type: :development
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  name: mocha
+  version_requirements: &id010 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -78,12 +167,12 @@ dependencies:
         - 9
         - 8
         version: 0.9.8
-  type: :development
-  version_requirements: *id004
+  requirement: *id010
 - !ruby/object:Gem::Dependency 
-  name: ruby-debug
+  type: :development
   prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  name: ruby-debug
+  version_requirements: &id011 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -92,8 +181,7 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  type: :development
-  version_requirements: *id005
+  requirement: *id011
 description: "OM (Opinionated Metadata): A library to help you tame sprawling XML schemas like MODS.  Wraps Nokogiri documents in objects with miscellaneous helper methods for doing things like retrieve generated xpath queries or look up properties based on a simplified DSL"
 email: matt.zumwalt@yourmediashelf.com
 executables: []
@@ -106,7 +194,8 @@ extra_rdoc_files:
 - README.textile
 files: 
 - .document
-- .gitignore
+- Gemfile
+- Gemfile.lock
 - History.textile
 - LICENSE
 - README.rdoc
@@ -164,8 +253,8 @@ homepage: http://github.com/mediashelf/om
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 

data/.gitignore

@@ -1,21 +0,0 @@
-## MAC OS
-.DS_Store
-
-## TEXTMATE
-*.tmproj
-tmtags
-
-## EMACS
-*~
-\#*
-.\#*
-
-## VIM
-*.swp
-
-## PROJECT::GENERAL
-coverage
-rdoc
-pkg
-
-## PROJECT::SPECIFIC