/ 
App-BoolFindGrep-0.01
River stage zero No dependents
/ bfg

NAME

bfg - Command Line Interface for App::BoolFindGrep.

VERSION

version 0.01

DESCRIPTION

Boolean Expressions

In the context of this program, a Boolean Expression is a composite of OPERANDS, OPERATORS and GROUPS.

An OPERAND is a string representing a literal text or a regular expression. It can be delimited by slashes like ed, sed or vim. All non-delimiter slashes need to be escaped.

An OPERATOR can be AND, OR or NOT, delimited by white spaces. The following composition of operators are valid too: AND NOT, OR NOT, NOT NOT NOT ...

A GROUP is a sub expression delimite by parentheses used to define a set of sub conditions to match.

Any expression valid in program languages are valid.

USAGE

bfg [ -m <bool expr>]
bfg [-F|-i|[-w|-x]] [-m <bool expr>]
bfg [-t <literal|regexp>] [-I <0|1>] -f <EXPR>
bfg [-t <literal|regexp>] [-I <0|1>] -f <EXPR> -m <EXPR>
bfg [-T <filename|-|STDIN> [-d <char>]] [-F|-i|[-w|-x]] -m <EXPR>

OPTIONS:
[ --files-from       | -T ]    file name, - or stdin
[ --files-delim      | -d ]    file names' character separator
[ --file-expr        | -f ]    boolean expr to file names
[ --find-type        | -t ]    regexp (default) or literal.
[ --find-ignore-case | -I ]    0 (default) or 1
[ --match-expr       | -m ]    boolean expr to file contents
[ --fixed-strings    | -F ]    operands as literal strings
[ --ignore-case      | -i ]    ignore case of operands
[ --line-regexp      | -x ]    interpret operands as whole lines
[ --word-regexp      | -w ]    interpret operands as whole words

OPTIONS

"find" options

  • --files-from, -T

    Get file names from a file or from Standard Input. Valid forms to express STDIN are hyphen ou word "stdin" (the case is ignored). This option works like -T from gnu tar.

  • --files-delim, -d

    Specify string separator of file names when --files-from, -T is given. This option can receive a NULL character if written as \0 (like -0 option from gnu xargs.

  • --file-expr, -f

    Specify the boolean expression to search in file names. Any boolean expression is valid.

  • --find-type, -t

    Determines if operands of --file-expr, -f are interpreted as literal strings or regular expressions. The default is regular expressions.

  • --find-ignore-case, -I

    Determines if case of operand of --file-expr, -f are relevant or no. Default is yes (0).

"grep" options

  • --match-expr, -m

    Specify the boolean expression to search in file contents. Any boolean expression is valid.

  • --fixed-strings, -F

    Interprets the operands of --match-expr as literal strings.

  • --ignore-case, -i

    Ignore or no the case operands' case letters of --match-expr option.

  • --line-regexp, -x

    Interprets each operand of --match-expr as a whole line.

  • --word-regexp, -w

    Interprets each operand of --match-expr as a whole word*.

    *word here is regexp context.

EXAMPLES

AUTHOR

Ronaldo Ferreira de Lima aka jimmy <jimmy at gmail>.

SEE ALSO

  • App::BoolFindGrep.