Re: RDoc questions and nits

At 5:50 PM -0800 2/23/07, Rich Morin wrote:
>   *  Why does the option "--fmt xml" generate the nastygram:
>
>        Generating XML...
>        Could not find HTML template
>          'rdoc/generators/template/xml/html'

Running "rdoc --help" says:

      --fmt, -f format name
        set the output formatter (see below)
      ...
      Available output formatters: chm, html, ri, xml

so this option seems quite plausible.  Looking at the RDoc code
tree, I see:

    generators
    | chm_generator.rb      112
    | html_generator.rb    1502
    | ri_generator.rb       268
    | template/
    | | chm/
    | | | chm.rb             87
    | | html/
    | | | hefss.rb          418
    | | | html.rb           711
    | | | ...
    | | xml/
    | | | rdf.rb            112
    | | | xml.rb            112

However, the documentation

  -template name
    specify an alternate template to use when generating output
    (the default is 'standard').  This template should be in a
    directory accessible via $: as rdoc/generators/xxxx_template,
    where 'xxxx' depends on the output formatter.

doesn't match the directory structure I see in the code.  Perhaps
the text above should read "rdoc/generators/xxxx_generator".
In any case, as there is no xml_generator, this is irrelevant to
my current situation.


Anyway, I tried both of these:

  rdoc --fmt xml --template rdf
  rdoc --fmt xml --template xml

with no success.  I see that Dave Howell posted something about
this on Aug. 25, but never got a reply...  Help?

-r
-- 
http://www.cfcl.com/rdm            Rich Morin
http://www.cfcl.com/rdm/resume     rdm@xxxxxxxx
http://www.cfcl.com/rdm/weblog     +1 650-873-7841

Technical editing and writing, programming, and web development