Re: 1.8 docs, 1.4(!) docs
<jbritt <at> ruby-doc.org>
2003-03-26 18:51:23 GMT
>
> Firstly, I'd like to ask if anyone has any docs (in progress) for
> 1.8? I have built docs automatically from the snapshot:
>
> http://www.eng .cse.dmu.ac.uk/~hgs/ruby/RUBY_SNAPSHOT_RDOC/index.html
>
> but there are problems with this, IMHO. In particular, Net::HTTP
> seems to have most of its get related methods with arguments called
> arg1, arg2, arg3. This doesn't convey much semantic information. I
> can't debug why my script to grab a web page won't work in 1.8 when
> it will with 1.6.7. I know there is an Net::HTTP::Get class now,
> but can't see how to use it. I suppose I should use Uri... for this
> in 1.8, but I'd like to keep my code portable where possible.
There was (or is) a project to update the comments in the source, and I
would imagine
this would include Net::HTTP. I have no idea what the status of this,
though.
I wonder if there is any feedback process to let those doing the commenting
how well it comes across to an end user? (Is class Foo
http://www.eng.cse.dmu.ac.uk/~hgs/ruby/RUBY_SNAPSHOT_RDOC/classes/Foo.html
supposed to be there?)
>
>
> Secondly, there is, on ruby-doc.org, a copy of the 1.4 manual in
> HTML. I don't know if anyone is going to bring this up to date, but
> whether or not they do, I made an index to it by hand (I didn't know
> enough ruby to attempt an automated system at the time, and have not
> tackled the problem since). If someone wants to grab this for the
(Continue reading)