mods 0.0.2 → 0.0.4

data/spec/name_spec.rb

@@ -0,0 +1,257 @@
+require 'spec_helper'
+
+describe "Mods <name> Element" do
+  
+  before(:all) do
+    @mods_rec = Mods::Record.new
+    @corp_name = 'ABC corp'
+    @mods_w_corp_name = "<mods><name type='corporate'><namePart>#{@corp_name}</namePart></name></mods>"
+    @mods_w_corp_name_role = "<mods><name type='corporate'><namePart>#{@corp_name}</namePart>
+      <role><roleTerm type='text'>lithographer</roleTerm></role></name></mods>"
+    @pers_name = 'Crusty'
+    @mods_w_pers_name = "<mods><name type='personal'><namePart>#{@pers_name}</namePart></name></mods>"
+    @mods_w_both = "<mods>
+      <name type='corporate'><namePart>#{@corp_name}</namePart></name>
+      <name type='personal'><namePart>#{@pers_name}</namePart></name></mods>"
+    @pers_role = 'creator'
+    @mods_w_pers_name_role = "<mods><name type='personal'><namePart>#{@pers_name}</namePart>
+      <role><roleTerm authority='marcrelator' type='text'>#{@pers_role}</roleTerm><role></name></mods>"
+    @mods_w_pers_name_role_code = '<mods><name type="personal"><namePart type="given">John</namePart>
+        	<namePart type="family">Huston</namePart>
+        	<role>
+        	  	<roleTerm type="code" authority="marcrelator">drt</roleTerm>
+        	</role>
+      </name></mods>'
+  end
+  
+  context "personal name" do
+    
+    it "should recognize child elements" do
+      Mods::Name::SUBELEMENTS.reject{|e| e == "role"}.each { |e|
+        @mods_rec.from_str("<mods><name type='personal'><#{e}>oofda</#{e}></name></mods>")
+        if e == 'description'
+          @mods_rec.personal_name.description_el.text.should == 'oofda'
+        else
+          @mods_rec.personal_name.send(e).text.should == 'oofda'
+        end
+      }
+    end
+    it "should include name elements with type attr = personal" do
+      @mods_rec.from_str(@mods_w_pers_name)
+      @mods_rec.personal_name.namePart.text.should == @pers_name
+      @mods_rec.from_str(@mods_w_both).personal_name.namePart.text.should == @pers_name
+    end
+    it "should not include name elements with type attr != personal" do
+      @mods_rec.from_str(@mods_w_corp_name)
+      @mods_rec.personal_name.namePart.text.should == ""
+      @mods_rec.from_str(@mods_w_both).personal_name.namePart.text.should_not match(@corp_name)
+    end
+    
+    context "roles" do
+      it "should be possible to access a personal_name role easily" do
+        @mods_rec.from_str(@mods_w_pers_name_role)
+        @mods_rec.personal_name.role.text.should include(@pers_role)
+      end
+
+      it "should get role type" do
+        @mods_rec.from_str(@mods_w_pers_name_role)
+        @mods_rec.personal_name.role.type_at.should == ["text"]
+        @mods_rec.from_str(@mods_w_pers_name_role_code)
+        @mods_rec.personal_name.role.type_at.should == ["code"]
+      end
+      
+      it "should get role authority" do
+        @mods_rec.from_str(@mods_w_pers_name_role)
+        @mods_rec.personal_name.role.authority.should == ["marcrelator"]
+      end
+      
+    end
+    
+    context "Mods::Record.personal_names convenience method" do
+      before(:all) do
+        @given_family = '<mods><name type="personal"><namePart type="given">Jorge Luis</namePart>
+                                <namePart type="family">Borges</namePart></name></mods>'        
+        @given_family_date = '<mods><name type="personal"><namePart type="given">Zaphod</namePart>
+                                <namePart type="family">Beeblebrox</namePart>
+                                <namePart type="date">1912-2362</namePart></name></mods>'
+        @all_name_parts = '<mods><name type="personal"><namePart type="given">Given</namePart>
+                                <namePart type="family">Family</namePart>
+                                <namePart type="termsOfAddress">Mr.</namePart>
+                                <namePart type="date">date</namePart></name></mods>'
+        @family_only = '<mods><name type="personal"><namePart type="family">Family</namePart></name></mods>'
+        @given_only = '<mods><name type="personal"><namePart type="given">Given</namePart></name></mods>'
+      end
+
+      it "should return an Array of Strings" do
+        @mods_rec.from_str(@mods_w_pers_name)
+        @mods_rec.personal_names.should == [@pers_name]
+      end
+
+      it "should not include the role text" do
+        @mods_rec.from_str(@mods_w_pers_name_role)
+        @mods_rec.personal_names.first.should_not match(@pers_role)
+      end
+      
+      it "should prefer displayForm over namePart pieces" do
+        display_form_and_name_parts = '<mods><name type="personal"><namePart type="given">Jorge Luis</namePart>
+                                <namePart type="family">Borges</namePart>
+                                <displayForm>display form</displayForm></name></mods>'        
+        @mods_rec.from_str(display_form_and_name_parts)
+        @mods_rec.personal_names.should include("display form")
+      end
+
+      it "should put the family namePart first" do
+        @mods_rec.from_str(@given_family)
+        @mods_rec.personal_names.first.should match(/^Borges/)
+        @mods_rec.from_str(@given_family_date)
+        @mods_rec.personal_names.first.should match(/^Beeblebrox/)
+      end
+      it "should not include date" do
+        @mods_rec.from_str(@given_family_date)
+        @mods_rec.personal_names.first.should_not match(/19/)
+        @mods_rec.from_str(@all_name_parts)
+        @mods_rec.personal_names.first.should_not match('date')
+      end
+      it "should include a comma when there is both a family and a given name" do
+        @mods_rec.from_str(@all_name_parts)
+        @mods_rec.personal_names.should include("Family, Given")
+      end
+      it "should include multiple words in a namePart" do
+        @mods_rec.from_str(@given_family)
+        @mods_rec.personal_names.should include("Borges, Jorge Luis")
+      end
+      it "should not include a comma when there is only a family or given name" do
+        [@family_only, @given_only].each { |mods_str|  
+          @mods_rec.from_str(mods_str)
+          @mods_rec.personal_names.first.should_not match(/,/)
+        }
+      end
+      it "should not include terms of address" do
+        @mods_rec.from_str(@all_name_parts)
+        @mods_rec.personal_names.first.should_not match(/Mr./)
+      end      
+    end # personal_names convenience method
+  end # personal name
+  
+  context "sort_author" do
+    it "should do something" do
+      pending "sort_author to be implemented"
+    end
+  end
+  
+  context "corporate name" do
+    before(:all) do
+      @corp_role = 'lithographer'
+      @mods_w_corp_name_role = "<mods><name type='corporate'><namePart>#{@corp_name}</namePart>
+        <role><roleTerm type='text'>#{@corp_role}</roleTerm></role></name></mods>"
+      s = '<mods><name type="corporate"><namePart>Sherman &amp; Smith</namePart>
+           <role><roleTerm authority="marcrelator" type="text">creator</roleTerm></role></name></mods>'
+      @mult_corps = '<mods>     <name type="corporate">
+               <namePart>Henry Bill, New York</namePart>
+               <role><roleTerm type="text">publisher</roleTerm></role>
+             </name>
+             <name type="corporate">
+               <namePart>T. Sinclair&apos;s, Philadelphia</namePart>
+               <role><roleTerm type="text">lithographer</roleTerm></role>
+             </name>
+               <name type="corporate">
+               <namePart>Potter Collection</namePart>
+               <role><roleTerm type="text">former owner</roleTerm></role>
+             </name></mods>'
+    end
+    
+    it "should recognize child elements" do
+      Mods::Name::SUBELEMENTS.reject{|e| e == "role" }.each { |e|
+        @mods_rec.from_str("<mods><name type='corporate'><#{e}>oofda</#{e}></name></mods>")
+        if e == 'description'
+          @mods_rec.corporate_name.description_el.text.should == 'oofda'
+        else
+          @mods_rec.corporate_name.send(e).text.should == 'oofda'
+        end
+      }
+    end
+    it "should include name elements with type attr = corporate" do
+      @mods_rec.from_str(@mods_w_corp_name)
+      @mods_rec.corporate_name.namePart.text.should == @corp_name
+      @mods_rec.from_str(@mods_w_both).corporate_name.namePart.text.should == @corp_name
+    end
+    it "should not include name elements with type attr != corporate" do
+      @mods_rec.from_str(@mods_w_pers_name)
+      @mods_rec.corporate_name.namePart.text.should == ""
+      @mods_rec.from_str(@mods_w_both).corporate_name.namePart.text.should_not match(@pers_name)
+    end
+
+    context "Mods::Record.corporate_names convenience method" do
+      it "should return an Array of Strings" do
+        @mods_rec.from_str(@mods_w_corp_name)
+        @mods_rec.corporate_names.should == [@corp_name]
+      end
+
+      it "should not include the role text" do
+        @mods_rec.from_str(@mods_w_corp_name_role)      
+        @mods_rec.corporate_names.first.should_not match(@corp_role)
+      end
+      
+      it "should prefer displayForm over namePart pieces" do
+        display_form_and_name_parts = '<mods><name type="corporate"><namePart>Food, Inc.</namePart>
+                                <displayForm>display form</displayForm></name></mods>'        
+        @mods_rec.from_str(display_form_and_name_parts)
+        @mods_rec.corporate_names.should include("display form")
+      end
+    end # corporate_names convenience method
+  end # corporate name
+  
+  context "(plain) <name> element terminology pieces" do
+
+    it "should recognize child elements" do
+      Mods::Name::SUBELEMENTS.reject{|e| e == "role"}.each { |e|
+        @mods_rec.from_str("<mods><name><#{e}>oofda</#{e}></name></mods>")
+        if e == 'description'
+          @mods_rec.plain_name.description_el.text.should == 'oofda'
+        else
+          @mods_rec.plain_name.send(e).text.should == 'oofda'
+        end
+      }
+    end
+
+    it "should recognize attributes on name node" do
+      Mods::Name::ATTRIBUTES.each { |attrb| 
+        @mods_rec.from_str("<mods><name #{attrb}='hello'><displayForm>q</displayForm></name></mods>")
+        if attrb != 'type'
+          @mods_rec.plain_name.send(attrb).should == ['hello']
+        else
+          @mods_rec.plain_name.type_at.should == ['hello']
+        end
+      }
+    end
+    
+    context "namePart subelement" do
+      it "should recognize type attribute on namePart element" do
+        Mods::Name::NAME_PART_TYPES.each { |t|  
+          @mods_rec.from_str("<mods><name><namePart type='#{t}'>hi</namePart></name></mods>")
+          @mods_rec.plain_name.namePart.type_at.text.should == t
+        }
+      end
+    end
+    
+    context "role subelement" do
+      it "should get role type" do
+        @mods_rec.from_str(@mods_w_pers_name_role)
+        @mods_rec.plain_name.role.type_at.should == ["text"]
+        @mods_rec.from_str(@mods_w_pers_name_role_code)
+        @mods_rec.plain_name.role.type_at.should == ["code"]
+      end
+
+      it "should get role authority" do
+        @mods_rec.from_str(@mods_w_pers_name_role)
+        @mods_rec.plain_name.role.authority.should == ["marcrelator"]
+      end
+    end
+
+  end # plain name
+  
+  it "should be able to translate the marc relator code into text" do
+    MARC_RELATOR['drt'].should == "Director"
+  end
+  
+end

data/spec/origin_info_spec.rb

@@ -0,0 +1,311 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe "Mods <originInfo> Element" do
+  before(:all) do
+    @mods_rec = Mods::Record.new
+    @kolb = '<mods>
+    <originInfo>
+            <dateCreated>1537-1553.</dateCreated>
+            <dateCreated point="start">1537</dateCreated>
+            <dateCreated point="end">1553</dateCreated>
+        </originInfo></mods>'
+    @reid_dennis = '<mods><originInfo><dateIssued>1852</dateIssued></originInfo></mods>'
+    @walters = '<mods><originInfo>
+       <place>
+          <placeTerm type="text">Iran</placeTerm>
+       </place>
+       <dateIssued>22 Rabīʿ II 889 AH / 1484 CE</dateIssued>
+       <issuance>monographic</issuance>
+    </originInfo>
+    </mods>'
+    @simple = '<mods><originInfo><dateIssued>circa 1900</dateIssued></originInfo></mods>'
+    @ew = '<mods><originInfo>
+      <place>
+        <placeTerm type="text">Reichenau Abbey, Lake Constance, Germany</placeTerm>
+      </place>
+      <dateIssued>Middle of the 11th century CE</dateIssued>
+      <issuance>monographic</issuance>
+    </originInfo>
+    </mods>'
+    @e = '<mods><originInfo>
+              <place>
+                 <placeTerm type="code" authority="marccountry">au</placeTerm>
+              </place>
+              <place>
+                 <placeTerm type="text">[Austria?</placeTerm>
+              </place>
+              <dateIssued>circa 1180-1199]</dateIssued>
+              <issuance>monographic</issuance>
+           </originInfo></mods>'
+    @f = '<mods>       <originInfo>
+             <place>
+               <placeTerm authority="marccountry" type="code">cau</placeTerm>
+             </place>
+             <dateIssued encoding="marc" keyDate="yes" point="start">1850</dateIssued>
+             <dateIssued encoding="marc" point="end">1906</dateIssued>
+             <issuance>monographic</issuance>
+           </originInfo>
+    </mods>'
+    @ex = '<mods><originInfo>
+      <place>
+        <placeTerm>France and Italy</placeTerm>
+      </place>
+      <dateCreated keyDate="yes" qualifier="inferred">173-?</dateCreated>
+    </originInfo>
+    </mods>'
+    @ex1 = '<mods><originInfo>
+  	<publisher>Robot Publishing</publisher>
+      <place>
+        <placeTerm>France</placeTerm>
+      </place>
+      <place>
+        <placeTerm>Italy</placeTerm>
+      </place>
+      <dateCreated keyDate="yes" qualifier="inferred">173-?</dateCreated>
+  	<dateIssued>1850</dateIssued>
+    </originInfo>
+    </mods>'
+    @ex2 = '<mods><originInfo>
+        <place>
+           <placeTerm type="code" authority="marccountry">enk</placeTerm>
+        </place>
+        <place>
+           <placeTerm type="text">[London]</placeTerm>
+        </place>
+        <publisher>Bunney &amp; Gold</publisher>
+        <dateIssued>1799</dateIssued>
+        <dateIssued encoding="marc" keyDate="yes">1799</dateIssued>
+        <issuance>monographic</issuance>
+     </originInfo>
+    </mods>'
+    @ex3 = '<mods><originInfo>
+       <place>
+          <placeTerm type="code" authority="marccountry">xx</placeTerm>
+       </place>
+       <place>
+          <placeTerm type="text">[s.l. : s.n.]</placeTerm>
+       </place>
+       <dateIssued>1780?]</dateIssued>
+       <dateIssued encoding="marc" keyDate="yes">178u</dateIssued>
+       <issuance>monographic</issuance>
+    </originInfo>
+    </mods>'
+    @ex4 = '<mods><originInfo>
+       <place>
+          <placeTerm type="code" authority="marccountry">fr</placeTerm>
+       </place>
+       <place>
+          <placeTerm type="text">[S.l.]</placeTerm>
+       </place>
+       <publisher>[s.n.]</publisher>
+       <dateIssued>[1740.]</dateIssued>
+       <dateIssued encoding="marc" point="start" qualifier="questionable" keyDate="yes">1740</dateIssued>
+       <dateIssued encoding="marc" point="end" qualifier="questionable">1749</dateIssued>
+       <issuance>monographic</issuance>
+    </originInfo>
+    </mods>'
+    @ex5 = '<mods><originInfo>
+        <place>
+           <placeTerm type="code" authority="marccountry">xx</placeTerm>
+        </place>
+        <place>
+           <placeTerm type="text">[S.l.]</placeTerm>
+        </place>
+        <publisher>Olney</publisher>
+        <dateIssued>1844</dateIssued>
+        <dateIssued encoding="marc" keyDate="yes">1844</dateIssued>
+        <issuance>monographic</issuance>
+     </originInfo>
+    </mods>'
+    @ex6 = '<mods><originInfo>
+       <place>
+          <placeTerm type="code" authority="marccountry">enk</placeTerm>
+       </place>
+       <place>
+          <placeTerm type="text">[London</placeTerm>
+       </place>
+       <publisher>Printed for William Innys and Joseph Richardson ... [et al.]</publisher>
+       <dateIssued>1752]</dateIssued>
+       <dateIssued encoding="marc" keyDate="yes">1752</dateIssued>
+       <issuance>monographic</issuance>
+    </originInfo>
+    </mods>'
+    @ex7 = '<mods><originInfo>
+       <place>
+          <placeTerm authority="marccountry" type="code">fr</placeTerm>
+       </place>
+       <place>
+          <placeTerm type="text">[S.l.]</placeTerm>
+       </place>
+       <publisher>[s.n.]</publisher>
+       <dateIssued>[1740.]</dateIssued>
+       <dateIssued encoding="marc" keyDate="yes" point="start" qualifier="questionable">1740</dateIssued>
+       <dateIssued encoding="marc" point="end" qualifier="questionable">1749</dateIssued>
+       <issuance>monographic</issuance>
+    </originInfo>
+    </mods>'
+    
+    xml = '<originInfo>
+    <dateCreated encoding="w3cdtf" keyDate="yes" point="start" qualifier="approximate">250 B.C.</dateCreated>
+    <dateCreated encoding="w3cdtf" keyDate="yes" point="end" qualifier="approximate">150 B.C.</dateCreated>
+    </originInfo>'
+    
+  end
+
+  context "parsing date values" do
+    it "should cope with slop" do
+      pending "to be implemented"
+    end
+    
+  end
+
+  context "basic origin_info terminology pieces" do
+    before(:all) do
+      @mods_rec.from_str(@form_and_extent)
+    end
+
+    context "place child element" do
+      before(:all) do
+        @place_term_text = '<mods><originInfo><place><placeTerm type="text">Iran</placeTerm></place></originInfo></mods>'
+        @place_term_plain_mult = '<mods><originInfo>
+                      <place><placeTerm>France</placeTerm></place>
+                      <place><placeTerm>Italy</placeTerm></place></originInfo></mods>'
+        @place_term_code = '<mods><originInfo><place><placeTerm authority="marccountry" type="code">fr</placeTerm></place></originInfo></mods>'
+        @yuck1 = '<mods><originInfo><place><placeTerm type="text">[S.l.]</placeTerm></place></originInfo></mods>'
+        @yuck2 = '<mods><originInfo><place><placeTerm type="text">[London</placeTerm></place></originInfo></mods>'
+        @yuck3 = '<mods><originInfo><place><placeTerm type="text">[s.l. : s.n.]</placeTerm></place></originInfo></mods>'
+        @yuck4 = '<mods><originInfo><place><placeTerm type="text">[London]</placeTerm></place></originInfo></mods>'
+      end
+      context "placeTerm child element" do
+        it "should get element values" do
+          vals = @mods_rec.from_str(@place_term_plain_mult).origin_info.place.placeTerm.map { |e| e.text}
+          vals.size.should == 2
+          vals.should include("France")
+          vals.should include("Italy")
+        end
+        it "should get authority attribute" do
+          @mods_rec.from_str(@place_term_code).origin_info.place.placeTerm.authority.should == ["marccountry"]
+        end
+        it "should get type(_at) attribute" do
+          @mods_rec.from_str(@place_term_code).origin_info.place.placeTerm.type_at.should == ["code"]
+        end
+        it "should be able to translate marccountry codes" do
+          pending "to be implemented"
+        end
+        it "should ignore s.l. value (from MARC)" do
+          pending "to be implemented"
+        end
+        it "should be forgiving of square brackets (from MARC), matched or unmatched" do
+          pending "to be implemented"
+        end
+      end # placeTerm
+    end # place
+      
+    context "publisher child element" do
+      before(:all) do
+        @ex = '<mods><originInfo><publisher>Olney</publisher></origin_info></mods>'
+        @yuck1 = '<mods><originInfo><publisher>[s.n.]</publisher></originInfo></mods>'
+        @yuck2 = '<mods><originInfo><publisher>Printed for William Innys and Joseph Richardson ... [et al.]</publisher></originInfo></mods>'
+      end
+      it "should get element values" do
+        vals = @mods_rec.from_str('<mods><originInfo><publisher>Olney</publisher></origin_info></mods>').origin_info.publisher
+        vals.map { |n| n.text }.should == ["Olney"]
+      end
+      it "should ignore s.n. value (from MARC)" do
+        pending "to be implemented"
+      end
+      it "should leave square brackets alone, except for s.n." do
+        pending "to be implemented"
+      end
+    end
+    
+    context "various date child elements" do
+      it "should recognize each element" do
+        Mods::ORIGIN_INFO_DATE_ELEMENTS.each { |elname|
+          @mods_rec.from_str("<mods><originInfo><#{elname}>date</#{elname}></originInfo></mods>")
+          @mods_rec.origin_info.send(elname.to_sym).map { |n| n.text }.should == ["date"]
+        }
+      end
+      it "should recognize encoding attribute on each element" do
+        Mods::ORIGIN_INFO_DATE_ELEMENTS.each { |elname|
+          @mods_rec.from_str("<mods><originInfo><#{elname} encoding='foo'>date</#{elname}></originInfo></mods>")
+          @mods_rec.origin_info.send(elname.to_sym).encoding.should == ["foo"]
+        }
+      end
+      it "should recognize keyDate attribute" do
+        Mods::ORIGIN_INFO_DATE_ELEMENTS.each { |elname|
+          @mods_rec.from_str("<mods><originInfo><#{elname} keyDate='foo'>date</#{elname}></originInfo></mods>")
+          @mods_rec.origin_info.send(elname.to_sym).keyDate.should == ["foo"]
+        }
+      end
+      it "should recognize point attribute" do
+        # NOTE: values allowed are 'start' and 'end'
+        Mods::ORIGIN_INFO_DATE_ELEMENTS.each { |elname|
+          @mods_rec.from_str("<mods><originInfo><#{elname} point='foo'>date</#{elname}></originInfo></mods>")
+          @mods_rec.origin_info.send(elname.to_sym).point.should == ["foo"]
+        }
+      end
+      it "should recognize qualifier attribute" do
+        Mods::ORIGIN_INFO_DATE_ELEMENTS.each { |elname|
+          @mods_rec.from_str("<mods><originInfo><#{elname} qualifier='foo'>date</#{elname}></originInfo></mods>")
+          @mods_rec.origin_info.send(elname.to_sym).qualifier.should == ["foo"]
+        }
+      end
+      it "should recognize type attribute only on dateOther" do
+        Mods::ORIGIN_INFO_DATE_ELEMENTS.each { |elname|
+          @mods_rec.from_str("<mods><originInfo><#{elname} type='foo'>date</#{elname}></originInfo></mods>")
+          if elname == 'dateOther'
+            @mods_rec.origin_info.send(elname.to_sym).type_at.should == ["foo"]
+          else
+            expect { @mods_rec.origin_info.send(elname.to_sym).type_at}.to raise_exception(NoMethodError, /type_at/)
+          end
+        }
+      end
+      it "should know something about various date encodings: w3cdtf, iso8601, marc, edtf, temper" do
+        pending "to be implemented"
+      end
+      it "should know the only valid values for point attribute are 'start' and 'end'" do
+        pending "to be implemented"
+      end
+      it "should know the only valid value for keyDate attribute is 'yes" do
+        pending "to be implemented"
+      end
+      it "should know the only valid values for qualifier attribute: approximate, inferred, questionable" do
+        pending "to be implemented"
+      end
+    end
+    
+    it "edition child element" do
+      xml = '<mods><originInfo><edition>7th ed.</edition></originInfo></mods>'
+      @mods_rec.from_str(xml).origin_info.edition.map { |n| n.text }.should == ['7th ed.']
+    end
+    
+    context "issuance child element" do
+      before(:all) do
+        @ex = '<mods><originInfo><issuance>monographic</issuance></originInfo></mods>'
+      end
+      it "should get element value" do
+        @mods_rec.from_str(@ex).origin_info.issuance.map { |n| n.text }.should == ['monographic']
+      end
+      it "should know the only valid values are: continuing, monographic, single unit, multipart monograph, serial, integrating resource" do
+        pending "to be implemented"
+      end
+    end
+    
+    context "frequency child element" do
+      before(:all) do
+        xml = '<mods><originInfo><frequency authority="marcfrequency">Annual</frequency></originInfo></mods>'
+        @origin_info = @mods_rec.from_str(xml).origin_info
+      end
+      it "should get element value" do
+        @origin_info.frequency.map { |n| n.text }.should == ["Annual"]
+      end
+      it "should recognize the authority attribute" do
+        @origin_info.frequency.authority.should == ["marcfrequency"]
+      end
+    end
+  end # basic terminology
+
+
+end