simplify test names of example code

Keep only the first command or more significant parameter to minimally
identify the concerning script.

Add diagnostics output of the full command on failure.

test return status of example commands and pipes

Explicitly run with bash so intermediate failure can be detected using the
pipefail option.

adjust example commands for testing

script to run examples from documentation

test and warn about invalid marker values

eval test options to allow quoted values

Shell scripting fix for whitespace in set parameters.

silence warnings on spark

test spark option

annotate intentional lvalue substr

Advised against by perlcritic and PBP because of confusion and efficiency.
The latter seems contrary to actual benchmark results in v5.24-5.28,
where this form is at least 5% faster (even with a dummy length argument).

end subroutines with return

Stern perlcritic complaint, referencing page 197 of PBP.

code cleanup following some perlcritic warnings

Rules about mixed precedence, uninitialized local, and capture variable use
all improve clarity without disadvantages.

enable /x in all regular expressions

Enforce extended legibility as recommended by PBP page 236.

enable /ms in all regular expressions

Recommended options (PBP pages 237-241) for consistent behaviour.

stable enough version 1.07

postgresql client invocation example

Personal favourite to quickly visualise statistics.

rename remaining graph references in documentation

Commands still using the old name after the change in commit:
v1.03-0-g9cb7fa212a (2019-09-07) [hello barcat =^.^=]

document remaining color options

cleanup superfluous hide checks in show_lines()

Existing code duplicated in commit v1.03-16-g62a8af4725 (2019-09-08)
[stat (-s) option to summarise totals at end].

prepare decremented hidemin value

Avoid repeated calculation for cleaner code.

move subroutine sival() out of readline loop

Satisfy perlcritic complaint about being nested.

refer to bold as bright in black colour documentation

consistent documentation syntax of options

align long options in usage

abbreviate usage output

Modify pod document before formatting short usage lists to fit most options
on single lines, similar to and expected for most command line interfaces.

t: ignore t1801 warning missing Tie::Array::Sorted

Non-fatal message should not fail tests.

t: execute multiple arguments in shell wrapper

Support combined *.in filename with other parameters, so shell execution can
be applied on t1801-progress.

clean up common value range calculation

silence warning calculating size of zero values

test value parameters and option parsing

wrap long code lines to 80 characters

Some illegible oneliners crept in.

ignore interval option without input file

simplify users example code (s/sed/tr/)

lexical sub feature no longer required

Replaced by a variable in commit v1.06-4-gca702a0a92 (2019-09-24)
[customizable format for markers option].  Reverts v1.01-11-g754ddc0faf
(2019-09-05) [enable lexical subs before perl v5.26].

clean up doubly titled xml example

Line left after replacement in commit v1.04-1-ge8e86ee4ef (2019-09-10)
[reorder examples by complexity].

optional width of sparkline lines

Output newlines after specified number of records.
Keep current single line by default.

round total value slightly in statistics

Compensate for cumulative floating point errors showing up.

number of lines distinct from values in statistics

Indicate ignored (non-numeric) rows if any.  Unchanged otherwise.

t: filename shorthand '_?' to compare exit code

Make it easier to check for non-zero $? by replacing ' |[ $? = N ]' by ' ?N'
for same results with minimal clutter.

numeric inline parameters override value input

Commandline shorthand for simple manual entry with unambiguous numbers.

t: strip options from input file names

Ignore everything after underscore in output files, so input files do not
need to match irrelevant test options (source data can remain unchanged
regardless of further test variations).

t: optional input by omitting *.in files

Verify t0* work correctly without dummy input.

limit without arguments for all (statistics only)

value color in spark mode

spark values for minimum and maximum

Special case first and last matches like colors.

test color output

test more sine wave input

Longer range generated by perl -E 'say cos($_/8) for -3..96';

renumber first tests

integer sinewave test data input

Keep potential floating point complications for later tests.

width option fallback to tput

Environment variable is not exported on some systems.

extended palettes for 88-256 color terminals

Preset options for 88-color urxvt or 256-color xterm ea:
instead of 3 shades of whites, offers 12 in ramp88 and 23 in greys;
similarly increases 7 values of fire to 11 for fire88 and 17 for fire256.

named palette presets fire, whites

Inspired by <https://github.com/sindresorhus/sparkly>, a js spark port.
Different from its {style:'fire'} in being 16-color compatible and having
red at the lower end (matching lower temperature to low values).

distribute palette parameters over value range

test combined modifiers on currency input

test download examples (currency, earthquakes, pokemon)

minval/maxval options to override bar range

customizable format for markers option

palette option to customize value colors

colored header like values

header option to prepend value scale

Single top line to indicate minimum and maximum values, similar to scale in
common-lisp vspark <https://github.com/tkych/cl-spark>.

override version option to only show main program

Default Getopt::Long results include environment-specific details unlike
most other programs, maybe enforcing minimal details in some bug reports,
but making test output non-portable.

explain spark option parameters

document spark option

Added in commit v1.04-17-gf4423db967 (2019-09-10).

remove lower scan line from spark default

Unlike other spark implementations, an additional -lowest- character U+23BD
was added accidentally, which fits perfectly in Unifont, but may be very
unreliable in other fonts.

force exit on interrupt signal

Display everything even if pipe does not abort.

signal-stat option to override signal name

Try to please everybody (or in case of unknown environment differences).

prefer SIGINFO for statistics if available

A far more appropriate signal for non-quitting interrupts,
unfortunately only available on BSDs (bound to ctrl-T).

Keep fallback to SIGQUIT as support on linux does not seem imminent
:(http://lkml.iu.edu/hypermail/linux/kernel/1411.0/03374.html).

show statistics on SIGQUIT

Misuse this signal as it's the best suited on linux being usually bound to
ctrl-\.  The same behaviour can also be seen in at least ping from iputils.
GNU dd offers similar progress on SIGUSR1, but this cannot be bound by stty.

t: multiple command arguments

Worked around by bundling -t and -f in t1801, but will not always be
possible.

test for continuous progress option -t-1

graph-format option to change bar character

Set to # to revert back to v0.10 behaviour!

only ignore interrupt signal after input

Assume no input is an unpiped invocation a user tries to abort by ctrl-C.

progress after line count with negative --interval

respond to alarm signal regardless of interval

t: report missing output as TODO

TAP syntax to report expected failure.

t: replace shell scripts by pipe parameters in name

test unmarked, limits, stats, color

colored values in summary stats

increase value length for newline substitution

Off by one since inclusion of placeholders in commit v1.02-6-g05d1a75398
(2019-09-07) [value placeholder in contents].

t: colorize results on tty output

t: exit code reflects test failures

t: replace diff by comm for linewise comparison

Prevent skipped lines, assuming matching order is retained.
Similar output otherwise after prefix replacement.

test various formatting and options

documentation intro, info options

inline podexit code for --help, alias to -?

brief usage documentation reformatted from pod

Adjust pod text before and after rendering to better match other programs:
compact table of options described by only the first following line.

test inputless command behaviour

Start t00* by testing parameter handling.

test field selection and human readable output

test commands to compare usage output, prevent regeneration

Any corresponding *.sh is run for more complex tests, such as partial output
comparison for --usage results.  Does not have to be generated on -G, but
any existing files can be.

regenerate test output on regress.t -G option

parse options to regress.t

Reserve any parameters starting with a dash.
Show usage for unknown commands ie everything.

spaces and options in test file names

Replace underscores by spaces to facilitate human-readable titles in sane
file names, and apply parts following a space and dash ( -*) as command
parameters to allow testing of different options.

initial regression test suite

Simple script to run barcat with different input from *.in, comparing to
expected *.out files and returning results in TAP format.  Execution at
t/*.t for prove compatibility.

unmodified should avoid value alignment

customisable spark characters

Distributes over any number of unicode glyphs.  Hardcode interpreter for now
so -CA can be applied to easily decode arguments from UTF-8.

spark option to replace lines by single characters

Implement "sparklines" (one-line graph) by simply substituting Unicode block
elements U+2581-2588 relative to values.  Inspired by Zach Holman's `spark`
<https://github.com/holman/spark>.

earthquake feed example

As seen on <https://zachholman.com/spark/#cooler-usage>, but better suited
to demonstrate table markup.

date alternative on BSD variants including OSX

replace perl in example date parsing

Time::Piece was released with perl v5.8.9 but may not be installed on
restricted systems.  Hardcoding the number of days is less flexible but
"only" relies on a GNU date supporting -d.

Furthermore, git only supports date formatting since version 2.6.0,
so prefer an equivalent cut similar to earlier year selection.

additional git example for date history

Simplified version of a longtime alias of mine.

reset SIGINT after first ignoral

Ensure subsequent signals will break any unexpected hangs.