From: Austin Ziegler <halostatue@...>
Date: 2004-11-04T23:46:03+09:00
Subject: Re: [RAKE] rdoc task fails on Win2k

On Thu, 4 Nov 2004 15:45:09 +0900, Jim Weirich <jim@weirichhouse.org> wrote:
> On Wednesday 03 November 2004 08:35 pm, James Britt wrote:
> > Not a patch, but a description of a hack that fixes this for me:
> [... changes for sensing the platform and calling the proper rdoc elided ...]
> Is rdoc universally called via a .bat file on all windows installs?  Is this
> likely to change?  Do I need to be more aggresive in determining the rdoc
> command name?
> 
> Thanks for the bug/patch report.

Why not bypass the need for calling the batch file entirely?

def build_rdoc(files)
  r = RDoc::RDoc.new
  r.document(["--main", "README", "--title", "Diff::LCS -- A Diff Algorithm",
              "--line-numbers"] + files)

rescue RDoc::RDocError => e
  $stderr.puts e.message
rescue Exception => e
  $stderr.puts "Couldn't build RDoc documentation\n#{e.message}"
end

def build_ri(files)
  ri = RDoc::RDoc.new
  ri.document(["--ri-site", "--merge"] + files)
rescue RDoc::RDocError => e
  $stderr.puts e.message
rescue Exception => e
  $stderr.puts "Couldn't build Ri documentation\n#{e.message}"
end

These could easily be massaged into something more generic and task-oriented.

-austin
-- 
Austin Ziegler * halostatue@gmail.com
               * Alternate: austin@halostatue.ca