# File lib/plugins/syckle/webri.rb, line 197
    def clean
      if File.directory?(output)
        rm_r(output)
        status "removed #{output}" #unless dryrun?
      end
    end

# File lib/plugins/syckle/webri.rb, line 114
    def document(options=nil)
      options ||= {}

      # TODO: get rid of options (?) originally they were used for commanline overrides,
      # but that's not being used anymore, and it's probably better that way.
      title    = options['title']    || self.title
      output   = options['output']   || self.output
      main     = options['main']     || self.main
      template = options['template'] || self.template
      files    = options['files']    || self.files
      exclude  = options['exclude']  || self.exclude
      #adfile   = options['adfile']   || self.adfile
      extra    = options['extra']    || self.extra
      root     = options['root']     || self.root

      # NOTE: Due to a bug in RDOC this needs to be done so that
      # alternate templates can be used.
      begin
        gem('rdoc')
        #gem(templib || template)
      rescue LoadError
      end

      require 'rdoc/rdoc'

      #output = File.expand_path(output)

      # you can specify more than one possibility, first match wins
      #adfile = [adfile].flatten.compact.find do |f|
      #  File.exist?(f)
      #end

      main = Dir.glob(main, File::FNM_CASEFOLD).first

      include_files = files.to_list.uniq
      exclude_files = exclude.to_list.uniq

      if mfile = project.manifest_file
        exclude_files << mfile.basename.to_s # TODO: I think base name should retun a string?
      end

      filelist = amass(include_files, exclude_files)
      filelist = filelist.select{ |fname| File.file?(fname) }

      if outofdate?(output, *filelist) or force?
        status "Generating #{output}"

        #target_main = Dir.glob(target['main'].to_s, File::FNM_CASEFOLD).first
        #target_main   = File.expand_path(target_main) if target_main
        #target_output = File.expand_path(File.join(output, subdir))
        #target_output = File.join(output, subdir)

        argv = []
        argv.concat(extra.split(/\s+/))
        argv.concat ['--op', output]
        argv.concat ['--main', main] if main
        argv.concat ['--template', template] if template
        argv.concat ['--title', title] if title

        exclude_files.each do |file|
          argv.concat ['--exclude', file]
        end

        argv = argv + filelist #include_files

        rdoc_target(output, include_files, argv)
        #rdoc_insert_ads(output, adfile)

        touch(output)
      else
        status "WebRI RDocs are current (#{output})."
      end
    end

# File lib/plugins/syckle/webri.rb, line 29
    cycle :main, :document

# File lib/plugins/syckle/webri.rb, line 189
    def reset
      if File.directory?(output)
        File.utime(0,0,output)
        report "reset #{output}" #unless dryrun?
      end
    end

# File lib/plugins/syckle/webri.rb, line 68
    def initialize_defaults
      @title    = metadata.title
      @files    = metadata.loadpath + ['[A-Z]*', 'bin'] # DEFAULT_FILES
      @output   = Dir[DEFAULT_OUTPUT_MATCH].first || DEFAULT_OUTPUT
      @extra    = DEFAULT_EXTRA
      @main     = Dir[DEFAULT_MAIN].first
      @template = ENV['RDOC_TEMPLATE'] || DEFAULT_TEMPLATE
    end

# File lib/plugins/syckle/webri.rb, line 210
    def rdoc_target(output, input, argv=[])
      #if outofdate?(output, *input) or force?
        rm_r(output) if exist?(output) and safe?(output)  # remove old rdocs

        #rdocopt['op'] = output

        #if template == 'hanna'
        #  cmd = "hanna #{extra} " + [input, rdocopt].to_console
        #else
        #  cmd = "rdoc #{extra} " + [input, rdocopt].to_console
        #end

        #argv = ("#{extra}" + [input, rdocopt].to_console).split(/\s+/)

        if verbose? or dryrun?
          puts "webri " + argv.join(" ")
          #sh(cmd) #shell(cmd)
        else
          cmd = "webri " + argv.join(" ")
          puts cmd  #if trace?
          #rdoc = ::RDoc::RDoc.new
          #rdoc.document(argv)
          #silently do
            sh(cmd) #shell(cmd)
          #end
        end
      #else
      #  puts "RDocs are current -- #{output}"
      #end
    end