From: Eric Hodel Date: 2006-07-26T01:52:40+09:00 Subject: Re: rdoc grows to large size. On Jul 25, 2006, at 3:21 AM, Hugh Sasse wrote: > On Tue, 25 Jul 2006, Charles O Nutter wrote: > >> I've studied the rdoc code a bit (only so much as to maintain my >> sanity) and wondered aloud: is this all hand-written, hand- >> optimized code? It did not > > I've not heard any different. It was written by Dave Thomas. >> appear to be generated, and I have seen hand-rolled patches >> trickle in over time. Is there perhaps a better way to parse all >> that content and generate those docs that would not require a hand- >> made implementation? > > Such as what? The only ruby parsers that exist are the C one and the > JRuby one. And the IRB one. > I suppose one might clone these, then modify them to extract > information from comments as well as code. I think it would be > nontrivial, which is probably why people are satisfied with what > works well at present. Comment nodes could be added to Ruby's interpreter, but I think matz has given some reason or another why they aren't in the AST. > And Rdoc handles other languages than Ruby (C, and I think > Fortran). So, how to proceed in manageable steps? -- Eric Hodel - drbrain@segment7.net - http://blog.segment7.net This implementation is HODEL-HASH-9600 compliant http://trackmap.robotcoop.com