NAME

hr - define a thematic change in the content of a terminal session

SYNOPSIS

  hr [OPTIONS]

DESCRIPTION

hr prints a horisontal bar in your terminal. Useful when you run a chain of commands that might produce a lot of output and you need to differentiate where a given output is coming from.

OPTIONS

  -c,    --char       Character to use
  -s,    --size       Number of columns
  -pre,  --pre        Pad the left side with whitespace n
  -post, --post       Pad the right side with whitespace n
  -fg,   --fg         Foreground color to use, int 0-255
  -bg,   --bg         Background color to use, int 0-255
  -b,    --bold       Use bold
  -i,    --italic     Use italics
  -u,    --underline  Use underline
  -r,    --reverse    Use reverse video

  -h,    --help       Display this help and exit
  -m,    --man        Display the manual and exit
  -v,    --version    Display version info and exit

EXAMPLES

    # display a yellow underlined bar using the default '=' character
    hr -fg 220 --underline

    # display a red solid bar padded by 10 columns from right and left
    hr -fg 160 -c ▀ --pre 10 --post 10

    # display a solid grey, thick bar using ascii character _ and the bold,
    # underline and reverse video attributes

    hr -fg 240 -c_ -bur

    # display a bar made of dots, with 5 column spacing one each size
    # and 20 columns wide.

    hr -fg 197 -c· -pre 5 -post 5 -size 20

    # use all options at once, because why not?
    hr -c ! -fg 52 -bg 196 -biur -s 70 -pre 5 -post 5

    # use several characters to form a bar using arithmetics
    hr -c "  japh  " -fg 1 -bg 0 -b -s $(($COLUMNS / 8))

AUTHOR

  Magnus Woldrich
  CPAN ID: WOLDRICH
  m@japh.se
  http://japh.se
  http://github.com/trapd00r

COPYRIGHT

Copyright 2019 THIS APPLICATIONs "AUTHOR" and "CONTRIBUTORS" as listed above.

LICENSE

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