README in file-find-0.2.2 vs README in file-find-0.2.3
- old
+ new
@@ -17,30 +17,31 @@
* rake test (optional)
* rake install (non-gem) -OR- rake install_gem (gem)
= Rationale
The current find module in the standard library is inadequate. It is, quite
-frankly, not much more than a plain Dir.glob call. This package provides an
+frankly, not much more than a plain Dir.glob call. This library provides an
interface based on options typically available on your command line 'find'
command, thus allowing you much greater control over how you find your files.
-I am aware of the find2 package by Motoyuki Kasahara, but it supports very
+I am aware of the find2 library by Motoyuki Kasahara, but it supports very
few options, hasn't been updated in over six years and isn't packaged properly.
= Options
* atime
* ctime
* follow
* ftype
* inum (except Windows)
-* group
+* group (name or id)
+* mtime
* name (or 'pattern')
* path
* perm (except Windows)
* prune
* size
-* user
+* user (name or id)
See the RDoc documentation for more details about these options.
= Future Plans
More options will be added as time permits, and requests will definitely be
@@ -58,25 +59,22 @@
Generally speaking, anything that would require mucking around with C code
or is just too difficult to implement in a cross platform manner will not be
supported. These include the following options:
* acl/xattr - Way too difficult to implement in a cross platform manner, and
- a rarely used option to boot.
+ a rarely used option in practice.
-* cpio/ncpio - You can shell out on your own if you want, but I'm not going to
- do it for you. The same goes for any similar options for 3rd party apps that
- your particular platform may support.
+* cpio/ncpio - I will not shell out to this or any other 3rd party application.
-* ls/print - You can print file names as you see fit on your own. This isn't
- a shell command replacement.
+* ls/print - Use Ruby's builtin printing methods to print as you see fit.
* ok - This is not interactive software.
= Options I may or may not support
* local/mount/xdev - This will probably not be added until I'm satisfied with
- the sys-filesystem package.
+ the sys-filesystem library. As of sys-filesystem 0.1.x, I'm not.
= Known Issues
The 'perm' option does not work on MS Windows, even for its limited subset of
permissions, i.e. 664 and 666. This is arguably a bug in Ruby's
File::Stat.mode method on MS Windows.
@@ -90,9 +88,10 @@
http://www.rubyforge.org/projects/shards.
= Acknowledgements
* Richard Clamp's File::Find::Rule Perl module for additional ideas and
inspiration.
+* Bill Kleb for ideas regarding name, group and perm enhancements.
= License
Ruby's
= Copyright