NAME

App::Greple::frame - Greple frame output module

SYNOPSIS

greple -Mframe --frame ...

DESCRIPTION

Greple -Mframe module provide a capability to put surrounding frames for each blocks.

top, middle and bottom frames are printed for blocks.

By default --join-blocks option is enabled to collect consecutive lines into a single block. If you don't like this, override it by --no-join-blocks option.

OPTIONS

--frame

Set frame and fold long lines with frame-friendly prefix string. Folding width is taken from the terminal. Or you can specify the width by calling set function with module option.

--frame-cols

Output results in multi-column format to fit the width of the terminal. The number of columns is automatically calculated from the terminal width.

--frame-pages

Output results in multi-column and paginated format.

--set-frame-width=#

Set frame width. You have to put this option before --frame option. See set function in "FUNCTION" section.

FUNCTION

set(width=n)

Set terminal width to n. Use like this:

    greple -Mframe::set(width=80) ...

    greple -Mframe::set=width=80 ...

If non-digit character is found in the value part, it is considered as a Reverse Polish Notation, starting terminal width pushed on the stack. RPN 2/3- means terminal-width / 2 - 3.

You can use like this:

    greple -Mframe::set=width=2/3- --frame --uc '(\w+::)+\w+' --git | ansicolumn -PC2

SEE ALSO

App::ansifold

App::ansicolumn

Math::RPN

AUTHOR

Kazumasa Utashiro

LICENSE

Copyright 2022-2023 Kazumasa Utashiro.

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