def find_remarks(filter=[])
     if (@source.nil?)
       rfiles = find_xincludes(@doc)
     else
       @doc = XML::Document.file(@source)
       rfiles = [@source_file] + find_xincludes(@doc)
     end
     @remarks = rfiles.map {|rf|
       ind = XML::Document.file(File.expand_path(rf,@source.nil? ? '.' : @source_dir))
       ind.root.namespaces.default_prefix = 'db'
       rems = find_remarks_in_doc(ind, rf)
       rems
     }.flatten
     if (filter.empty?)
       @remarks
     else
       filter.map {|f|
         @remarks.find_all {|r| f.casecmp(r[:keyword]) == 0}
       }.flatten
     end
   end
def find_remarks(filter=[])
     if (@source.nil?)
       rfiles = find_xincludes(@doc)
     else
       @doc = XML::Document.file(@source)
       rfiles = [@source_file] + find_xincludes(@doc)
     end
     @remarks = rfiles.map {|rf|
       ind = XML::Document.file(File.expand_path(rf,@source.nil? ? '.' : @source_dir))
       ind.root.namespaces.default_prefix = 'db'
       rems = find_remarks_in_doc(ind, rf)
       rems
     }.flatten
     if (filter.empty?)
       @remarks
     else
       filter.map {|f|
         @remarks.find_all {|r| f.casecmp(r[:keyword]) == 0}
       }.flatten
     end
   end
Finds the remarks by looking through all the Xincluded files

 The remarks returned can be filtered by keyword if an keyword array is
 passed as an argument.