[ruby-core:26019] rdoc has changed...source has not

Roger Pack <[email protected]> Fri, 9 Oct 2009 20:20:59 +0900
Newsgroups gmane.comp.lang.ruby.core,gmane.comp.lang.ruby.documentation
Message-ID <[email protected]>
--0016364ec91015e00204757ec654
Content-Type: text/plain; charset=ISO-8859-1

Just as a note, it appears that the ruby core's rdocs work great with
the rdoc from 2004, but not with the latest rdoc, bundled with trunk
[2.4.3?]

For example, in BigDecimal, here's how it used to parse:

http://webri.tigerops.org/BigDecimal.html

Here's how it parses now:

http://rubydoc.ruby-forum.com/bigdecimal_rdoc_244/BigDecimal.html

(it's missing the tutorial, etc.)

I believe this is the case scattered throughout the entire ruby distro.

Might be worth a doc scrub sometime.  Anybody interested?

Here's my contribution (the big decimal class) (attached).
Cheers.
-r

--0016364ec91015e00204757ec654
Content-Type: application/octet-stream; name="big_decimal.diff"
Content-Disposition: attachment; filename="big_decimal.diff"
Content-Transfer-Encoding: base64
X-Attachment-Id: f_g0kujcjp0

SW5kZXg6IGJpZ2RlY2ltYWwuYw0KPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLS0tIGJpZ2RlY2ltYWwuYwkocmV2aXNp
b24gMjUyNzEpDQorKysgYmlnZGVjaW1hbC5jCSh3b3JraW5nIGNvcHkpDQpAQCAtNjIsMTE4ICs2
Miw2IEBADQogICovCiAjZGVmaW5lIERvU29tZU9uZSh4LHksZikgcmJfbnVtX2NvZXJjZV9iaW4o
eCx5LGYpCiAKLSNpZiAwCi0vKiBCaWdEZWNpbWFsIHByb3ZpZGVzIGFyYml0cmFyeS1wcmVjaXNp
b24gZmxvYXRpbmcgcG9pbnQgZGVjaW1hbCBhcml0aG1ldGljLgotICoKLSAqIENvcHlyaWdodCAo
QykgMjAwMiBieSBTaGlnZW8gS29iYXlhc2hpIDxzaGlnZW9AdGlueWZvcmVzdC5nci5qcD4uCi0g
KiBZb3UgbWF5IGRpc3RyaWJ1dGUgdW5kZXIgdGhlIHRlcm1zIG9mIGVpdGhlciB0aGUgR05VIEdl
bmVyYWwgUHVibGljCi0gKiBMaWNlbnNlIG9yIHRoZSBBcnRpc3RpYyBMaWNlbnNlLCBhcyBzcGVj
aWZpZWQgaW4gdGhlIFJFQURNRSBmaWxlCi0gKiBvZiB0aGUgQmlnRGVjaW1hbCBkaXN0cmlidXRp
b24uCi0gKgotICogRG9jdW1lbnRlZCBieSBtYXRoZXcgPG1ldGFAcG9ib3guY29tPi4KLSAqCi0g
KiA9IEludHJvZHVjdGlvbgotICoKLSAqIFJ1YnkgcHJvdmlkZXMgYnVpbHQtaW4gc3VwcG9ydCBm
b3IgYXJiaXRyYXJ5IHByZWNpc2lvbiBpbnRlZ2VyIGFyaXRobWV0aWMuCi0gKiBGb3IgZXhhbXBs
ZToKLSAqCi0gKiA0MioqMTMgICAtPiAgIDEyNjU0Mzc3MTg0Mzg4NjY2MjQ1MTIKLSAqCi0gKiBC
aWdEZWNpbWFsIHByb3ZpZGVzIHNpbWlsYXIgc3VwcG9ydCBmb3IgdmVyeSBsYXJnZSBvciB2ZXJ5
IGFjY3VyYXRlIGZsb2F0aW5nCi0gKiBwb2ludCBudW1iZXJzLgotICoKLSAqIERlY2ltYWwgYXJp
dGhtZXRpYyBpcyBhbHNvIHVzZWZ1bCBmb3IgZ2VuZXJhbCBjYWxjdWxhdGlvbiwgYmVjYXVzZSBp
dAotICogcHJvdmlkZXMgdGhlIGNvcnJlY3QgYW5zd2VycyBwZW9wbGUgZXhwZWN0LS13aGVyZWFz
IG5vcm1hbCBiaW5hcnkgZmxvYXRpbmcKLSAqIHBvaW50IGFyaXRobWV0aWMgb2Z0ZW4gaW50cm9k
dWNlcyBzdWJ0bGUgZXJyb3JzIGJlY2F1c2Ugb2YgdGhlIGNvbnZlcnNpb24KLSAqIGJldHdlZW4g
YmFzZSAxMCBhbmQgYmFzZSAyLiBGb3IgZXhhbXBsZSwgdHJ5OgotICoKLSAqICAgc3VtID0gMAot
ICogICBmb3IgaSBpbiAoMS4uMTAwMDApCi0gKiAgICAgc3VtID0gc3VtICsgMC4wMDAxCi0gKiAg
IGVuZAotICogICBwcmludCBzdW0KLSAqCi0gKiBhbmQgY29udHJhc3Qgd2l0aCB0aGUgb3V0cHV0
IGZyb206Ci0gKgotICogICByZXF1aXJlICdiaWdkZWNpbWFsJwotICoKLSAqICAgc3VtID0gQmln
RGVjaW1hbC5uZXcoIjAiKQotICogICBmb3IgaSBpbiAoMS4uMTAwMDApCi0gKiAgICAgc3VtID0g
c3VtICsgQmlnRGVjaW1hbC5uZXcoIjAuMDAwMSIpCi0gKiAgIGVuZAotICogICBwcmludCBzdW0K
LSAqCi0gKiBTaW1pbGFybHk6Ci0gKgotICogKEJpZ0RlY2ltYWwubmV3KCIxLjIiKSAtIEJpZ0Rl
Y2ltYWwoIjEuMCIpKSA9PSBCaWdEZWNpbWFsKCIwLjIiKSAtPiB0cnVlCi0gKgotICogKDEuMiAt
IDEuMCkgPT0gMC4yIC0+IGZhbHNlCi0gKgotICogPSBTcGVjaWFsIGZlYXR1cmVzIG9mIGFjY3Vy
YXRlIGRlY2ltYWwgYXJpdGhtZXRpYwotICoKLSAqIEJlY2F1c2UgQmlnRGVjaW1hbCBpcyBtb3Jl
IGFjY3VyYXRlIHRoYW4gbm9ybWFsIGJpbmFyeSBmbG9hdGluZyBwb2ludAotICogYXJpdGhtZXRp
YywgaXQgcmVxdWlyZXMgc29tZSBzcGVjaWFsIHZhbHVlcy4KLSAqCi0gKiA9PSBJbmZpbml0eQot
ICoKLSAqIEJpZ0RlY2ltYWwgc29tZXRpbWVzIG5lZWRzIHRvIHJldHVybiBpbmZpbml0eSwgZm9y
IGV4YW1wbGUgaWYgeW91IGRpdmlkZQotICogYSB2YWx1ZSBieSB6ZXJvLgotICoKLSAqIEJpZ0Rl
Y2ltYWwubmV3KCIxLjAiKSAvIEJpZ0RlY2ltYWwubmV3KCIwLjAiKSAgLT4gaW5maW5pdHkKLSAq
Ci0gKiBCaWdEZWNpbWFsLm5ldygiLTEuMCIpIC8gQmlnRGVjaW1hbC5uZXcoIjAuMCIpICAtPiAt
aW5maW5pdHkKLSAqCi0gKiBZb3UgY2FuIHJlcHJlc2VudCBpbmZpbml0ZSBudW1iZXJzIHRvIEJp
Z0RlY2ltYWwgdXNpbmcgdGhlIHN0cmluZ3MKLSAqICdJbmZpbml0eScsICcrSW5maW5pdHknIGFu
ZCAnLUluZmluaXR5JyAoY2FzZS1zZW5zaXRpdmUpCi0gKgotICogPT0gTm90IGEgTnVtYmVyCi0g
KgotICogV2hlbiBhIGNvbXB1dGF0aW9uIHJlc3VsdHMgaW4gYW4gdW5kZWZpbmVkIHZhbHVlLCB0
aGUgc3BlY2lhbCB2YWx1ZSBOYU4KLSAqIChmb3IgJ25vdCBhIG51bWJlcicpIGlzIHJldHVybmVk
LgotICoKLSAqIEV4YW1wbGU6Ci0gKgotICogQmlnRGVjaW1hbC5uZXcoIjAuMCIpIC8gQmlnRGVj
aW1hbC5uZXcoIjAuMCIpIC0+IE5hTgotICoKLSAqIFlvdSBjYW4gYWxzbyBjcmVhdGUgdW5kZWZp
bmVkIHZhbHVlcy4gIE5hTiBpcyBuZXZlciBjb25zaWRlcmVkIHRvIGJlIHRoZQotICogc2FtZSBh
cyBhbnkgb3RoZXIgdmFsdWUsIGV2ZW4gTmFOIGl0c2VsZjoKLSAqCi0gKiBuID0gQmlnRGVjaW1h
bC5uZXcoJ05hTicpCi0gKgotICogbiA9PSAwLjAgLT4gbmlsCi0gKgotICogbiA9PSBuIC0+IG5p
bAotICoKLSAqID09IFBvc2l0aXZlIGFuZCBuZWdhdGl2ZSB6ZXJvCi0gKgotICogSWYgYSBjb21w
dXRhdGlvbiByZXN1bHRzIGluIGEgdmFsdWUgd2hpY2ggaXMgdG9vIHNtYWxsIHRvIGJlIHJlcHJl
c2VudGVkIGFzCi0gKiBhIEJpZ0RlY2ltYWwgd2l0aGluIHRoZSBjdXJyZW50bHkgc3BlY2lmaWVk
IGxpbWl0cyBvZiBwcmVjaXNpb24sIHplcm8gbXVzdAotICogYmUgcmV0dXJuZWQuCi0gKgotICog
SWYgdGhlIHZhbHVlIHdoaWNoIGlzIHRvbyBzbWFsbCB0byBiZSByZXByZXNlbnRlZCBpcyBuZWdh
dGl2ZSwgYSBCaWdEZWNpbWFsCi0gKiB2YWx1ZSBvZiBuZWdhdGl2ZSB6ZXJvIGlzIHJldHVybmVk
LiBJZiB0aGUgdmFsdWUgaXMgcG9zaXRpdmUsIGEgdmFsdWUgb2YKLSAqIHBvc2l0aXZlIHplcm8g
aXMgcmV0dXJuZWQuCi0gKgotICogQmlnRGVjaW1hbC5uZXcoIjEuMCIpIC8gQmlnRGVjaW1hbC5u
ZXcoIi1JbmZpbml0eSIpIC0+IC0wLjAKLSAqCi0gKiBCaWdEZWNpbWFsLm5ldygiMS4wIikgLyBC
aWdEZWNpbWFsLm5ldygiSW5maW5pdHkiKSAtPiAwLjAKLSAqCi0gKiAoU2VlIEJpZ0RlY2ltYWwu
bW9kZSBmb3IgaG93IHRvIHNwZWNpZnkgbGltaXRzIG9mIHByZWNpc2lvbi4pCi0gKgotICogTm90
ZSB0aGF0IC0wLjAgYW5kIDAuMCBhcmUgY29uc2lkZXJlZCB0byBiZSB0aGUgc2FtZSBmb3IgdGhl
IHB1cnBvc2VzIG9mCi0gKiBjb21wYXJpc29uLgotICoKLSAqIE5vdGUgYWxzbyB0aGF0IGluIG1h
dGhlbWF0aWNzLCB0aGVyZSBpcyBubyBwYXJ0aWN1bGFyIGNvbmNlcHQgb2YgbmVnYXRpdmUgCi0g
KiBvciBwb3NpdGl2ZSB6ZXJvOyB0cnVlIG1hdGhlbWF0aWNhbCB6ZXJvIGhhcyBubyBzaWduLgot
ICovCi12b2lkCi1Jbml0X0JpZ0RlY2ltYWwoKQotewotICAgIC8qIFRoaXMgaXMgYSAjaWYtZWQg
b3V0IGZ1bmN0aW9uIHRvIGZvb2wgUmRvYyBpbnRvIGRvY3VtZW50aW5nIHRoZSBjbGFzcy4gKi8K
LSAgICAvKiBUaGUgcmVhbCBpbml0IGZ1bmN0aW9uIGlzIEluaXRfYmlnZGVjaW1hbCgpIGZ1cnRo
ZXIgZG93bi4gKi8KLX0KLSNlbmRpZgotCiAvKgogICogUmV0dXJucyB0aGUgQmlnRGVjaW1hbCB2
ZXJzaW9uIG51bWJlci4KICAqCkBAIC0xOTA1LDYgKzE3OTMsMTEwIEBADQogICAgIHJldHVybiBJ
TlQyRklYKHMpOwogfQogCisvKiBEb2N1bWVudC1jbGFzczogQmlnRGVjaW1hbAorICogQmlnRGVj
aW1hbCBwcm92aWRlcyBhcmJpdHJhcnktcHJlY2lzaW9uIGZsb2F0aW5nIHBvaW50IGRlY2ltYWwg
YXJpdGhtZXRpYy4KKyAqCisgKiBDb3B5cmlnaHQgKEMpIDIwMDIgYnkgU2hpZ2VvIEtvYmF5YXNo
aSA8c2hpZ2VvQHRpbnlmb3Jlc3QuZ3IuanA+LgorICogWW91IG1heSBkaXN0cmlidXRlIHVuZGVy
IHRoZSB0ZXJtcyBvZiBlaXRoZXIgdGhlIEdOVSBHZW5lcmFsIFB1YmxpYworICogTGljZW5zZSBv
ciB0aGUgQXJ0aXN0aWMgTGljZW5zZSwgYXMgc3BlY2lmaWVkIGluIHRoZSBSRUFETUUgZmlsZQor
ICogb2YgdGhlIEJpZ0RlY2ltYWwgZGlzdHJpYnV0aW9uLgorICoKKyAqIERvY3VtZW50ZWQgYnkg
bWF0aGV3IDxtZXRhQHBvYm94LmNvbT4uCisgKgorICogPSBJbnRyb2R1Y3Rpb24KKyAqCisgKiBS
dWJ5IHByb3ZpZGVzIGJ1aWx0LWluIHN1cHBvcnQgZm9yIGFyYml0cmFyeSBwcmVjaXNpb24gaW50
ZWdlciBhcml0aG1ldGljLgorICogRm9yIGV4YW1wbGU6CisgKgorICogNDIqKjEzICAgLT4gICAx
MjY1NDM3NzE4NDM4ODY2NjI0NTEyCisgKgorICogQmlnRGVjaW1hbCBwcm92aWRlcyBzaW1pbGFy
IHN1cHBvcnQgZm9yIHZlcnkgbGFyZ2Ugb3IgdmVyeSBhY2N1cmF0ZSBmbG9hdGluZworICogcG9p
bnQgbnVtYmVycy4KKyAqCisgKiBEZWNpbWFsIGFyaXRobWV0aWMgaXMgYWxzbyB1c2VmdWwgZm9y
IGdlbmVyYWwgY2FsY3VsYXRpb24sIGJlY2F1c2UgaXQKKyAqIHByb3ZpZGVzIHRoZSBjb3JyZWN0
IGFuc3dlcnMgcGVvcGxlIGV4cGVjdC0td2hlcmVhcyBub3JtYWwgYmluYXJ5IGZsb2F0aW5nCisg
KiBwb2ludCBhcml0aG1ldGljIG9mdGVuIGludHJvZHVjZXMgc3VidGxlIGVycm9ycyBiZWNhdXNl
IG9mIHRoZSBjb252ZXJzaW9uCisgKiBiZXR3ZWVuIGJhc2UgMTAgYW5kIGJhc2UgMi4gRm9yIGV4
YW1wbGUsIHRyeToKKyAqCisgKiAgIHN1bSA9IDAKKyAqICAgZm9yIGkgaW4gKDEuLjEwMDAwKQor
ICogICAgIHN1bSA9IHN1bSArIDAuMDAwMQorICogICBlbmQKKyAqICAgcHJpbnQgc3VtCisgKgor
ICogYW5kIGNvbnRyYXN0IHdpdGggdGhlIG91dHB1dCBmcm9tOgorICoKKyAqICAgcmVxdWlyZSAn
YmlnZGVjaW1hbCcKKyAqCisgKiAgIHN1bSA9IEJpZ0RlY2ltYWwubmV3KCIwIikKKyAqICAgZm9y
IGkgaW4gKDEuLjEwMDAwKQorICogICAgIHN1bSA9IHN1bSArIEJpZ0RlY2ltYWwubmV3KCIwLjAw
MDEiKQorICogICBlbmQKKyAqICAgcHJpbnQgc3VtCisgKgorICogU2ltaWxhcmx5OgorICoKKyAq
IChCaWdEZWNpbWFsLm5ldygiMS4yIikgLSBCaWdEZWNpbWFsKCIxLjAiKSkgPT0gQmlnRGVjaW1h
bCgiMC4yIikgLT4gdHJ1ZQorICoKKyAqICgxLjIgLSAxLjApID09IDAuMiAtPiBmYWxzZQorICoK
KyAqID0gU3BlY2lhbCBmZWF0dXJlcyBvZiBhY2N1cmF0ZSBkZWNpbWFsIGFyaXRobWV0aWMKKyAq
CisgKiBCZWNhdXNlIEJpZ0RlY2ltYWwgaXMgbW9yZSBhY2N1cmF0ZSB0aGFuIG5vcm1hbCBiaW5h
cnkgZmxvYXRpbmcgcG9pbnQKKyAqIGFyaXRobWV0aWMsIGl0IHJlcXVpcmVzIHNvbWUgc3BlY2lh
bCB2YWx1ZXMuCisgKgorICogPT0gSW5maW5pdHkKKyAqCisgKiBCaWdEZWNpbWFsIHNvbWV0aW1l
cyBuZWVkcyB0byByZXR1cm4gaW5maW5pdHksIGZvciBleGFtcGxlIGlmIHlvdSBkaXZpZGUKKyAq
IGEgdmFsdWUgYnkgemVyby4KKyAqCisgKiBCaWdEZWNpbWFsLm5ldygiMS4wIikgLyBCaWdEZWNp
bWFsLm5ldygiMC4wIikgIC0+IGluZmluaXR5CisgKgorICogQmlnRGVjaW1hbC5uZXcoIi0xLjAi
KSAvIEJpZ0RlY2ltYWwubmV3KCIwLjAiKSAgLT4gLWluZmluaXR5CisgKgorICogWW91IGNhbiBy
ZXByZXNlbnQgaW5maW5pdGUgbnVtYmVycyB0byBCaWdEZWNpbWFsIHVzaW5nIHRoZSBzdHJpbmdz
CisgKiAnSW5maW5pdHknLCAnK0luZmluaXR5JyBhbmQgJy1JbmZpbml0eScgKGNhc2Utc2Vuc2l0
aXZlKQorICoKKyAqID09IE5vdCBhIE51bWJlcgorICoKKyAqIFdoZW4gYSBjb21wdXRhdGlvbiBy
ZXN1bHRzIGluIGFuIHVuZGVmaW5lZCB2YWx1ZSwgdGhlIHNwZWNpYWwgdmFsdWUgTmFOCisgKiAo
Zm9yICdub3QgYSBudW1iZXInKSBpcyByZXR1cm5lZC4KKyAqCisgKiBFeGFtcGxlOgorICoKKyAq
IEJpZ0RlY2ltYWwubmV3KCIwLjAiKSAvIEJpZ0RlY2ltYWwubmV3KCIwLjAiKSAtPiBOYU4KKyAq
CisgKiBZb3UgY2FuIGFsc28gY3JlYXRlIHVuZGVmaW5lZCB2YWx1ZXMuICBOYU4gaXMgbmV2ZXIg
Y29uc2lkZXJlZCB0byBiZSB0aGUKKyAqIHNhbWUgYXMgYW55IG90aGVyIHZhbHVlLCBldmVuIE5h
TiBpdHNlbGY6CisgKgorICogbiA9IEJpZ0RlY2ltYWwubmV3KCdOYU4nKQorICoKKyAqIG4gPT0g
MC4wIC0+IG5pbAorICoKKyAqIG4gPT0gbiAtPiBuaWwKKyAqCisgKiA9PSBQb3NpdGl2ZSBhbmQg
bmVnYXRpdmUgemVybworICoKKyAqIElmIGEgY29tcHV0YXRpb24gcmVzdWx0cyBpbiBhIHZhbHVl
IHdoaWNoIGlzIHRvbyBzbWFsbCB0byBiZSByZXByZXNlbnRlZCBhcworICogYSBCaWdEZWNpbWFs
IHdpdGhpbiB0aGUgY3VycmVudGx5IHNwZWNpZmllZCBsaW1pdHMgb2YgcHJlY2lzaW9uLCB6ZXJv
IG11c3QKKyAqIGJlIHJldHVybmVkLgorICoKKyAqIElmIHRoZSB2YWx1ZSB3aGljaCBpcyB0b28g
c21hbGwgdG8gYmUgcmVwcmVzZW50ZWQgaXMgbmVnYXRpdmUsIGEgQmlnRGVjaW1hbAorICogdmFs
dWUgb2YgbmVnYXRpdmUgemVybyBpcyByZXR1cm5lZC4gSWYgdGhlIHZhbHVlIGlzIHBvc2l0aXZl
LCBhIHZhbHVlIG9mCisgKiBwb3NpdGl2ZSB6ZXJvIGlzIHJldHVybmVkLgorICoKKyAqIEJpZ0Rl
Y2ltYWwubmV3KCIxLjAiKSAvIEJpZ0RlY2ltYWwubmV3KCItSW5maW5pdHkiKSAtPiAtMC4wCisg
KgorICogQmlnRGVjaW1hbC5uZXcoIjEuMCIpIC8gQmlnRGVjaW1hbC5uZXcoIkluZmluaXR5Iikg
LT4gMC4wCisgKgorICogKFNlZSBCaWdEZWNpbWFsLm1vZGUgZm9yIGhvdyB0byBzcGVjaWZ5IGxp
bWl0cyBvZiBwcmVjaXNpb24uKQorICoKKyAqIE5vdGUgdGhhdCAtMC4wIGFuZCAwLjAgYXJlIGNv
bnNpZGVyZWQgdG8gYmUgdGhlIHNhbWUgZm9yIHRoZSBwdXJwb3NlcyBvZgorICogY29tcGFyaXNv
bi4KKyAqCisgKiBOb3RlIGFsc28gdGhhdCBpbiBtYXRoZW1hdGljcywgdGhlcmUgaXMgbm8gcGFy
dGljdWxhciBjb25jZXB0IG9mIG5lZ2F0aXZlIAorICogb3IgcG9zaXRpdmUgemVybzsgdHJ1ZSBt
YXRoZW1hdGljYWwgemVybyBoYXMgbm8gc2lnbi4KKyAqLwogdm9pZAogSW5pdF9iaWdkZWNpbWFs
KHZvaWQpCiB7Cg==
--0016364ec91015e00204757ec654--