ri and extensions

[Brian Candler]

I have ruby-1.8.2p2 installed, and as I'm trying to wean myself off grepping
through the Pickaxe V1 whenever I want to find information, I'm trying to
convert to using 'ri'

However, it seems that nothing from the ext/ subdirectories of Ruby has made
it into my ri collection:

$ ri Zlib
Nothing known about Zlib
$ ri Iconv
Nothing known about Iconv

even though grepping the source seems to show that three ext modules have
been marked up for rdoc:

ext/iconv/iconv.c: * call-seq: Iconv.new(to, from)
ext/strscan/strscan.c: * call-seq: StringScanner.new(string, dup = false)
ext/zlib/zlib.c: * call-seq: Zlib.adler32(string, adler)

Is this a bug in the configure/install process?

However, given that the rest of the ext/ directories have not been marked
up, especially ext/socket, then it looks like I will be grepping Pickaxe V1
for some time to come anyway

Regards,

Brian.

 

[Dave Thomas]

However, it seems that nothing from the ext/ subdirectories of Ruby
has made
it into my ri collection:

$ ri Zlib
Nothing known about Zlib
$ ri Iconv
Nothing known about Iconv

Whoever marked them up probably forgot to add their names to the
document file, so they weren't included.


Cheers

Dave

 

[Brian Candler]

--RnlQjJ0d97Da+TV1
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Whoever marked them up probably forgot to add their names to the
.document file, so they weren't included.

$ find . -name '*.document'
/.document
/lib/.document
/lib/cgi/.document
$

OK. I've stuck what I think are the necessary files into the attached
tarball. Do they look right to you? If so perhaps they can be committed.

Cheers,

Brian.

--RnlQjJ0d97Da+TV1
Content-Type: application/x-tar-gz
Content-Disposition: attachment; filename="rdoc.tgz"
Content-Transfer-Encoding: base64

H4sIANvpY0EAA+2XXU7jMBCA++xTjMQLrLTFzu8B4AAIcQHXGYilYCPbbemefsdpoTxtpJWS
atn5HhopM544sr+Ju+682b6iS6v5kErKpqpWUkrV1urrdaQqypWSqpRtU9V1SfmqoQvIGef0
yTYmHQBWm2C1+0PeVPwf5Qqeehvh2Q4IHSYMr9ZhhH1vTT/ejWAdpB7FFTxuNwfoLQYdTH+A
vR0G2CC8BW8wRuyAwpQJj/feUHryfqBC6MAmoGe82B2OpSjy9nPAHQ7Q2YAm+XCgfB1BO9Dh
ZdyPgu48HCuDpgflcXcQ/TYYPE5M/FibnJUjg93cnovB9XH+PZW0KYLfO1h/bPRx8I2gEXlw
Z1Py8OwD4Hu6FfQjLr0ki5Lfej1zD5jyXyl59r+UlF9UZcv+L0H2HyOSdjiKRPsBXbTeffSA
Xu+oM5w2iE4UEcIa73YiphCNduJXVunS78H8Hdn/cTln7AJT/ssv/jdFS/ll3fD3fxHGtafv
6KXnwVyG7P+pkc/WAab9L87+Vw3lV6qo2f8lOK09d4D/lOx/PsDN+Sdg0n/Znv1v8vm/rOhI
wP4vQF57lp9hGIZhGIZhGIZhGIZhGOb78RsCPqG7ACgAAA==

--RnlQjJ0d97Da+TV1--