Laurent Sansonetti
lsans****@apple*****
Sun Jan 7 02:37:31 JST 2007
Hi Eloy,
This is very great work! I believe that your script should be
integrated in RubyCocoa and be used during the build process to
generate Rdoc files for the frameworks we support. Then they could be
installed in the right places.
What do the other people here think about it?
The only downside is the dependency on hpricot. Fortunately, end users
would use the binary installer that would contain the Rdoc files. But
people who wants to build RubyCocoa by themselves would need hpricot
for the documentation (however we can make it optional, if hpricot is
not found then we don't do documentation).
Laurent
On Jan 6, 2007, at 4:51 AM, Eloy Duran wrote:
> Hi guys,
>
> Here's a script I started on that parses an reference.html file from
> the apple docs.
> There's still lot's of work to be done, but the first results look
> promising.
> So I decided to mail it to the list, because together we might be
> able to
> fix the bugs faster..... :)
>
> At the moment it only tries to parse methods,
> so any notification etc will be tried to be handled as a method
> which should of course still be fixed.
> Also there's no difference between a class and a instance method.
> But these should be simple to fix...
>
> One thing I was unable to figure out on this waaaaay to late hour of
> the day,
> is a problem with some of the "Availability" sections.
> As you can see in the output of the script, some of the methods
> get the correct availability but some give some problems.
> E.g. if you parse the NSView ref (which is the one it tries by
> default),
> in the allocateGState method the text in the availability section
> isn't correct.
> The text is part of the discussion, but this happens because the
> discussion
> section contains multiple paragraphs ('p' tags).
>
> And probably lots of more stuff that I forgot about right now....
>
> Download:
> http://www.superalloy.nl/files/docs.zip
>
> Requirement:
> Hpricot
>
> Usage:
> $ruby parse_docs.rb > output.rb
> $rdoc output.rb
>
> Cheers,
> Eloy
> _______________________________________________
> Rubycocoa-devel mailing list
> Rubyc****@lists*****
> http://lists.sourceforge.jp/mailman/listinfo/rubycocoa-devel