From: trans <transfire@...>
Date: 2009-10-02T08:06:03+09:00
Subject: Re: Making an RDoc Template Gem

Hi again---

On Oct 1, 1:32 pm, Gordon Thiesfeld <gthiesf...@gmail.com> wrote:
> I think the best way to do it is as an rdoc plugin.  RDoc_chm[1] is an
> RDoc plugin to.  RDoc searches for lib/rdoc/discover.rb in gems, and
> loads them.  You have to have a require in discover.rb.  This will add
> your gem's lib and bin to $LOAD_PATH.  I'm not totally sure how that
> works, if it's a feature of RubyGems, or RDoc.  If you have no ruby
> code in your template, you can just use "require 'rdoc/discover'".
> The Darkfish generator searches for a template dir of the name
> provided on the command line.  If no template is given, it defaults to
> the name of the generator.

Unfortunately the discover.rb thing does not work. I'm not sure what
RDoc is doing --it doesn't seem like it is doing anything in this
regard actually. To get my RDoc to discover my template I somehow have
to run:

  gem 'rdazzle'

So it will be on the #LOAD_PATH. The only place to do that is say a
Rakefile and use rake to generate the rdocs, or to add RUBYTOPT="-
rrdazzle".

Not to mention a couple options seem busted.

RDoc needs some work.

~Trans.