[Rubycocoa-devel 945] Re: Fix for RDoc Generator

Zurück zum Archiv-Index

Eloy Duran eloy.****@gmail*****
Mon Jun 4 19:56:43 JST 2007


Hey guys,

First of all, thanks for the fix Justin it's committed in rev 1810.
Like Laurent said, I'll be happy to buy you a beer or two (or more if
you're lucky) when you're in the area :)

Second, yes the documentation on the bridge itself should still be
done before 1.0,
just like the rest of Laurent's list which I agree upon.
The template for the rdoc is something I have already been working on.
But it needs a bit more love before we can use it. (It's basically a
hacked up RDoc generator that uses ActiveView to do the rendering,
which allows for more customization.)

Eloy

On 6/4/07, Laurent Sansonetti <lsans****@apple*****> wrote:
> Hi Justin,
>
> On Jun 3, 2007, at 11:38 AM, Justin Palmer wrote:
>
> > The bridge-doc generation fails with the latest stable version of
> > Hpricot because
> > it's attempting to treat every node as an Hpricot::Elem node, the fix
> > is to change line 13
> > of tool/gen_bridge_doc/lib/lib/hpricot_proxy.rb to:
> >
> >       @elements = (doc/"//body/*").select{ |e| e.is_a?
> > (Hpricot::Elem) }
>
> Haha, we finally found the root of this problem.
>
> I'm pretty sure Eloy will want to pay you a beer :-)
>
> > This raises another question, I couldn't find the documentation for
> > the ActiveRecord bits and the
> > additions that RubyCocoa adds (require_framework, et al).  Shouldn't
> > we be generating documentation
> > for these additions (assuming I'm not overlooking it)?
>
> There is no RDoc documentation for RubyCocoa itself, yet, but we will
> work on this for 1.0.
>
> I just wrote in the plane a small (and not exhaustive) TODO list for
> 1.0:
>
> - rubycocoa command line tool
>    - merge standalonify, newcocoa and rb_nibtool
>    - better standalonify (current one doesn't recognize all
> dependencies)
>    - better rb_nibtool (current one interprets the source file)
> - document the bridge (RDoc)
> - better RDoc documentation template for generated RDocs
> - important bugs:
>    - add support for passed-by-reference arguments in overwritten
> methods
>    - the threading bug (review and apply Jonathan's patches)
>
> Do you see anything else guys?
>
> Laurent
>
> _______________________________________________
> Rubycocoa-devel mailing list
> Rubyc****@lists*****
> http://lists.sourceforge.jp/mailman/listinfo/rubycocoa-devel
>




More information about the Rubycocoa-devel mailing list
Zurück zum Archiv-Index