findrule (1)

Leading comments

Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man1/findrule.1p".)

NAME

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

USAGE

  findrule [path...] [expression]

DESCRIPTION

"findrule" mostly borrows the interface from 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