class SourceAnnotationExtractor

of the line (or closing ERb comment tag) is considered to be their text.
start with the tag optionally followed by a colon. Everything up to the end
Annotations are looked for in comments and modulus whitespace they have to
the filename is not stored.
represent the line where the annotation lives, its tag, and its text. Note
Annotation objects are triplets :line, :tag, :text that
and friends. See rake -T notes and railties/lib/tasks/annotations.rake.
rake notes:optimize
rake notes
Implements the logic behind the rake tasks for annotations like

def self.enumerate(tag, options={})

This class method is the single entry point for the rake tasks.

hash is passed to each annotation's +to_s+.
+.rxml+, +.rjs+, +.rhtml+, or +.erb+ are taken into account. The +options+
and +test+ (recursively). Only filenames with extension +.builder+, +.rb+,
Prints all annotations with tag +tag+ under the root directories +app+, +lib+, 
def self.enumerate(tag, options={})
  extractor = new(tag)
  extractor.display(extractor.find, options)
end

def display(results, options={})

The +options+ hash is passed to each annotation's +to_s+.
Prints the mapping from filenames to annotations in +results+ ordered by filename. 
def display(results, options={})
  results.keys.sort.each do |file|
    puts "#{file}:"
    results[file].each do |note|
      puts "  * #{note.to_s(options)}"
    end
    puts
  end
end

def extract_annotations_from(file, pattern)

Otherwise it returns an empty hash.
a hash with a single entry that maps +file+ to an array of its annotations.
If +file+ is the filename of a file that contains annotations this method returns 
def extract_annotations_from(file, pattern)
  lineno = 0
  result = File.readlines(file).inject([]) do |list, line|
    lineno += 1
    next list unless line =~ pattern
    list << Annotation.new(lineno, $1, $2)
  end
  result.empty? ? {} : { file => result }
end

def find(dirs=%w(app lib test))

are taken into account.
those with extension +.builder+, +.rb+, +.rxml+, +.rjs+, +.rhtml+, and +.erb+
with their annotations. Only files with annotations are included, and only
Returns a hash that maps filenames under +dirs+ (recursively) to arrays 
def find(dirs=%w(app lib test))
  dirs.inject({}) { |h, dir| h.update(find_in(dir)) }
end

def find_in(dir)

are taken into account.
those with extension +.builder+, +.rb+, +.rxml+, +.rjs+, +.rhtml+, and +.erb+
with their annotations. Only files with annotations are included, and only
Returns a hash that maps filenames under +dir+ (recursively) to arrays 
def find_in(dir)
  results = {}
  Dir.glob("#{dir}/*") do |item|
    next if File.basename(item)[0] == ?.
    if File.directory?(item)
      results.update(find_in(item))
    elsif item =~ /\.(builder|(r(?:b|xml|js)))$/
      results.update(extract_annotations_from(item, /#\s*(#{tag}):?\s*(.*)$/))
    elsif item =~ /\.(rhtml|erb)$/
      results.update(extract_annotations_from(item, /<%\s*#\s*(#{tag}):?\s*(.*?)\s*%>/))
    end
  end
  results
end

def initialize(tag) 

def initialize(tag)
  @tag = tag
end