DOKK / manpages / debian 12 / libfile-find-rule-perl / findrule.1p.en
FINDRULE(1p) User Contributed Perl Documentation FINDRULE(1p)

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

  findrule [path...] [expression]

"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.

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

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

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

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.

File::Find::Rule

2022-11-19 perl v5.36.0