FINDRULE(1p)						User Contributed Perl Documentation					      FINDRULE(1p)

NAME

       findrule - command line wrapper to File::Find::Rule

USAGE

	 findrule [path...] [expression]

DESCRIPTION

       "findrule" mostly borrows the interface from GNU find(1) to provide a command-line interface onto the File::Find::Rule heirarchy of
       modules.

       The syntax for expressions is the rule name, preceded by a dash, followed by an optional argument.  If the argument is an opening
       parenthesis it is taken as a list of arguments, terminated by a closing parenthesis.

       Some examples:

	find -file -name ( foo bar )

       files named "foo" or "bar", below the current directory.

	find -file -name foo -bar

       files named "foo", that have pubs (for this is what our ficticious "bar" clause specifies), below the current directory.

	find -file -name ( -bar )

       files named "-bar", below the current directory.  In this case if we'd have omitted the parenthesis it would have parsed as a call to name
       with no arguments, followed by a call to -bar.

   Supported switches
       I'm very slack.	Please consult the File::Find::Rule manpage for now, and prepend - to the commands that you want.

   Extra bonus switches
       findrule automatically loads all of your installed File::Find::Rule::* extension modules, so check the documentation to see what those
       would be.

AUTHOR

       Richard Clamp <richardc@unixbeard.net> from a suggestion by Tatsuhiko Miyagawa

COPYRIGHT

       Copyright (C) 2002 Richard Clamp.  All Rights Reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

       File::Find::Rule

perl v5.12.4							    2011-09-19							      FINDRULE(1p)