[csw-maintainers] ruby help

[Philip Brown]

On Sun, Dec 14, 2008 at 07:17:25PM -0800, Philip Brown wrote:
> On Sun, Dec 14, 2008 at 10:10:42PM -0500, Ben Walton wrote:
> > Well, as far as I've determined, the actual ruby package (and tcl/tk,
> > but I don't play with that) is the same.  The documentation
> > differences are in extra files generated by rdoc from the source files
> > (which would indicate extra/different info collected/collated).  So
> > supposedly, the input is identical, but the output differs.
> > 
> > I've run a diff across the files generated on both architectures to
> > verify that the files installed (where not binary) are identical.  As
> > best as I can tell, the _behaviour_ of rdoc differs on the two
> > platforms, which to me indicates some odd little bug somewhere deep in
> > the guts of it all (maybe in the rb_string or rb_hash somewhere?)...
> 
> oh. 
> well, in that case, I'd say that it's fine to release, with a bug filed "oh
> by the way the documentation is a bit off, in these areas, we dont
> know why..."

Hmm.. actually, the analysis above is a bit lacking.

I think the more rigourous thing to do would be for you to explicitly
mention some of the documentation differences/lackings, and then for
someone who knows ruby, to explicitly run a test, "yes, these functions
work ok on both platforms, even though they may not be documented on one
of them".

yes?