Bug #4091: Ruby man page
http://redmine.ruby-lang.org/issues/show/4091

Author: Arthur Gunn
Status: Open, Priority: Normal
Category: DOC, Target version: 1.9.x
ruby -v: 1.9

I installed 1.9.2 recently and was reading through its man page. It seems=
 to be a little out of date and contains some miss-spellings and awkward =
english.

I've attached a patch (also available at https://github.com/gunn/ruby/com=
mit/cabe4be ) with some of the most obvious fixes.
I think more can be done to make the text read more naturally, but I thou=
ght it would be good to see what people thought of the more straightforwa=
rd changes first.

There were also some things I wasn't sure about updating:
The date is currently 'October 25, 2008', is there a policy for updating =
this?
http://raa.ruby-lang.org is mentioned. Is this still considered current? =
The last news update was from 2005. Surely http://rubygems.org is at leas=
t as deserving of a mention?

Thanks!


----------------------------------------
http://redmine.ruby-lang.org
RnJvbSBjYWJlNGJlNjZiNTYzOGRhMDQ2MTUwYjYyYjg2MGU1MjY1NGRiNmQ4
IE1vbiBTZXAgMTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBBcnRodXIgR3VubiA8
YXJ0aHVyQGd1bm4uY28ubno+CkRhdGU6IFNhdCwgMjcgTm92IDIwMTAgMTM6
MjM6MDIgKzEzMDAKU3ViamVjdDogW1BBVENIXSBFZGl0ZWQgdGhlIHRleHQg
b2YgUnVieSdzIG1hbiBwYWdlIHRvIGNvcnJlY3Qgc3BlbGxpbmcgYW5kIGdy
YW1tYXIsIGFuZCBpbXByb3ZlIGNsYXJpdHkuCgotLS0KIG1hbi9ydWJ5LjEg
fCAgIDI2ICsrKysrKysrKysrKystLS0tLS0tLS0tLS0tCiAxIGZpbGVzIGNo
YW5nZWQsIDEzIGluc2VydGlvbnMoKyksIDEzIGRlbGV0aW9ucygtKQoKZGlm
ZiAtLWdpdCBhL21hbi9ydWJ5LjEgYi9tYW4vcnVieS4xCmluZGV4IDlhYzIz
MjQuLjJkM2Y2MzMgMTAwNjQ0Ci0tLSBhL21hbi9ydWJ5LjEKKysrIGIvbWFu
L3J1YnkuMQpAQCAtMzcsNyArMzcsNyBAQCBzdHJhaWdodC1mb3J3YXJkLCBh
bmQgZXh0ZW5zaWJsZS4KIC5QcAogSWYgeW91IHdhbnQgYSBsYW5ndWFnZSBm
b3IgZWFzeSBvYmplY3Qtb3JpZW50ZWQgcHJvZ3JhbW1pbmcsIG9yIHlvdQog
ZG9uJ3QgbGlrZSB0aGUgUGVybCB1Z2xpbmVzcywgb3IgeW91IGRvIGxpa2Ug
dGhlIGNvbmNlcHQgb2YgTElTUCwgYnV0Ci1kb24ndCBsaWtlIHRvbyBtdWNo
IHBhcmVudGhlc2VzLCBSdWJ5IG1heSBiZSB0aGUgbGFuZ3VhZ2Ugb2YgeW91
cgorZG9uJ3QgbGlrZSB0b28gbWFueSBwYXJlbnRoZXNlcywgUnVieSBtaWdo
dCBiZSB5b3VyIGxhbmd1YWdlIG9mCiBjaG9pY2UuCiAuU2ggRkVBVFVSRVMK
IFJ1YnkncyBmZWF0dXJlcyBhcmUgYXMgZm9sbG93czoKQEAgLTUzLDcgKzUz
LDcgQEAgdGltZSBjaGVjay4KIC5QcAogLkl0IFN5ICJObyBkZWNsYXJhdGlv
biBuZWVkZWQiCiBZb3UgY2FuIHVzZSB2YXJpYWJsZXMgaW4geW91ciBSdWJ5
IHByb2dyYW1zIHdpdGhvdXQgYW55IGRlY2xhcmF0aW9ucy4KLVZhcmlhYmxl
IG5hbWVzIGRlbm90ZSB0aGVpciBzY29wZSwgbG9jYWwsIGdsb2JhbCwgaW5z
dGFuY2UsIGV0Yy4KK1ZhcmlhYmxlIG5hbWVzIGRlbm90ZSB0aGVpciBzY29w
ZSAtIGdsb2JhbCwgY2xhc3MsIGluc3RhbmNlLCBvciBsb2NhbC4KIC5QcAog
Lkl0IFN5ICJTaW1wbGUgc3ludGF4IgogUnVieSBoYXMgYSBzaW1wbGUgc3lu
dGF4IGluZmx1ZW5jZWQgc2xpZ2h0bHkgZnJvbSBFaWZmZWwuCkBAIC02NCwx
MSArNjQsMTEgQEAgZnJvbSBhbnl3aGVyZSBhcmUgYXV0b21hdGljYWxseSBj
b2xsZWN0ZWQgYnkgdGhlIGdhcmJhZ2UgY29sbGVjdG9yCiBidWlsdCBpbnRv
IHRoZSBpbnRlcnByZXRlci4KIC5QcAogLkl0IFN5ICJFdmVyeXRoaW5nIGlz
IGFuIG9iamVjdCIKLVJ1YnkgaXMgdGhlIHB1cmVseSBvYmplY3Qtb3JpZW50
ZWQgbGFuZ3VhZ2UsIGFuZCB3YXMgc28gc2luY2UgaXRzCitSdWJ5IGlzIGEg
cHVyZWx5IG9iamVjdC1vcmllbnRlZCBsYW5ndWFnZSwgYW5kIHdhcyBzbyBz
aW5jZSBpdHMKIGNyZWF0aW9uLiAgRXZlbiBzdWNoIGJhc2ljIGRhdGEgYXMg
aW50ZWdlcnMgYXJlIHNlZW4gYXMgb2JqZWN0cy4KIC5QcAogLkl0IFN5ICJD
bGFzcywgaW5oZXJpdGFuY2UsIGFuZCBtZXRob2RzIgotT2YgY291cnNlLCBh
cyBhbiBvYmplY3Qtb3JpZW50ZWQgbGFuZ3VhZ2UsIFJ1YnkgaGFzIHN1Y2gg
YmFzaWMKK0JlaW5nIGFuIG9iamVjdC1vcmllbnRlZCBsYW5ndWFnZSwgUnVi
eSBuYXR1cmFsbHkgaGFzIGJhc2ljCiBmZWF0dXJlcyBsaWtlIGNsYXNzZXMs
IGluaGVyaXRhbmNlLCBhbmQgbWV0aG9kcy4KIC5QcAogLkl0IFN5ICJTaW5n
bGV0b24gbWV0aG9kcyIKQEAgLTgxLDcgKzgxLDcgQEAgdG8uCiAuSXQgU3kg
Ik1peC1pbiBieSBtb2R1bGVzIgogUnVieSBpbnRlbnRpb25hbGx5IGRvZXMg
bm90IGhhdmUgdGhlIG11bHRpcGxlIGluaGVyaXRhbmNlIGFzIGl0IGlzIGEK
IHNvdXJjZSBvZiBjb25mdXNpb24uICBJbnN0ZWFkLCBSdWJ5IGhhcyB0aGUg
YWJpbGl0eSB0byBzaGFyZQotaW1wbGVtZW50YXRpb25zIGFjcm9zcyB0aGUg
aW5oZXJpdGFuY2UgdHJlZS4gIFRoaXMgaXMgb2Z0ZW4gY2FsbGVkCitpbXBs
ZW1lbnRhdGlvbnMgYWNyb3NzIHRoZSBpbmhlcml0YW5jZSB0cmVlLiAgVGhp
cyBpcyBvZnRlbiBjYWxsZWQgYQogLlNxIE1peC1pbiAuCiAuUHAKIC5JdCBT
eSAiSXRlcmF0b3JzIgpAQCAtOTAsNyArOTAsNyBAQCBSdWJ5IGhhcyBpdGVy
YXRvcnMgZm9yIGxvb3AgYWJzdHJhY3Rpb24uCiAuSXQgU3kgIkNsb3N1cmVz
IgogSW4gUnVieSwgeW91IGNhbiBvYmplY3RpZnkgdGhlIHByb2NlZHVyZS4K
IC5QcAotLkl0IFN5ICJUZXh0IHByb2Nlc3NpbmcgYW5kIHJlZ3VsYXIgZXhw
cmVzc2lvbiIKKy5JdCBTeSAiVGV4dCBwcm9jZXNzaW5nIGFuZCByZWd1bGFy
IGV4cHJlc3Npb25zIgogUnVieSBoYXMgYSBidW5jaCBvZiB0ZXh0IHByb2Nl
c3NpbmcgZmVhdHVyZXMgbGlrZSBpbiBQZXJsLgogLlBwCiAuSXQgU3kgIk0x
N04sIGNoYXJhY3RlciBzZXQgaW5kZXBlbmRlbnQiCkBAIC0xMDIsOCArMTAy
LDggQEAgZGlmZmVyZW50IGNoYXJhY3RlciBlbmNvZGluZ3MsIHdpdGhvdXQg
ZGVwZW5kZW5jZSBvbiBVbmljb2RlLgogV2l0aCBidWlsdC1pbiBiaWdudW1z
LCB5b3UgY2FuIGZvciBleGFtcGxlIGNhbGN1bGF0ZSBmYWN0b3JpYWwoNDAw
KS4KIC5QcAogLkl0IFN5ICJSZWZsZWN0aW9uIGFuZCBkb21haW4gc3BlY2lm
aWMgbGFuZ3VhZ2VzIgotQ2xhc3MgaXMgYWxzbyBhbiBpbnN0YW5jZSBvZiBD
bGFzcyBjbGFzcy4gRGVmaW5pdGlvbiBvZiBjbGFzc2VzIGFuZCBtZXRob2Rz
Ci1pcyBqdXN0IGFuIGV4cHJlc3Npb24gYXMgMSsxIGlzLiBTbyB5b3VyIHBy
b2dyYW1zIGNhbiBldmVuIHdyaXRlIGFuZCBtb2RpZnkgcHJvZ3JhbXMuCitD
bGFzcyBpcyBhbHNvIGFuIGluc3RhbmNlIG9mIHRoZSBDbGFzcyBjbGFzcy4g
RGVmaW5pdGlvbiBvZiBjbGFzc2VzIGFuZCBtZXRob2RzCitpcyBhbiBleHBy
ZXNzaW9uIGp1c3QgYXMgMSsxIGlzLiBTbyB5b3VyIHByb2dyYW1zIGNhbiBl
dmVuIHdyaXRlIGFuZCBtb2RpZnkgcHJvZ3JhbXMuCiBUaHVzIHlvdSBjYW4g
d3JpdGUgeW91ciBhcHBsaWNhdGlvbiBpbiB5b3VyIG93biBwcm9ncmFtbWlu
ZyBsYW5ndWFnZSBvbiB0b3Agb2YgUnVieS4KIC5QcAogLkl0IFN5ICJFeGNl
cHRpb24gaGFuZGxpbmciCkBAIC0yMDksNyArMjA5LDcgQEAgb24gbWFjaGlu
ZXMgdGhhdCBkb24ndCBzdXBwb3J0IGl0LCBpbiB0aGUgZm9sbG93aW5nIG1h
bm5lcjoKIFR1cm5zIG9uIHRhaW50IGNoZWNrcyBhdCB0aGUgc3BlY2lmaWVk
IGxldmVsIChkZWZhdWx0IDEpLgogLlBwCiAuSXQgRmwgVQotU2V0cyB0aGUg
ZGVmYWx1dCB2YWx1ZSBmb3IgaW50ZXJuYWwgZW5jb2RpbmdzCitTZXRzIHRo
ZSBkZWZhdWx0IHZhbHVlIGZvciBpbnRlcm5hbCBlbmNvZGluZ3MKIC5QZiAo
IExpICJFbmNvZGluZy5kZWZhdWx0X2ludGVybmFsIiApIHRvIFVURi04Lgog
LlBwCiAuSXQgRmwgVyBOcyBPcCBBciBsZXZlbD0yCkBAIC0yNTksNyArMjU5
LDcgQEAgd2lsbCBiZSBzZXQgdG8gdHJ1ZS4KIC5QcAogLkl0IEZsIGUgQXIg
Y29tbWFuZAogU3BlY2lmaWVzIHNjcmlwdCBmcm9tIGNvbW1hbmQtbGluZSB3
aGlsZSB0ZWxsaW5nIFJ1Ynkgbm90IHRvIHNlYXJjaAotdGhlIHJlc3Qgb2Yg
YXJndW1lbnRzIGZvciBhIHNjcmlwdCBmaWxlIG5hbWUuCit0aGUgcmVzdCBv
ZiB0aGUgYXJndW1lbnRzIGZvciBhIHNjcmlwdCBmaWxlIG5hbWUuCiAuUHAK
IC5JdCBGbCBoCiAuSXQgRmwgLWhlbHAKQEAgLTM2Nyw3ICszNjcsNyBAQCBt
dXN0IGJlIHNwZWNpZmllZCB3aXRoIGVpdGhlcgogLkxpIEVPRiAsCiAuTGkg
Il5EIiAoIExpICJjb250cm9sLUQiICkgLAogLkxpICJeWiIgKCBMaSAiY29u
dHJvbC1aIiApICwKLW9yIHJlc2VydmVkIHdvcmQKK29yIHRoZSByZXNlcnZl
ZCB3b3JkCiAuTGkgX19FTkRfXyAuCiBJZiB0aGUgZGlyZWN0b3J5IG5hbWUg
aXMgc3BlY2lmaWVkLCBSdWJ5IHdpbGwgc3dpdGNoIHRvIHRoYXQgZGlyZWN0
b3J5CiBiZWZvcmUgZXhlY3V0aW5nIHNjcmlwdC4KQEAgLTQ3NCw3ICs0NzQs
NyBAQCBlbnZpcm9ubWVudCB2YXJpYWJsZSBvbiBjYWxsaW5nIEtlcm5lbCNz
eXN0ZW0uCiBUaGlzIHZhcmlhYmxlIGlzIG9ic29sZXRlLgogLkVsCiAuUHAK
LUFuZCBSdWJ5IGRlcGVuZHMgb24gc29tZSBSdWJ5R2VtcyByZWxhdGVkIGVu
dmlyb25tZW50IHZhcmlhYmxlcyB1bmxlc3MgZGlzYWJsZWQgUnVieUdlbXMu
CitBbmQgUnVieSBkZXBlbmRzIG9uIHNvbWUgUnVieUdlbXMgcmVsYXRlZCBl
bnZpcm9ubWVudCB2YXJpYWJsZXMgdW5sZXNzIFJ1YnlHZW1zIGlzIGRpc2Fi
bGVkLgogU2VlIHRoZSBoZWxwIG9mCiAuWHIgZ2VtIDEKIGFzIGJlbGxvdy4K
QEAgLTQ5Nyw3ICs0OTcsNyBAQCBSdWJ5IEFwcGxpY2F0aW9uIEFyY2hpdmUu
CiAuTGkgU2VjdXJpdHkgdnVsbmVyYWJpbGl0aWVzIHNob3VsZCBiZSByZXBv
cnRlZCB2aWEgYW4gZW1haWwgdG8KIC5BcSBzZWN1cml0eUBydWJ5LWxhbmcu
b3JnIE5zCiAuTGkgLgotUmVwb3J0ZWQgcHJvYmxlbXMgd2lsbCBiZSBwdWJs
aXNoZWQgYWZ0ZXIgZml4ZWQuCitSZXBvcnRlZCBwcm9ibGVtcyB3aWxsIGJl
IHB1Ymxpc2hlZCBhZnRlciB0aGV5J3ZlIGJlZW4gZml4ZWQuCiAuUHAKIC5M
aSBBbmQgeW91IGNhbiByZXBvcnQgb3RoZXIgYnVncyBhbmQgZmVhdHVyZSBy
ZXF1ZXN0cyB2aWEgdGhlCiBSdWJ5IElzc3VlIFRyYWNraW5nIFN5c3RlbSAo
aHR0cDovL3JlZG1pbmUucnVieS1sYW5nLm9yZykuCi0tIAoxLjcuMi4zK0dp
dFg=