From: Daniel Berger Date: 2006-07-09T03:11:44+09:00 Subject: [PATCH] Some rdoc for mkmf --0-264968080-1152382300=:80219 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Content-Id: Content-Disposition: inline Hi, Attached is an rdoc patch for what I believe are the most used methods of mkmf. They include docs for: check_sizeof create_makefile dir_config find_header find_library have_func have_header have_library have_macro have_struct_member have_type have_var Please take a look at see if you think they are correct and written clearly enough. Also, I was wondering if we could get the have_const method added in, as per Nobu's patch in ruby-core:4426. Regards, Dan __________________________________________________ Do You Yahoo!? Tired of spam? Yahoo! Mail has the best spam protection around http://mail.yahoo.com --0-264968080-1152382300=:80219 Content-Type: application/octet-stream; name="mkmf.diff" Content-Transfer-Encoding: base64 Content-Description: 1792896259-mkmf.diff Content-Disposition: attachment; filename="mkmf.diff" LS0tIG1rbWYub3JpZwlGcmkgSnVuIDAyIDAyOjE2OjQ0IDIwMDYNCisrKyBt a21mLnJiCVNhdCBKdWwgMDggMDk6MTU6MzkgMjAwNg0KQEAgLTU0Nyw2ICs1 NDcsMTEgQEANCiAgIHINCiBlbmQNCiANCisjIFJldHVybnMgd2hldGhlciBv ciBub3QgK21hY3JvKyBpcyBkZWZpbmVkIGVpdGhlciBpbiB0aGUgY29tbW9u IGhlYWRlcg0KKyMgZmlsZXMgb3Igd2l0aGluIGFueSAraGVhZGVycysgeW91 IHByb3ZpZGUuDQorIw0KKyMgQW55IG9wdGlvbnMgeW91IHBhc3MgdG8gK29w dCsgYXJlIHBhc3NlZCBhbG9uZyB0byB0aGUgY29tcGlsZXIuDQorIw0KIGRl ZiBoYXZlX21hY3JvKG1hY3JvLCBoZWFkZXJzID0gbmlsLCBvcHQgPSAiIiwg JmIpDQogICBtID0gIiN7bWFjcm99Ig0KICAgbSA8PCAiIGluICN7aGVhZGVy cy5pbnNwZWN0fSIgaWYgaGVhZGVycw0KQEAgLTU1NSw2ICs1NjAsMTQgQEAN CiAgIGVuZA0KIGVuZA0KIA0KKyMgUmV0dXJucyB3aGV0aGVyIG9yIG5vdCB0 aGUgZ2l2ZW4gZW50cnkgcG9pbnQgK2Z1bmMrIGNhbiBiZSBmb3VuZCB3aXRo aW4NCisjICtsaWIrLiAgSWYgK2Z1bmMrIGlzIG5pbCwgdGhlICdtYWluKCkn IGVudHJ5IHBvaW50IGlzIHVzZWQgYnkgZGVmYXVsdC4NCisjIElmIGZvdW5k LCBpdCBhZGRzIHRoZSBsaWJyYXJ5IHRvIGxpc3Qgb2YgbGlicmFyaWVzIHRv IGJlIHVzZWQgd2hlbiBsaW5raW5nDQorIyB5b3VyIGV4dGVuc2lvbi4NCisj DQorIyBJZiAraGVhZGVyKyBpcyBwcm92aWRlZCwgaXQgd2lsbCBpbmNsdWRl IHRoYXQgaGVhZGVyIGZpbGUgYXMgb25lIG9mIHRoZQ0KKyMgaGVhZGVyIGZp bGVzIGl0IGxvb2tzIGluIHdoZW4gc2VhcmNoaW5nIGZvciArZnVuYysuDQor Iw0KIGRlZiBoYXZlX2xpYnJhcnkobGliLCBmdW5jID0gbmlsLCBoZWFkZXI9 bmlsLCAmYikNCiAgIGZ1bmMgPSAibWFpbiIgaWYgIWZ1bmMgb3IgZnVuYy5l bXB0eT8NCiAgIGxpYiA9IHdpdGhfY29uZmlnKGxpYisnbGliJywgbGliKQ0K QEAgLTU3Myw2ICs1ODYsMTMgQEANCiAgIGVuZA0KIGVuZA0KIA0KKyMgUmV0 dXJucyB3aGV0aGVyIG9yIG5vdCB0aGUgZW50cnkgcG9pbnQgK2Z1bmMrIGNh biBiZSBmb3VuZCB3aXRoaW4gdGhlIGxpYnJhcnkNCisjICtsaWIrIGluIG9u ZSBvZiB0aGUgK3BhdGhzKyBzcGVjaWZpZWQsIHdoZXJlICtwYXRocysgaXMg YW4gYXJyYXkgb2Ygc3RyaW5ncy4NCisjIElmICtmdW5jKyBpcyBuaWwgLCB0 aGVuIHRoZSBtYWluKCkgZnVuY3Rpb24gaXMgdXNlZCBhcyB0aGUgZW50cnkg cG9pbnQuDQorIw0KKyMgSWYgK2xpYisgaXMgZm91bmQsIHRoZW4gdGhlIHBh dGggaXQgd2FzIGZvdW5kIG9uIGlzIGFkZGVkIHRvIHRoZSBsaXN0IG9mDQor IyBsaWJyYXJ5IHBhdGhzIHNlYXJjaGVkIGFuZCBsaW5rZWQgYWdhaW5zdC4N CisjDQogZGVmIGZpbmRfbGlicmFyeShsaWIsIGZ1bmMsICpwYXRocywgJmIp DQogICBmdW5jID0gIm1haW4iIGlmICFmdW5jIG9yIGZ1bmMuZW1wdHk/DQog ICBsaWIgPSB3aXRoX2NvbmZpZyhsaWIrJ2xpYicsIGxpYikNCkBAIC01OTUs NiArNjE1LDE0IEBADQogICBlbmQNCiBlbmQNCiANCisjIFJldHVybnMgd2hl dGhlciBvciBub3QgdGhlIGZ1bmN0aW9uICtmdW5jKyBjYW4gYmUgZm91bmQg aW4gdGhlIGNvbW1vbg0KKyMgaGVhZGVyIGZpbGVzLCBvciB3aXRoaW4gYW55 ICtoZWFkZXJzKyB0aGF0IHlvdSBwcm92aWRlLiAgSWYgZm91bmQsIGENCisj IG1hY3JvIGlzIHBhc3NlZCBhcyBhIHByZXByb2Nlc3NvciBjb25zdGFudCB0 byB0aGUgY29tcGlsZXIgdXNpbmcgdGhlDQorIyBmdW5jdGlvbiBuYW1lLCBp biB1cHBlcmNhc2UsIHByZXBlbmRlZCB3aXRoICdIQVZFXycuDQorIw0KKyMg Rm9yIGV4YW1wbGUsIGlmIGhhdmVfZnVuYygnZm9vJykgcmV0dXJuZWQgdHJ1 ZSwgdGhlbiB0aGUgSEFWRV9GT08NCisjIHByZXByb2Nlc3NvciBtYWNybyB3 b3VsZCBiZSBwYXNzZWQgdG8gdGhlIGNvbXBpbGVyLg0KKyMNCiBkZWYgaGF2 ZV9mdW5jKGZ1bmMsIGhlYWRlcnMgPSBuaWwsICZiKQ0KICAgY2hlY2tpbmdf Zm9yICIje2Z1bmN9KCkiIGRvDQogICAgIGlmIHRyeV9mdW5jKGZ1bmMsICRs aWJzLCBoZWFkZXJzLCAmYikNCkBAIC02MDYsNiArNjM0LDE0IEBADQogICBl bmQNCiBlbmQNCiANCisjIFJldHVybnMgd2hldGhlciBvciBub3QgdGhlIHZh cmlhYmxlICt2YXIrIGNhbiBiZSBmb3VuZCBpbiB0aGUgY29tbW9uDQorIyBo ZWFkZXIgZmlsZXMsIG9yIHdpdGhpbiBhbnkgK2hlYWRlcnMrIHRoYXQgeW91 IHByb3ZpZGUuICBJZiBmb3VuZCwgYQ0KKyMgbWFjcm8gaXMgcGFzc2VkIGFz IGEgcHJlcHJvY2Vzc29yIGNvbnN0YW50IHRvIHRoZSBjb21waWxlciB1c2lu ZyB0aGUNCisjIHZhcmlhYmxlIG5hbWUsIGluIHVwcGVyY2FzZSwgcHJlcGVu ZGVkIHdpdGggJ0hBVkVfJy4NCisjDQorIyBGb3IgZXhhbXBsZSwgaWYgaGF2 ZV92YXIoJ2ZvbycpIHJldHVybmVkIHRydWUsIHRoZW4gdGhlIEhBVkVfRk9P DQorIyBwcmVwcm9jZXNzb3IgbWFjcm8gd291bGQgYmUgcGFzc2VkIHRvIHRo ZSBjb21waWxlci4NCisjDQogZGVmIGhhdmVfdmFyKHZhciwgaGVhZGVycyA9 IG5pbCwgJmIpDQogICBjaGVja2luZ19mb3IgIiN7dmFyfSIgZG8NCiAgICAg aWYgdHJ5X3Zhcih2YXIsIGhlYWRlcnMsICZiKQ0KQEAgLTYxNyw2ICs2NTMs MTMgQEANCiAgIGVuZA0KIGVuZA0KIA0KKyMgUmV0dXJucyB3aGV0aGVyIG9y IG5vdCB0aGUgZ2l2ZW4gK2hlYWRlcisgZmlsZSBjYW4gYmUgZm91bmQgb24g eW91ciBzeXN0ZW0uDQorIyBJZiBmb3VuZCwgYSBtYWNybyBpcyBwYXNzZWQg YXMgYSBwcmVwcm9jZXNzb3IgY29uc3RhbnQgdG8gdGhlIGNvbXBpbGVyIHVz aW5nDQorIyB0aGUgaGVhZGVyIGZpbGUgbmFtZSwgaW4gdXBwZXJjYXNlLCBw cmVwZW5kZWQgd2l0aCAnSEFWRV8nLg0KKyMNCisjIEZvciBleGFtcGxlLCBp ZiBoYXZlX2hlYWRlcignZm9vLmgnKSByZXR1cm5lZCB0cnVlLCB0aGVuIHRo ZSBIQVZFX0ZPT19IDQorIyBwcmVwcm9jZXNzb3IgbWFjcm8gd291bGQgYmUg cGFzc2VkIHRvIHRoZSBjb21waWxlci4NCisjDQogZGVmIGhhdmVfaGVhZGVy KGhlYWRlciwgJmIpDQogICBjaGVja2luZ19mb3IgaGVhZGVyIGRvDQogICAg IGlmIHRyeV9jcHAoY3BwX2luY2x1ZGUoaGVhZGVyKSwgJmIpDQpAQCAtNjI4 LDYgKzY3MSwxMiBAQA0KICAgZW5kDQogZW5kDQogDQorIyBJbnN0cnVjdHMg bWttZiB0byBzZWFyY2ggZm9yIHRoZSBnaXZlbiAraGVhZGVyKyBpbiBhbnkg b2YgdGhlICtwYXRocysNCisjIHByb3ZpZGVkLCBhbmQgcmV0dXJucyB3aGV0 aGVyIG9yIG5vdCBpdCB3YXMgZm91bmQgaW4gdGhvc2UgcGF0aHMuDQorIw0K KyMgSWYgdGhlIGhlYWRlciBpcyBmb3VuZCB0aGVuIHRoZSBwYXRoIGl0IHdh cyBmb3VuZCBvbiBpcyBhZGRlZCB0byB0aGUgbGlzdA0KKyMgb2YgaW5jbHVk ZWQgZGlyZWN0b3JpZXMgdGhhdCBhcmUgc2VudCB0byB0aGUgY29tcGlsZXIg KHZpYSB0aGUgLUkgc3dpdGNoKS4NCisjDQogZGVmIGZpbmRfaGVhZGVyKGhl YWRlciwgKnBhdGhzKQ0KICAgY2hlY2tpbmdfZm9yIGhlYWRlciBkbw0KICAg ICBpZiB0cnlfY3BwKGNwcF9pbmNsdWRlKGhlYWRlcikpDQpAQCAtNjQ3LDYg KzY5NiwxNyBAQA0KICAgZW5kDQogZW5kDQogDQorIyBSZXR1cm5zIHdoZXRo ZXIgb3Igbm90IHRoZSBzdHJ1Y3Qgb2YgdHlwZSArdHlwZSsgY29udGFpbnMg K21lbWJlcisuICBJZg0KKyMgaXQgZG9lcyBub3QsIG9yIHRoZSBzdHJ1Y3Qg dHlwZSBjYW4ndCBiZSBmb3VuZCwgdGhlbiBmYWxzZSBpcyByZXR1cm5lZC4g IFlvdQ0KKyMgbWF5IG9wdGlvbmFsbHkgc3BlY2lmeSBhICtoZWFkZXIrIGZp bGUgaW4gd2hpY2ggdG8gbG9vayBmb3IgdGhlIHN0cnVjdA0KKyMgKGluIGFk ZGl0aW9uIHRvIHRoZSBjb21tb24gaGVhZGVyIGZpbGVzKS4NCisjDQorIyBJ ZiBmb3VuZCwgYSBtYWNybyBpcyBwYXNzZWQgYXMgYSBwcmVwcm9jZXNzb3Ig Y29uc3RhbnQgdG8gdGhlIGNvbXBpbGVyIHVzaW5nDQorIyB0aGUgbWVtYmVy IG5hbWUsIGluIHVwcGVyY2FzZSwgcHJlcGVuZGVkIHdpdGggJ0hBVkVfU1Rf Jy4NCisjDQorIyBGb3IgZXhhbXBsZSwgaWYgaGF2ZV9zdHJ1Y3RfbWVtYmVy KCdmb28nLCAnYmFyJykgcmV0dXJuZWQgdHJ1ZSwgdGhlbiB0aGUNCisjIEhB VkVfU1RfQkFSIHByZXByb2Nlc3NvciBtYWNybyB3b3VsZCBiZSBwYXNzZWQg dG8gdGhlIGNvbXBpbGVyLg0KKyMgDQogZGVmIGhhdmVfc3RydWN0X21lbWJl cih0eXBlLCBtZW1iZXIsIGhlYWRlciA9IG5pbCwgJmIpDQogICBjaGVja2lu Z19mb3IgIiN7dHlwZX0uI3ttZW1iZXJ9IiBkbw0KICAgICBpZiB0cnlfY29t cGlsZSg8PCJTUkMiLCAmYikNCkBAIC02NjQsNiArNzI0LDE3IEBADQogICBl bmQNCiBlbmQNCiANCisjIFJldHVybnMgd2hldGhlciBvciBub3QgdGhlIHN0 YXRpYyB0eXBlICt0eXBlKyBpcyBkZWZpbmVkLiAgWW91IG1heQ0KKyMgb3B0 aW9uYWxseSBwYXNzIGEgaGVhZGVyIGZpbGUgdG8gY2hlY2sgYWdhaW5zdCBp biBhZGRpdGlvbiB0byB0aGUgY29tbW9uDQorIyBoZWFkZXIgZmlsZXMuICBZ b3UgbWF5IHBhc3MgYWRkaXRpb25hbCBmbGFncyB0byArb3B0KyB3aGljaCBh cmUgdGhlbiBwYXNzZWQNCisjIGFsb25nIHRvIHRoZSBjb21waWxlci4NCisj DQorIyBJZiBmb3VuZCwgYSBtYWNybyBpcyBwYXNzZWQgYXMgYSBwcmVwcm9j ZXNzb3IgY29uc3RhbnQgdG8gdGhlIGNvbXBpbGVyIHVzaW5nDQorIyB0aGUg dHlwZSBuYW1lLCBpbiB1cHBlcmNhc2UsIHByZXBlbmRlZCB3aXRoICdIQVZF X1RZUEVfJy4NCisjDQorIyBGb3IgZXhhbXBsZSwgaWYgaGF2ZV90eXBlKCdm b28nKSByZXR1cm5lZCB0cnVlLCB0aGVuIHRoZSBIQVZFX1RZUEVfRk9PDQor IyBwcmVwcm9jZXNzb3IgbWFjcm8gd291bGQgYmUgcGFzc2VkIHRvIHRoZSBj b21waWxlci4NCisjDQogZGVmIGhhdmVfdHlwZSh0eXBlLCBoZWFkZXIgPSBu aWwsIG9wdCA9ICIiLCAmYikNCiAgIGNoZWNraW5nX2ZvciB0eXBlIGRvDQog ICAgIGhlYWRlciA9IGNwcF9pbmNsdWRlKGhlYWRlcikNCkBAIC02ODYsNiAr NzU3LDE2IEBADQogICBlbmQNCiBlbmQNCiANCisjIFJldHVybnMgdGhlIHNp emUgb2YgdGhlIGdpdmVuICt0eXBlKy4gIFlvdSBtYXkgb3B0aW9uYWxseSBz cGVjaWZ5IGFuIGV4cGxpY2l0DQorIyAraGVhZGVyKyBmaWxlIHRvIHNlYXJj aCBpbiBmb3IgdGhlICt0eXBlKy4NCisjDQorIyBJZiBmb3VuZCwgYSBtYWNy byBpcyBwYXNzZWQgYXMgYSBwcmVwcm9jZXNzb3IgY29uc3RhbnQgdG8gdGhl IGNvbXBpbGVyIHVzaW5nDQorIyB0aGUgdHlwZSBuYW1lLCBpbiB1cHBlcmNh c2UsIHByZXBlbmRlZCB3aXRoICdTSVpFT0ZfJywgZm9sbG93ZWQgYnkgdGhl IHR5cGUNCisjIG5hbWUsIGZvbGxvd2VkIGJ5ICc9WCcgd2hlcmUgJ1gnIGlz IHRoZSBhY3R1YWwgc2l6ZS4NCisjDQorIyBGb3IgZXhhbXBsZSwgaWYgY2hl Y2tfc2l6ZW9mKCdteXN0cnVjdCcpIHJldHVybmVkIDEyLCB0aGVuIHRoZQ0K KyMgU0laRU9GX01ZU1RSVUNUPTEyIHByZXByb2Nlc3NvciBtYWNybyB3b3Vs ZCBiZSBwYXNzZWQgdG8gdGhlIGNvbXBpbGVyLg0KKyMNCiBkZWYgY2hlY2tf c2l6ZW9mKHR5cGUsIGhlYWRlciA9IG5pbCwgJmIpDQogICBleHByID0gInNp emVvZigje3R5cGV9KSINCiAgIG0gPSAiY2hlY2tpbmcgc2l6ZSBvZiAje3R5 cGV9Li4uICINCkBAIC04NDcsNiArOTI4LDE3IEBADQogICAkZXh0Y29uZl9o ID0gaGVhZGVyDQogZW5kDQogDQorIyBTZXRzIGEgK3RhcmdldCsgbmFtZSB0 aGF0IHRoZSB1c2VyIGNhbiB0aGVuIHVzZSB0byBjb25maWd1cmUgdmFyaW91 cyAnd2l0aCcNCisjIG9wdGlvbnMgd2l0aCBvbiB0aGUgY29tbWFuZCBsaW5l IGJ5IHVzaW5nIHRoYXQgbmFtZS4gIEZvciBleGFtcGxlLCBpZiB0aGUNCisj IHRhcmdldCBpcyBzZXQgdG8gImZvbyIsIHRoZW4gdGhlIHVzZXIgY291bGQg dXNlIHRoZSAtLXdpdGgtZm9vLWRpciBjb21tYW5kDQorIyBsaW5lIG9wdGlv bi4NCisjDQorIyBZb3UgbWF5IHBhc3MgYWxvbmcgYWRkaXRpb25hbCAnaW5j bHVkZScgb3IgJ2xpYicgZGVmYXVsdHMgdmlhIHRoZSAraWRlZmF1bHQrDQor IyBhbmQgK2xkZWZhdWx0KyBwYXJhbWV0ZXJzLCByZXNwZWN0aXZlbHkuDQor Iw0KKyMgTm90ZSB0aGF0IGRpcl9jb25maWcgb25seSBhZGRzIHRvIHRoZSBs aXN0IG9mIHBsYWNlcyB0byBzZWFyY2ggZm9yIGxpYnJhcmllcw0KKyMgYW5k IGluY2x1ZGUgZmlsZXMuICBJdCBkb2VzIG5vdCBsaW5rIHRoZSBsaWJyYXJp ZXMgaW50byB5b3VyIGFwcGxpY2F0aW9uLg0KKyMNCiBkZWYgZGlyX2NvbmZp Zyh0YXJnZXQsIGlkZWZhdWx0PW5pbCwgbGRlZmF1bHQ9bmlsKQ0KICAgaWYg ZGlyID0gd2l0aF9jb25maWcodGFyZ2V0ICsgIi1kaXIiLCAoaWRlZmF1bHQg dW5sZXNzIGxkZWZhdWx0KSkNCiAgICAgZGVmYXVsdHMgPSBBcnJheSA9PT0g ZGlyID8gZGlyIDogZGlyLnNwbGl0KEZpbGU6OlBBVEhfU0VQQVJBVE9SKQ0K QEAgLTEwMjEsNiArMTExMywyNCBAQA0KIFJVTEVTDQogZW5kDQogDQorIyBH ZW5lcmF0ZXMgdGhlIE1ha2VmaWxlIGZvciB5b3VyIGV4dGVuc2lvbiwgcGFz c2luZyBhbG9uZyBhbnkgb3B0aW9ucyBhbmQNCisjIHByZXByb2Nlc3NvciBj b25zdGFudHMgdGhhdCB5b3UgbWF5IGhhdmUgZ2VuZXJhdGVkIHRocm91Z2gg b3RoZXIgbWV0aG9kcy4NCisjDQorIyBUaGUgK3RhcmdldCsgbmFtZSBzaG91 bGQgY29ycmVzcG9uZCB0aGUgbmFtZSBvZiB0aGUgZ2xvYmFsIGZ1bmN0aW9u IG5hbWUNCisjIGRlZmluZWQgd2l0aGluIHlvdXIgQyBleHRlbnNpb24sIG1p bnVzIHRoZSAnSW5pdF8nLiAgRm9yIGV4YW1wbGUsIGlmIHlvdXINCisjIEMg ZXh0ZW5zaW9uIGlzIGRlZmluZWQgYXMgJ0luaXRfZm9vJywgdGhlbiB5b3Vy IHRhcmdldCB3b3VsZCBzaW1wbHkgYmUgJ2ZvbycuDQorIw0KKyMgSWYgYW55 ICcvJyBjaGFyYWN0ZXJzIGFyZSBwcmVzZW50IGluIHRoZSB0YXJnZXQgbmFt ZSwgb25seSB0aGUgbGFzdCBuYW1lDQorIyBpcyBpbnRlcnByZXRlZCBhcyB0 aGUgdGFyZ2V0IG5hbWUsIGFuZCB0aGUgcmVzdCBhcmUgY29uc2lkZXJlZCB0 b3BsZXZlbA0KKyMgZGlyZWN0b3J5IG5hbWVzLCBhbmQgdGhlIGdlbmVyYXRl ZCBNYWtlZmlsZSB3aWxsIGJlIGFsdGVyZWQgYWNjb3JkaW5nbHkgdG8NCisj IGZvbGxvdyB0aGF0IGRpcmVjdG9yeSBzdHJ1Y3R1cmUuDQorIw0KKyMgRm9y IGV4YW1wbGUsIGlmIHlvdSBwYXNzICd0ZXN0L2ZvbycgYXMgYSB0YXJnZXQg bmFtZSwgeW91ciBleHRlbnNpb24gd2lsbA0KKyMgYmUgaW5zdGFsbGVkIHVu ZGVyIHRoZSAndGVzdCcgZGlyZWN0b3J5LiAgVGhpcyBtZWFucyB0aGF0IGlu IG9yZGVyIHRvDQorIyBsb2FkIHRoZSBmaWxlIHdpdGhpbiBhIFJ1YnkgcHJv Z3JhbSBsYXRlciwgdGhhdCBkaXJlY3Rvcnkgc3RydWN0dXJlIHdpbGwNCisj IGhhdmUgdG8gYmUgZm9sbG93ZWQsIGUuZy4gInJlcXVpcmUgJ3Rlc3QvZm9v JyIuDQorIyANCisjDQogZGVmIGNyZWF0ZV9tYWtlZmlsZSh0YXJnZXQsIHNy Y3ByZWZpeCA9IG5pbCkNCiAgICR0YXJnZXQgPSB0YXJnZXQNCiAgIGxpYnBh dGggPSAkTElCUEFUSA0K --0-264968080-1152382300=:80219--