bibtex-ruby 2.0.1 → 2.0.2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    bibtex-ruby (2.0.0)
+    bibtex-ruby (2.0.1)
       latex-decode (>= 0.0.6)
       multi_json (~> 1.0)
 
@@ -27,7 +27,7 @@ GEM
     gnuplot (2.3.6)
     json (1.5.4)
     json (1.5.4-java)
-    latex-decode (0.0.6)
+    latex-decode (0.0.9)
       unicode (~> 0.4)
     linecache (0.46)
       rbx-require-relative (> 0.0.4)

data/History.txt

@@ -1,3 +1,8 @@
+2.0.2 / 2011-11-25
+==================
+
+* Fixed (#33): error in Entry#respond_to? (kudos to @houshuang)
+
 2.0.1 / 2011-10-20
 ==================
 

data/lib/bibtex.rb

@@ -16,22 +16,20 @@
 # along with this program.	If not, see <http://www.gnu.org/licenses/>.
 #++
 
-$:.unshift(File.dirname(__FILE__)) unless
-  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
-
 require 'digest/md5'
-
-require 'bibtex/version'
+require 'forwardable'
 require 'logger'
+require 'open-uri'
 
 require 'multi_json'
 
+require 'bibtex/version'
+
 # = BibTeX
 #
 # This module encompasses a parser for BibTeX files and
-# auxiliary classes to model the individual
-# BibTeX objects: +String+, +Preamble+, +Comment+, and
-# +Entry+.
+# an API to the individual BibTeX objects: +String+,
+# +Preamble+, +Comment+, and +Entry+.
 #
 # Author:: {Sylvester Keil}[http://sylvester.keil.or.at]
 # Copyright:: Copyright (c) 2010-2011 Sylvester Keil
@@ -43,11 +41,13 @@ module BibTeX
 	# An instance of the Ruby core class +Logger+.
 	# Used for logging by BibTeX-Ruby.
 	#
-	Log = Logger.new(STDERR)
-	Log.level = ENV.has_key?('DEBUG') ? Logger::DEBUG : Logger::WARN
-	Log.datetime_format = '%Y-%m-%d %H:%M:%S'
+	@log = Logger.new(STDERR)
+	@log.level = ENV.has_key?('DEBUG') ? Logger::DEBUG : Logger::WARN
+	@log.datetime_format = '%Y-%m-%d %H:%M:%S'
 
-  def self.log; BibTeX::Log; end
+  class << self
+    attr_reader :log
+  end
 
 end
 

data/lib/bibtex/bibliography.rb

@@ -16,9 +16,6 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 #++
 
-require 'forwardable'
-require 'open-uri'
-
 module BibTeX
 
   #
@@ -35,8 +32,8 @@ module BibTeX
     
     class << self    
 
-			attr_reader :defaults
-			
+      attr_reader :defaults
+      
       # Opens and parses the `.bib' file at the given +path+. Returns
       # a new Bibliography instance corresponding to the file, or, if a block
       # is given, yields the instance to the block, ensuring that the file
@@ -53,7 +50,7 @@ module BibTeX
       #
       def open(path, options = {})
         b = parse(Kernel.open(path, 'r:UTF-8').read, options)
-				b.path = path
+        b.path = path
         return b unless block_given?
 
         begin
@@ -65,14 +62,14 @@ module BibTeX
 
       # Parses the given string and returns a corresponding Bibliography instance.
       def parse(input, options = {})
-				case input
-				when Array, Hash, Element
-					Bibliography.new(options).add(input)
-				when ::String
-        	Parser.new(options).parse(input) || Bibliography.new(options)
-				else
-					raise ArgumentError, "failed to parse #{input.inspect}"
-				end
+        case input
+        when Array, Hash, Element
+          Bibliography.new(options).add(input)
+        when ::String
+          Parser.new(options).parse(input) || Bibliography.new(options)
+        else
+          raise ArgumentError, "failed to parse #{input.inspect}"
+        end
       end
       
       # Defines a new accessor that selects elements by type.
@@ -88,22 +85,30 @@ module BibTeX
 
     attr_reader :data, :strings, :entries, :errors, :options
 
-    attr_by_type :article, :book, :journal, :collection, :preamble, :comment,
-			:meta_content
+    attr_by_type :article, :book, :journal, :collection, :preamble,
+      :comment, :meta_content
     
-    def_delegators :@data, :length, :size, :each, :empty?, :last
-		def_delegators :@entries, :has_key?
+    def_delegators :@data, :length, :size, :empty?
+    def_delegators :@entries, :key?, :has_key?
     
 
     # Creates a new bibliography.
     def initialize(options = {})
       @options = Bibliography.defaults.merge(options)
-      @data, @strings = [], {}
-			@entries = Hash.new { |h,k| h.fetch(k.to_s, nil) }
+      @data, @strings, @errors = [], {}, []
+      @entries = Hash.new { |h,k| h.fetch(k.to_s, nil) }
 
       yield self if block_given?
     end
     
+    def initialize_copy(other)
+      @options = other.options.dup
+      @errors = other.errors.dup
+      @data, @strings = [], {}
+      @entries = Hash.new { |h,k| h.fetch(k.to_s, nil) }
+      add(other.data)
+    end
+    
     # Adds a new element, or a list of new elements to the bibliography.
     # Returns the Bibliography for chainability.
     def add(*arguments)
@@ -127,11 +132,21 @@ module BibTeX
       options[:quotes] ||= %w({ })
 
       File.open(path, 'w:UTF-8') do |f|
-				f.write(to_s(options))
-			end
-			
+        f.write(to_s(options))
+      end
+      
       self
     end
+
+
+    def each
+      if block_given?
+        data.each(&Proc.new)
+        self
+      else
+        to_enum
+      end
+    end
     
 
     def parse_names
@@ -150,12 +165,12 @@ module BibTeX
     # entry). @see Entry#convert!
     def convert (filter)
       entries.each_value do |entry|
-				entry.convert!(filter) if !block_given? || yield(entry)
-			end
-			
+        entry.convert!(filter) if !block_given? || yield(entry)
+      end
+      
       self
     end
-    		
+        
 
     # Deletes an object, or a list of objects from the bibliography.
     # If a list of objects is to be deleted, you can either supply the list
@@ -173,10 +188,6 @@ module BibTeX
     alias rm delete
 
 
-    # Returns an element or a list of elements according to the given index,
-    # range, or query. Contrary to the Bibliography#query this method does
-    # not yield to a block for additional refinement of the query.
-    #
     # call-seq:
     # >> bib[-1]
     # => Returns the last element of the Bibliography or nil
@@ -196,34 +207,35 @@ module BibTeX
     # => Returns all objects that match 'ruby' anywhere or []
     # >> bib['@book[keywords=ruby]']
     # => Returns all books whose keywords attribute equals 'ruby' or []
+    #
+    # Returns an element or a list of elements according to the given index,
+    # range, or query. Contrary to the Bibliography#query this method does
+    # not yield to a block for additional refinement of the query.
+    #
     def [](*arguments)
       raise(ArgumentError, "wrong number of arguments (#{arguments.length} for 1..2)") unless arguments.length.between?(1,2)
 
       case
       when arguments[0].is_a?(Numeric) || arguments[0].is_a?(Range)
         data[*arguments] 
-			when arguments.length == 1
-				case
-				when arguments[0].nil?
-					nil
-				when arguments[0].respond_to?(:empty?) && arguments[0].empty?
-					nil
-      	when arguments[0].is_a?(Symbol)
-        	entries[arguments[0]]
-	 			when arguments[0].respond_to?(:start_with?) && !arguments[0].start_with?('@')
-        	entries[arguments[0]]
-				else
-					query(*arguments)
-				end
+      when arguments.length == 1
+        case
+        when arguments[0].nil?
+          nil
+        when arguments[0].respond_to?(:empty?) && arguments[0].empty?
+          nil
+        when arguments[0].is_a?(Symbol)
+          entries[arguments[0]]
+        when arguments[0].respond_to?(:start_with?) && !arguments[0].start_with?('@')
+          entries[arguments[0]]
+        else
+          query(*arguments)
+        end
       else
         query(*arguments)
       end
     end
 
-    # Returns all objects which could not be parsed successfully.
-    def errors
-      @errors ||= []
-    end
 
     # Returns true if there are object which could not be parsed.
     def errors?
@@ -233,14 +245,14 @@ module BibTeX
     # Returns true if the +Bibliography+ contains no errors and only
     # valid BibTeX objects (meta content is ignored).
     def valid?
-      !errors? && @entries.values.all?(&:valid?)
+      !errors? && entries.values.all?(&:valid?)
+    end
+    
+    # Returns a list of the names of all authors, editors and translators in the Bibliography.
+    def names
+      map(&:names).flatten
     end
     
-		# Returns a list of the names of all authors, editors and translators in the Bibliography.
-		def names
-			map(&:names).flatten
-		end
-		
     # Replaces all string symbols which are defined in the bibliography.
     #
     # By default symbols in @string, @preamble and entries are replaced; this
@@ -273,8 +285,9 @@ module BibTeX
       self
     end
     
+    
     def sort(*arguments, &block)
-      @data.sort(*arguments, &block)
+      data.sort(*arguments, &block)
       self
     end
     
@@ -283,6 +296,10 @@ module BibTeX
       map { |o| o.to_s(options) }.join
     end
 
+    def inspect
+      "#<#{self.class} data=[#{length}]>"
+    end
+    
     def to_a(options = {})
       map { |o| o.to_hash(options) }
     end
@@ -308,16 +325,16 @@ module BibTeX
     end
     
     # Returns a REXML::Document representation of the bibliography using the
-		# BibTeXML format.
+    # BibTeXML format.
     def to_xml(options = {})
       require 'rexml/document'
-	    
+      
       xml =  REXML::Document.new
       xml << REXML::XMLDecl.new('1.0','UTF-8')
 
       root = REXML::Element.new('bibtex:file')
-			root.add_namespace('bibtex', 'http://bibtexml.sf.net/')
-			
+      root.add_namespace('bibtex', 'http://bibtexml.sf.net/')
+      
       each { |e| root.add_element(e.to_xml(options)) }
 
       xml.add_element(root)
@@ -342,11 +359,11 @@ module BibTeX
     # #=> same as above without using a block
     #
     def query(*arguments, &block)
-      raise(ArgumentError, "wrong number of arguments (#{arguments.length} for 0..2)") unless arguments.length.between?(0,2)
+      raise ArgumentError, "wrong number of arguments (#{arguments.length} for 0..2)" unless arguments.length.between?(0,2)
 
       q, selector = arguments.reverse
       filter = block ? Proc.new { |e| e.match?(q) && block.call(e) } :
-				Proc.new { |e| e.match?(q) }
+        Proc.new { |e| e.match?(q) }
 
       send(query_handler(selector), &filter)
     end
@@ -363,26 +380,26 @@ module BibTeX
       other.respond_to?(:to_a) ? to_a <=> other.to_a : nil
     end
     
-		# TODO this should be faster than select_duplicates_by
-		# def detect_duplicates_by(*arguments)
-		# end
-
-		def select_duplicates_by(*arguments)
-			d, fs = Hash.new([]), arguments.flatten.map(&:to_sym)
-			q('@entry') do |e|
-				d[e.generate_hash(fs)] << e
-			end
-			
-			d.values.dup
-		end
-		
-		alias duplicates select_duplicates_by
-		
-		def duplicates?
-			!select_duplicates_by?.empty?
-		end
-		
-		
+    # TODO this should be faster than select_duplicates_by
+    # def detect_duplicates_by(*arguments)
+    # end
+
+    def select_duplicates_by(*arguments)
+      d, fs = Hash.new([]), arguments.flatten.map(&:to_sym)
+      q('@entry') do |e|
+        d[e.generate_hash(fs)] << e
+      end
+      
+      d.values.dup
+    end
+    
+    alias duplicates select_duplicates_by
+    
+    def duplicates?
+      !select_duplicates_by?.empty?
+    end
+    
+    
     private
     
     def query_handler(selector)

data/lib/bibtex/elements.rb

@@ -1,6 +1,6 @@
 #--
 # BibTeX-Ruby
-# Copyright (C) 2010-2011	Sylvester Keil <sylvester.keil.or.at>
+# Copyright (C) 2010-2011 Sylvester Keil <sylvester.keil.or.at>
 # 
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -9,45 +9,45 @@
 # 
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	See the
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 # 
 # You should have received a copy of the GNU General Public License
-# along with this program.	If not, see <http://www.gnu.org/licenses/>.
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
 #++
 
 module BibTeX
 
-	#
-	# The base class for BibTeX objects.
-	#
-	class Element
+  #
+  # The base class for BibTeX objects.
+  #
+  class Element
     include Comparable
     
     attr_writer :id
-		attr_reader :bibliography
-		
-		# Returns an array of BibTeX elements.
+    attr_reader :bibliography
+    
+    # Returns an array of BibTeX elements.
     def self.parse(input, options = {})
-			case input
-			when Element
-				[input]
-			when Hash
-				[Entry.new(input)]
-			when Array
-				input.inject([]) { |s,a| s.concat(parse(a, options)) }
-			when ::String
-	      Parser.new(options).parse(input).data.each do |e|
-	        e.parse_names unless !e.respond_to?(:parse_names) || options[:parse_names] == false
-	        e.parse_month unless !e.respond_to?(:parse_month) || options[:parse_months] == false
-	      end
-			else
-				raise ArgumentError, "failed to parse Element from #{input.inspect}"
-			end
+      case input
+      when Element
+        [input]
+      when Hash
+        [Entry.new(input)]
+      when Array
+        input.inject([]) { |s,a| s.concat(parse(a, options)) }
+      when ::String
+        Parser.new(options).parse(input).data.each do |e|
+          e.parse_names unless !e.respond_to?(:parse_names) || options[:parse_names] == false
+          e.parse_month unless !e.respond_to?(:parse_month) || options[:parse_months] == false
+        end
+      else
+        raise ArgumentError, "failed to parse Element from #{input.inspect}"
+      end
     end
     
-		# Returns a string containing the object's content.
-		def content(options = {}); ''; end
+    # Returns a string containing the object's content.
+    def content(options = {}); ''; end
 
     # Invokes BibTeX string replacement on this element.
     def replace(*arguments); self; end
@@ -63,19 +63,19 @@ module BibTeX
       self.class.name.split(/::/).last.gsub(/([[:lower:]])([[:upper:]])/) { "#{$1}_#{$2}" }.downcase.intern
     end
   
-		# Returns a list of names for that Element. All Elements except Entries return an empty list.
-		def names
-			[]
-		end
-		
+    # Returns a list of names for that Element. All Elements except Entries return an empty list.
+    def names
+      []
+    end
+    
     def has_type?(type)
       self.type == type.intern || defined?(type) == 'constant' && is_a?(type)
     end
     
     [:entry, :book, :article, :collection, :string, :preamble, :comment]. each do |type|
-			method_id = "#{type}?"
-			define_method(method_id) { has_type?(type) } unless method_defined?(method_id)
-		end
+      method_id = "#{type}?"
+      define_method(method_id) { has_type?(type) } unless method_defined?(method_id)
+    end
     
     # Returns true if the element matches the given query.
     def matches?(query)
@@ -112,85 +112,85 @@ module BibTeX
     
     alias meet? meets?
     
-		alias to_s content
-		
-		def to_hash(options = {})
-		  { type => content }
-		end
-	  
-	  def to_yaml(options = {})
-	    require 'yaml'
+    alias to_s content
+    
+    def to_hash(options = {})
+      { type => content }
+    end
+    
+    def to_yaml(options = {})
+      require 'yaml'
       to_hash.to_yaml
-	  end
-	  
-	  def to_json(options = {})
-	    MultiJson.encode(to_hash(options))
-	  end
-	  
-	  def to_xml(options = {})
-	    require 'rexml/document'
-	    xml = REXML::Element.new(type)
-	    xml.text = content
-	    xml
-	  end
+    end
+    
+    def to_json(options = {})
+      MultiJson.encode(to_hash(options))
+    end
+    
+    def to_xml(options = {})
+      require 'rexml/document'
+      xml = REXML::Element.new(type)
+      xml.text = content
+      xml
+    end
 
-		# Called when the element was added to a bibliography.
-		def added_to_bibliography(bibliography)
-			# raise BibTeXError, "failed to add element to Bibliography: already registered with another Bibliography" unless @bibliography.nil?
-			@bibliography = bibliography
-			self
-		end
-		
-		# Called when the element was removed from a bibliography.
-		def removed_from_bibliography(bibliography)
-			@bibliography = nil
-			self
-		end
-		
-		def <=>(other)
-		  return nil unless other.respond_to? :type and other.respond_to? :to_s
-		  [type, to_s] <=> [other.type, other.to_s]
-		end
-		
-		# Returns the Element as a nicely formatted string.
-		def inspect
-			"#<#{self.class} #{content.gsub(/\n/, ' ')}>"
-		end
-	end
+    # Called when the element was added to a bibliography.
+    def added_to_bibliography(bibliography)
+      # raise BibTeXError, "failed to add element to Bibliography: already registered with another Bibliography" unless @bibliography.nil?
+      @bibliography = bibliography
+      self
+    end
+    
+    # Called when the element was removed from a bibliography.
+    def removed_from_bibliography(bibliography)
+      @bibliography = nil
+      self
+    end
+    
+    def <=>(other)
+      return nil unless other.respond_to? :type and other.respond_to? :to_s
+      [type, to_s] <=> [other.type, other.to_s]
+    end
+    
+    # Returns the Element as a nicely formatted string.
+    def inspect
+      "#<#{self.class} #{content.gsub(/\n/, ' ')}>"
+    end
+  end
 
  
-	#
-	# Represents a @string object.
-	#
-	# In BibTeX @string objects contain a single string constant
-	# assignment. For example, @string{ foo = "bar" } defines the
-	# constant `foo'; this constant can be used (using BibTeX's
-	# string concatenation syntax) in susbsequent
-	# @string and @preamble objects, as well as in field values
-	# of regular entries.
-	#
-	class String < Element	  
+  #
+  # Represents a @string object.
+  #
+  # In BibTeX @string objects contain a single string constant
+  # assignment. For example, @string{ foo = "bar" } defines the
+  # constant `foo'; this constant can be used (using BibTeX's
+  # string concatenation syntax) in susbsequent
+  # @string and @preamble objects, as well as in field values
+  # of regular entries.
+  #
+  class String < Element    
     include Replaceable
     
-		attr_reader :key
+    attr_reader :key
 
-		# Creates a new instance.
-		def initialize(key = nil, value = nil)
-		  @key, @value = key.to_sym, Value.new(value)
-			yield self if block_given?
-		end
+    # Creates a new instance.
+    def initialize(key = nil, value = nil)
+      @key, @value = key.to_sym, Value.new(value)
+      yield self if block_given?
+    end
 
-		# Sets the string's key (i.e., the symbol identifying the constant).
-		def key=(key)
-		  raise(ArgumentError, "keys must be convertible to Symbol; was: #{type.class.name}.") unless type.respond_to?(:to_sym)
-			
-			unless bibliography.nil?
-				bibliography.strings.delete(@key)
-				bibliography.strings[key.to_sym] = self
-			end
+    # Sets the string's key (i.e., the symbol identifying the constant).
+    def key=(key)
+      raise(ArgumentError, "keys must be convertible to Symbol; was: #{type.class.name}.") unless type.respond_to?(:to_sym)
+      
+      unless bibliography.nil?
+        bibliography.strings.delete(@key)
+        bibliography.strings[key.to_sym] = self
+      end
 
-			@key = key.to_sym
-		end
+      @key = key.to_sym
+    end
 
     # Retuns the string's value if parameter matches the key; nil otherwise.
     def [](key)
@@ -198,104 +198,104 @@ module BibTeX
     end
     
 
-		# Called when the element was added to a bibliography.
-		def added_to_bibliography(bibliography)
-			super
-			bibliography.strings[@key] = self
-			self
-		end
-		
-		# Called when the element was removed from a bibliography.
-		def removed_from_bibliography(bibliography)
-			super
-			bibliography.strings[@key] = nil
-			self
-		end
+    # Called when the element was added to a bibliography.
+    def added_to_bibliography(bibliography)
+      super
+      bibliography.strings[@key] = self
+      self
+    end
+    
+    # Called when the element was removed from a bibliography.
+    def removed_from_bibliography(bibliography)
+      super
+      bibliography.strings[@key] = nil
+      self
+    end
 
-		# Returns a string representation of the @string's content.
-		def content
-			"#@key = #{@value.to_s(:quotes => '"')}"
-		end
+    # Returns a string representation of the @string's content.
+    def content
+      "#@key = #{@value.to_s(:quotes => '"')}"
+    end
 
-		# Returns a string representation of the @string object.
-		def to_s(options = {})
-			"@string{ #{content} }"
-		end
-		
-		def to_hash(options = {})
-		  { :string => { @key => @value.to_s(:quotes => '"') } }
-		end
-		
-		def to_xml(options = {})
-		  require 'rexml/document'
-	    
-			xml = REXML::Element.new(:string)
-			
-			k, v = REXML::Element.new(:key), REXML::Element.new(:value)
-			k.text = key.to_s
-			v.text = value.to_s(:quotes => '"')
-		
-			xml.add_elements(k)
-			xml.add_elements(v)
-			
-		  xml
-		end
-	end
+    # Returns a string representation of the @string object.
+    def to_s(options = {})
+      "@string{ #{content} }"
+    end
+    
+    def to_hash(options = {})
+      { :string => { @key => @value.to_s(:quotes => '"') } }
+    end
+    
+    def to_xml(options = {})
+      require 'rexml/document'
+      
+      xml = REXML::Element.new(:string)
+      
+      k, v = REXML::Element.new(:key), REXML::Element.new(:value)
+      k.text = key.to_s
+      v.text = value.to_s(:quotes => '"')
+    
+      xml.add_elements(k)
+      xml.add_elements(v)
+      
+      xml
+    end
+  end
 
-	#
-	# Represents a @preamble object.
-	#
-	# In BibTeX an @preamble object contains a single string literal,
-	# a single constant, or a concatenation of string literals and
-	# constants.
-	class Preamble < Element
-	  include Replaceable
+  #
+  # Represents a @preamble object.
+  #
+  # In BibTeX an @preamble object contains a single string literal,
+  # a single constant, or a concatenation of string literals and
+  # constants.
+  class Preamble < Element
+    include Replaceable
 
-		# Creates a new instance.
-		def initialize(value = '')
+    # Creates a new instance.
+    def initialize(value = '')
       @value = Value.new(value)
-		end
+    end
     
-		# Returns a string representation of the @preamble's content.
-		def content
-			@value.to_s(:quotes => '"')
-		end
+    # Returns a string representation of the @preamble's content.
+    def content
+      @value.to_s(:quotes => '"')
+    end
 
-		# Returns a string representation of the @preamble object
-		def to_s(options = {})
-			"@preamble{ #{content} }"
-		end
-	end
+    # Returns a string representation of the @preamble object
+    def to_s(options = {})
+      "@preamble{ #{content} }"
+    end
+  end
 
-	# Represents a @comment object.
-	class Comment < Element
+  # Represents a @comment object.
+  class Comment < Element
     attr_accessor :content
     
-		def initialize(content = '')
-			@content = content
-		end
+    def initialize(content = '')
+      @content = content
+    end
 
-		def to_s(options = {})
-			"@comment{ #@content }"
-		end
-	end
+    def to_s(options = {})
+      "@comment{ #@content }"
+    end
+  end
 
-	# Represents text in a `.bib' file, but outside of an
-	# actual BibTeX object; typically, such text is treated
-	# as a comment and is ignored by the parser. 
-	# BibTeX-Ruby offers this class to allows for
-	# post-processing of this type of `meta' content. If you
-	# want the parser to include +MetaComment+ objects, you
-	# need to add +:meta_content+ to the parser's +:include+
-	# option.
-	class MetaContent < Element
-	  attr_accessor :content
-	  
-		def initialize(content = '')
-			@content = content
-		end
+  # Represents text in a `.bib' file, but outside of an
+  # actual BibTeX object; typically, such text is treated
+  # as a comment and is ignored by the parser. 
+  # BibTeX-Ruby offers this class to allows for
+  # post-processing of this type of `meta' content. If you
+  # want the parser to include +MetaComment+ objects, you
+  # need to add +:meta_content+ to the parser's +:include+
+  # option.
+  class MetaContent < Element
+    attr_accessor :content
+    
+    def initialize(content = '')
+      @content = content
+    end
 
-		def to_s(options = {}); @content; end
-	end
+    def to_s(options = {}); @content; end
+  end
 
 end