From: Austin Ziegler Date: 2004-08-09T00:00:59+09:00 Subject: Issue with Dir.glob documentation ------=_Part_39_15272404.1091977249267 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Disposition: inline I noticed this because I'm working on some stuff and needed to do an "ri Dir.[]", which of course led me to "ri Dir.glob". Dir.glob is, unfortunately, incomplete, in that it doesn't talk about the recursive ("**") globbing capabilities of Dir at all. All of my Ruby projects (and a few other things that aren't yet there) are in "C:\home\Projects". If I do, from this directory: a = Dir["**/*.rb"] b = Dir["**/lib"] c = Dir["**/lib/**/*.rb"] d = Dir["**/lib/*.rb"] a.size # => 823 b.size # => 39 c.size # => 437 d.size # => 19 a[0..2] # => ["diff/install.rb", "diff/lib/diff/lcs.rb", "diff/lib/diff/lcs/array.rb"] b[0..2] # => ["diff/lib", "diff/[sources]/Text-Diff-0.35/lib", "diff/[sources]/Text-ParagaphDiff/lib"] c[0..2] # => ["diff/lib/diff/lcs.rb", "diff/lib/diff/lcs/array.rb", "diff/lib/diff/lcs/block.rb"] d[0..2] # => ["pdf-writer/lib/pdf.rb", "pdf-writer/[sources]/lib/pdf.rb", "pdf-writer/[sources]/ruby-pdf2/lib/pdf.rb"] I'm attaching a documentation patch for dir.c (from the stable snapshot) that would include this information. It also completes the File.fnmatch and Dir.glob documentation to include the allowed patterns. Note as well that the {p,q} form for File.fnmatch is not implemented on either 1.8.2 or 1.9.0, but it is implemented for Dir.glob. It would be good to see this in Ruby 1.8.2. Dave, I know that content changes are closed for pickaxe2, but this may be of value in any case, and I hope you can manage to put this in. -austin -- Austin Ziegler * halostatue@gmail.com * Alternate: austin@halostatue.ca ------=_Part_39_15272404.1091977249267 Content-Type: application/octet-stream; name="dir.c.diff" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="dir.c.diff" LS0tIGRpci5jLm9sZAkyMDA0LTA3LTE3IDE0OjI0OjE2IEVhc3Rlcm4gRGF5bGlnaHQgVGltZQ0K KysrIGRpci5jCTIwMDQtMDgtMDggMTA6NTc6MTcgRWFzdGVybiBEYXlsaWdodCBUaW1lDQpAQCAt MTI1MiwxOCArMTI1Miw1OSBAQA0KICAqICBSZXR1cm5zIHRoZSBmaWxlbmFtZXMgZm91bmQgYnkg ZXhwYW5kaW5nIHRoZSBwYXR0ZXJuIGdpdmVuIGluDQogICogIDxpPnN0cmluZzwvaT4sIGVpdGhl ciBhcyBhbiA8aT5hcnJheTwvaT4gb3IgYXMgcGFyYW1ldGVycyB0byB0aGUNCiAgKiAgYmxvY2su IE5vdGUgdGhhdCB0aGlzIHBhdHRlcm4gaXMgbm90IGEgcmVnZXhwIChpdCdzIGNsb3NlciB0byBh DQotICogIHNoZWxsIGdsb2IpLiBTZWUgPGNvZGU+RmlsZTo6Zm5tYXRjaDwvY29kZT4gZm9yDQot ICogIGRldGFpbHMgb2YgZmlsZSBuYW1lIG1hdGNoaW5nIGFuZCB0aGUgbWVhbmluZyBvZiB0aGUg PGk+ZmxhZ3M8L2k+DQotICogIHBhcmFtZXRlci4NCisgKiAgc2hlbGwgZ2xvYikuIFNlZSA8Y29k ZT5GaWxlOjpmbm1hdGNoPC9jb2RlPiBmb3IgdGhlIG1lYW5pbmcgb2YgdGhlDQorICogIDxpPmZs YWdzPC9pPiBwYXJhbWV0ZXIuIFRoZSBwYXR0ZXJuIG1heSBiZSBjaGFyYWN0ZXIgbGl0ZXJhbHMg b3INCisgKiAgb25lIG9mIHRoZSBtZXRhcGF0dGVybnMgYmVsb3c6DQogICoNCisgKiAgPGNvZGU+ KjwvY29kZT46OiAgICAgICAgTWF0Y2hlcyBhbnkgZmlsZS4gQ2FuIGJlIHJlc3RyaWN0ZWQgYnkN CisgKiAgICAgICAgICAgICAgICAgICAgICAgICAgb3RoZXIgdmFsdWVzIGluIHRoZSBnbG9iLiA8 Y29kZT4qPC9jb2RlPg0KKyAqICAgICAgICAgICAgICAgICAgICAgICAgICB3aWxsIG1hdGNoIGFs bCBmaWxlczsgPGNvZGU+Yyo8L2NvZGU+IHdpbGwNCisgKiAgICAgICAgICAgICAgICAgICAgICAg ICAgbWF0Y2ggYWxsIGZpbGVzIGJlZ2lubmluZyB3aXRoDQorICogICAgICAgICAgICAgICAgICAg ICAgICAgIDxjb2RlPmM8L2NvZGU+OyA8Y29kZT4qYzwvY29kZT4gd2lsbCBtYXRjaA0KKyAqICAg ICAgICAgICAgICAgICAgICAgICAgICBhbGwgZmlsZXMgZW5kaW5nIHdpdGggPGNvZGU+YzwvY29k ZT47IGFuZA0KKyAqICAgICAgICAgICAgICAgICAgICAgICAgICA8Y29kZT4qYyo8L2NvZGU+IHdp bGwgbWF0Y2ggYWxsIGZpbGVzIHRoYXQNCisgKiAgICAgICAgICAgICAgICAgICAgICAgICAgaGF2 ZSA8Y29kZT5jPC9jb2RlPiBpbiB0aGVtIChpbmNsdWRpbmcgYXQNCisgKiAgICAgICAgICAgICAg ICAgICAgICAgICAgdGhlIGJlZ2lubmluZyBvciBlbmQpLiBFcXVpdmFsZW50IHRvDQorICogICAg ICAgICAgICAgICAgICAgICAgICAgIDxjb2RlPi8gLiogL3g8L2NvZGU+IGluIHJlZ2V4cC4NCisg KiAgPGNvZGU+Kio8L2NvZGU+OjogICAgICAgTWF0Y2hlcyBkaXJlY3RvcmllcyByZWN1cnNpdmVs eS4NCisgKiAgPGNvZGU+PzwvY29kZT46OiAgICAgICAgTWF0Y2hlcyBhbnkgb25lIGNoYXJhY3Rl ci4gRXF1aXZhbGVudCB0bw0KKyAqICAgICAgICAgICAgICAgICAgICAgICAgICA8Y29kZT4vLnsx fS88L2NvZGU+IGluIHJlZ2V4cC4NCisgKiAgPGNvZGU+W3NldF08L2NvZGU+OjogICAgTWF0Y2hl cyBhbnkgb25lIGNoYXJhY3RlciBpbiArc2V0Ky4NCisgKiAgICAgICAgICAgICAgICAgICAgICAg ICAgQmVoYXZlcyBleGFjdGx5IGxpa2UgY2hhcmFjdGVyIHNldHMgaW4NCisgKiAgICAgICAgICAg ICAgICAgICAgICAgICAgUmVnZXhwLCBpbmNsdWRpbmcgc2V0IG5lZ2F0aW9uDQorICogICAgICAg ICAgICAgICAgICAgICAgICAgICg8Y29kZT5bXmEtel08L2NvZGU+KS4NCisgKiAgPGNvZGU+e3As cX08L2NvZGU+OjogICAgTWF0Y2hlcyBlaXRoZXIgbGl0ZXJhbCA8Y29kZT5wPC9jb2RlPiBvcg0K KyAqICAgICAgICAgICAgICAgICAgICAgICAgICBsaXRlcmFsIDxjb2RlPnE8L2NvZGU+LiBNYXRj aGluZyBsaXRlcmFscw0KKyAqICAgICAgICAgICAgICAgICAgICAgICAgICBtYXkgYmUgbW9yZSB0 aGFuIG9uZSBjaGFyYWN0ZXIgaW4gbGVuZ3RoLg0KKyAqICAgICAgICAgICAgICAgICAgICAgICAg ICBNb3JlIHRoYW4gdHdvIGxpdGVyYWxzIG1heSBiZSBzcGVjaWZpZWQuDQorICogICAgICAgICAg ICAgICAgICAgICAgICAgIEVxdWl2YWxlbnQgdG8gcGF0dGVybiBhbHRlcm5hdGlvbiBpbg0KKyAq ICAgICAgICAgICAgICAgICAgICAgICAgICByZWdleHAuDQorICogIDxjb2RlPlw8L2NvZGU+Ojog ICAgICAgIEVzY2FwZXMgdGhlIG5leHQgbWV0YWNoYXJhY3Rlci4NCisgKg0KICAqICAgICBEaXJb ImNvbmZpZy4/Il0gICAgICAgICAgICAgICAgICAgICAjPT4gWyJjb25maWcuaCJdDQogICogICAg IERpci5nbG9iKCJjb25maWcuPyIpICAgICAgICAgICAgICAgICM9PiBbImNvbmZpZy5oIl0NCiAg KiAgICAgRGlyLmdsb2IoIiouW2Etel1bYS16XSIpICAgICAgICAgICAgIz0+IFsibWFpbi5yYiJd DQogICogICAgIERpci5nbG9iKCIqLltecl0qIikgICAgICAgICAgICAgICAgICM9PiBbImNvbmZp Zy5oIl0NCiAgKiAgICAgRGlyLmdsb2IoIioue3JiLGh9IikgICAgICAgICAgICAgICAgIz0+IFsi bWFpbi5yYiIsICJjb25maWcuaCJdDQogICogICAgIERpci5nbG9iKCIqIikgICAgICAgICAgICAg ICAgICAgICAgICM9PiBbImNvbmZpZy5oIiwgIm1haW4ucmIiXQ0KLSAqICAgICBEaXIuZ2xvYigi KiIsIEZpbGU6OkZOTV9ET1RNQVRDSCkgICAjPT4gWyIuIiwgIi4uIiwgImNvbmZpZy5oIiwgIm1h aW4ucmIiXQ0KKyAqICAgICBEaXIuZ2xvYigiKiIsIEZpbGU6OkZOTV9ET1RNQVRDSCkgICAjPT4g WyIuIiwgIi4uIiwgImNvbmZpZy5oIiwNCisgKiAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAibWFpbi5yYiJdDQorICogICAgIERpci5nbG9iKCIqKi5yYiIpICAg ICAgICAgICAgICAgICAgICM9PiBbXQ0KICAqDQorICogICAgIHJiZmlsZXMgPSBGaWxlLmpvaW4o IioqIiwgIioucmIiKQ0KKyAqICAgICBEaXIuZ2xvYihyYmZpbGVzKSAgICAgICAgICAgICAgICAg ICAjPT4gWyJtYWluLnJiIiwNCisgKiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAibGliL3NvbmcucmIiLA0KKyAqICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICJsaWIvc29uZy9rYXJhb2tlLnJiIl0NCisgKiAgICAgbGliZGly cyA9IEZpbGUuam9pbigiKioiLCAibGliIikNCisgKiAgICAgRGlyLmdsb2IobGliZGlycykgICAg ICAgICAgICAgICAgICAgIz0+IFsibGliIl0NCisgKg0KKyAqICAgICBsaWJyYmZpbGVzID0gRmls ZS5qb2luKCIqKiIsICJsaWIiLCAiKioiLCAiKi5yYiIpDQorICogICAgIERpci5nbG9iKGxpYnJi ZmlsZXMpICAgICAgICAgICAgICAgICM9PiBbImxpYi9zb25nLnJiIiwNCisgKiAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAibGliL3Nvbmcva2FyYW9rZS5yYiJd DQorICoNCisgKiAgICAgbGlicmJmaWxlcyA9IEZpbGUuam9pbigiKioiLCAibGliIiwgIioucmIi KQ0KKyAqICAgICBEaXIuZ2xvYihsaWJyYmZpbGVzKSAgICAgICAgICAgICAgICAjPT4gWyJsaWIv c29uZy5yYiJdDQorICoNCiAgKi8NCiBzdGF0aWMgVkFMVUUNCiBkaXJfc19nbG9iKGFyZ2MsIGFy Z3YsIG9iaikNCg0KQEAgLTEzMzgsMjggKzEzNzksNTQgQEANCiAgKg0KICAqICBSZXR1cm5zIHRy dWUgaWYgPGk+cGF0aDwvaT4gbWF0Y2hlcyBhZ2FpbnN0IDxpPnBhdHRlcm48L2k+IFRoZQ0KICAq ICBwYXR0ZXJuIGlzIG5vdCBhIHJlZ3VsYXIgZXhwcmVzc2lvbjsgaW5zdGVhZCBpdCBmb2xsb3dz IHJ1bGVzDQotICogIHNpbWlsYXIgdG8gc2hlbGwgZmlsZW5hbWUgZ2xvYmJpbmcuIEl0IG1heSBj b250YWluIHRoZSBmb2xsb3dpbmcNCi0gKiAgbWV0YWNoYXJhY3RlcnM6DQorICogIHNpbWlsYXIg dG8gc2hlbGwgZmlsZW5hbWUgZ2xvYmJpbmcuIFRoZSBwYXR0ZXJuIG1heSBiZSBjaGFyYWN0ZXIN CisgKiAgbGl0ZXJhbHMgb3Igb25lIG9mIHRoZSBtZXRhcGF0dGVybnMgYmVsb3c6DQogICoNCi0g KiAgPGk+ZmxhZ3M8L2k+IGlzIGEgYml0d2lzZSBPUiBvZiB0aGUgPGNvZGU+Rk5NX3h4eDwvY29k ZT4gcGFyYW1ldGVycy4NCi0gKiAgVGhlIHNhbWUgZ2xvYiBwYXR0ZXJuIGFuZCBmbGFncyBhcmUg dXNlZCBieSA8Y29kZT5EaXI6Omdsb2I8L2NvZGU+Lg0KKyAqICA8Y29kZT4qPC9jb2RlPjo6ICAg ICAgICBNYXRjaGVzIGFueSBmaWxlLiBDYW4gYmUgcmVzdHJpY3RlZCBieQ0KKyAqICAgICAgICAg ICAgICAgICAgICAgICAgICBvdGhlciB2YWx1ZXMgaW4gdGhlIGdsb2IuIDxjb2RlPio8L2NvZGU+ DQorICogICAgICAgICAgICAgICAgICAgICAgICAgIHdpbGwgbWF0Y2ggYWxsIGZpbGVzOyA8Y29k ZT5jKjwvY29kZT4gd2lsbA0KKyAqICAgICAgICAgICAgICAgICAgICAgICAgICBtYXRjaCBhbGwg ZmlsZXMgYmVnaW5uaW5nIHdpdGgNCisgKiAgICAgICAgICAgICAgICAgICAgICAgICAgPGNvZGU+ YzwvY29kZT47IDxjb2RlPipjPC9jb2RlPiB3aWxsIG1hdGNoDQorICogICAgICAgICAgICAgICAg ICAgICAgICAgIGFsbCBmaWxlcyBlbmRpbmcgd2l0aCA8Y29kZT5jPC9jb2RlPjsgYW5kDQorICog ICAgICAgICAgICAgICAgICAgICAgICAgIDxjb2RlPipjKjwvY29kZT4gd2lsbCBtYXRjaCBhbGwg ZmlsZXMgdGhhdA0KKyAqICAgICAgICAgICAgICAgICAgICAgICAgICBoYXZlIDxjb2RlPmM8L2Nv ZGU+IGluIHRoZW0gKGluY2x1ZGluZyBhdA0KKyAqICAgICAgICAgICAgICAgICAgICAgICAgICB0 aGUgYmVnaW5uaW5nIG9yIGVuZCkuIEVxdWl2YWxlbnQgdG8NCisgKiAgICAgICAgICAgICAgICAg ICAgICAgICAgPGNvZGU+LyAuKiAveDwvY29kZT4gaW4gcmVnZXhwLg0KKyAqICA8Y29kZT4qKjwv Y29kZT46OiAgICAgICBNYXRjaGVzIGRpcmVjdG9yaWVzIHJlY3Vyc2l2ZWx5IG9yIGZpbGVzDQor ICogICAgICAgICAgICAgICAgICAgICAgICAgIGV4cGFuc2l2ZWx5Lg0KKyAqICA8Y29kZT4/PC9j b2RlPjo6ICAgICAgICBNYXRjaGVzIGFueSBvbmUgY2hhcmFjdGVyLiBFcXVpdmFsZW50IHRvDQor ICogICAgICAgICAgICAgICAgICAgICAgICAgIDxjb2RlPi8uezF9LzwvY29kZT4gaW4gcmVnZXhw Lg0KKyAqICA8Y29kZT5bc2V0XTwvY29kZT46OiAgICBNYXRjaGVzIGFueSBvbmUgY2hhcmFjdGVy IGluICtzZXQrLg0KKyAqICAgICAgICAgICAgICAgICAgICAgICAgICBCZWhhdmVzIGV4YWN0bHkg bGlrZSBjaGFyYWN0ZXIgc2V0cyBpbg0KKyAqICAgICAgICAgICAgICAgICAgICAgICAgICBSZWdl eHAsIGluY2x1ZGluZyBzZXQgbmVnYXRpb24NCisgKiAgICAgICAgICAgICAgICAgICAgICAgICAg KDxjb2RlPlteYS16XTwvY29kZT4pLg0KKyAqICA8Y29kZT5cPC9jb2RlPjo6ICAgICAgICBFc2Nh cGVzIHRoZSBuZXh0IG1ldGFjaGFyYWN0ZXIuDQogICoNCisgKiAgPGk+ZmxhZ3M8L2k+IGlzIGEg Yml0d2lzZSBPUiBvZiB0aGUgPGNvZGU+Rk5NX3h4eDwvY29kZT4NCisgKiAgcGFyYW1ldGVycy4g VGhlIHNhbWUgZ2xvYiBwYXR0ZXJuIGFuZCBmbGFncyBhcmUgdXNlZCBieQ0KKyAqICA8Y29kZT5E aXI6Omdsb2I8L2NvZGU+Lg0KKyAqDQogICogICAgIEZpbGUuZm5tYXRjaCgnY2F0JywgICAgICAg J2NhdCcpICAgICAgICAjPT4gdHJ1ZQ0KICAqICAgICBGaWxlLmZubWF0Y2goJ2NhdCcsICAgICAg ICdjYXRlZ29yeScpICAgIz0+IGZhbHNlDQotICogICAgIEZpbGUuZm5tYXRjaCgnY3thdCx1Yn1z JywgJ2NhdHMnKSAgICAgICAjPT4gZmFsc2UNCi0gKiAgICAgRmlsZS5mbm1hdGNoKCdje2F0LHVi fXMnLCAnY3VicycpICAgICAgICM9PiBmYWxzZQ0KLSAqICAgICBGaWxlLmZubWF0Y2goJ2N7YXQs dWJ9cycsICdjYXQnKSAgICAgICAgIz0+IGZhbHNlDQogICoNCiAgKiAgICAgRmlsZS5mbm1hdGNo KCdjP3QnLCAgICAnY2F0JykgICAgICAgICAgICAgICAgICAgICAgICM9PiB0cnVlDQogICogICAg IEZpbGUuZm5tYXRjaCgnY1w/dCcsICAgJ2NhdCcpICAgICAgICAgICAgICAgICAgICAgICAjPT4g ZmFsc2UNCiAgKiAgICAgRmlsZS5mbm1hdGNoKCdjPz90JywgICAnY2F0JykgICAgICAgICAgICAg ICAgICAgICAgICM9PiBmYWxzZQ0KICAqICAgICBGaWxlLmZubWF0Y2goJ2MqJywgICAgICdjYXRz JykgICAgICAgICAgICAgICAgICAgICAgIz0+IHRydWUNCi0gKiAgICAgRmlsZS5mbm1hdGNoKCdj LyAqIEZJWE1FICogL3QnLCAnYy9hL2IvYy90JykgICAgICAgICAgICAgICAgICM9PiB0cnVlDQor ICogICAgIEZpbGUuZm5tYXRjaCgnYy8gKiBGSVhNRSAqIC90JywgJ2MvYS9iL2MvdCcpICAgICAg ICAjPT4gdHJ1ZQ0KICAqICAgICBGaWxlLmZubWF0Y2goJ2MqdCcsICAgICdjYXQnKSAgICAgICAg ICAgICAgICAgICAgICAgIz0+IHRydWUNCiAgKiAgICAgRmlsZS5mbm1hdGNoKCdjXGF0JywgICAn Y2F0JykgICAgICAgICAgICAgICAgICAgICAgICM9PiB0cnVlDQogICogICAgIEZpbGUuZm5tYXRj aCgnY1xhdCcsICAgJ2NhdCcsIEZpbGU6OkZOTV9OT0VTQ0FQRSkgICAjPT4gZmFsc2UNCiAgKiAg ICAgRmlsZS5mbm1hdGNoKCdhP2InLCAgICAnYS9iJykgICAgICAgICAgICAgICAgICAgICAgICM9 PiB0cnVlDQogICogICAgIEZpbGUuZm5tYXRjaCgnYT9iJywgICAgJ2EvYicsIEZpbGU6OkZOTV9Q QVRITkFNRSkgICAjPT4gZmFsc2UNCisgKg0KKyAqICAgICByYmZpbGVzID0gRmlsZS5qb2luKCIq KiIsICIqLnJiIikNCisgKiAgICAgRmlsZS5mbm1hdGNoKHJiZmlsZXMsICdtYWluLnJiJykgICAg ICAgICAgICAgICAgICAgICM9PiBmYWxzZQ0KKyAqICAgICBGaWxlLmZubWF0Y2gocmJmaWxlcywg Jy4vbWFpbi5yYicpICAgICAgICAgICAgICAgICAgIz0+IGZhbHNlDQorICogICAgIEZpbGUuZm5t YXRjaChyYmZpbGVzLCAnbGliL3NvbmcucmInKSAgICAgICAgICAgICAgICAjPT4gdHJ1ZQ0KKyAq ICAgICBGaWxlLmZubWF0Y2goJyoqLnJiJywgJ21haW4ucmInKSAgICAgICAgICAgICAgICAgICAg Iz0+IHRydWUNCisgKiAgICAgRmlsZS5mbm1hdGNoKCcqKi5yYicsICcuL21haW4ucmInKSAgICAg ICAgICAgICAgICAgICM9PiBmYWxzZQ0KKyAqICAgICBGaWxlLmZubWF0Y2goJyoqLnJiJywgJ2xp Yi9zb25nLnJiJykgICAgICAgICAgICAgICAgIz0+IHRydWUNCiAgKg0KICAqICAgICBGaWxlLmZu bWF0Y2goJyonLCAgICcucHJvZmlsZScpICAgICAgICAgICAgICAgICAgICAgICAgICAgICM9PiBm YWxzZQ0KICAqICAgICBGaWxlLmZubWF0Y2goJyonLCAgICcucHJvZmlsZScsIEZpbGU6OkZOTV9E T1RNQVRDSCkgICAgICAgICM9PiB0cnVlDQoNCg== ------=_Part_39_15272404.1091977249267--