version 1.09 before adding even more complex features

database examples compatible with sqlite

Real life use cases.

Commandline SQL changed to apply to SQLite as well.  Unfortunately maths
requires v3.35, so keep psql there even though it requires user setup.

distinguish column -n argument in examples

Required in common 4.3BSD version, but entirely incompatible with the
linux-util replacement on at least modern Debian.

explain -w default (COLUMNS environment)

t: untested formatting/marker features

t/examples: optional sample/media as exiftool input

t/examples: skip downloads unless enabled

Alleviate external resources further unless sample/data exists.

t/examples: skip missing command dependencies

Assume requirement at line start, and not a mistake if not found locally.

t/examples: record resulting output for review

t/examples: test and save curl downloads

make install rule to copy to /usr/local/bin

combined value and sum formatting, --reformat

Apply value-format to all stat values; exception to keep unformatted input
indicated by an experimental reformat option.

length padding on formatted values

reserve minimal length for -H formatting

Without a more expensive calculation, assume regular results of 3 digits and
a unit, without sign and exponent for which the reserved amount would still
be insufficient.

support negative sexagesimal times

Work around perl's weird modulo op.

sexagesimal time formatting option

Convert duration values from previous examples; like ffprobe -sexagesimal.

compare media example (exiftool, ffprobe)

Personal use case featuring two popular tools with different strengths and
interfaces.

Omit a third alternative with similar results due to being objectively much
worse in my experience:

mediainfo --inform='General;%Duration% %OverallBitRate% %FileNameExtension%\n' *

shorthand -f+ for first number (+0)

prefix + to select numeric fields in -f

Possible using regular expressions, but needlessly complex for such a common
use or desire.

swap -C to enable color, -M to disable

Inconsistent in other programs, but lets copy somewhat related `jq` instead.
Afaict mostly `watch` has -c, and that's for input interpretation.
Frees lowercase c for Count or Column.

NO_COLOR environment as default --color

Popular standard explained on: https://no-color.org/

restrict spark index to maximum value

treat zero as non-empty spark value

protest against unknown palette presets

rotate sparkless indicators default

random palette of 215 colours

Distinguish a limited number of values without regard for order.

rainbow (lolcat) colour palette

retire 88-colour palettes

Assume 256color terminals nowadays; even Debian's oldstable rxvt-unicode has
switched defaults.

simplify or clean up example scriptlets

crop limits beyond available lines

Silence warnings about unitialized values.

prefix indicators option without spark

full distribution over sparkline indicators

No unexpected min/max exceptions.

prepare to fix spark distribution

Test case which is seriously broken rn.

version 1.08 with extra cat

draw mascot cat in usage message

move sparkline example below interrupted git group

empty program arguments do not need to be parsed

Using Getopt::Long takes ~the same time as running the rest of the script,
about 250ms on a rpi1, so runtime can be halved if there's no options.

t: planned test count beforehand

Small effort to indicate units size, allowing rough eta estimation.

unit rounding corner case

Earlier commits did not account for odd unit offsets with one less digit
like 9950 rounding to 10.0k (or 9.9k with the previous fix) instead of 10k.

unit formatting of negatives

keep valueless lines as is

No padding or graph (from negative minimums).

shift unit to prevent additional digits after rounding

Fix 0.9995 from showing up as 1000m instead of 1.0.

static usage text, generation code into reformat-podusage script

Significantly faster and less convoluted, at the small cost of tracking some
documentation twice.

t: ensure failure if field gets fed an invalid regexp value

negative limit range counting from end

negative limit counts from last line

t: planned feature for negative limits

Do not count names ending in #TODO as failing.

apply value formatting to statistics

ascii option to avoid unicode

capture error messages from examples

IPC::Run to run example commands

declare value formatting functions in options

round partial sum to avoid floating point errors

Optional value available since commit v1.03-19-g0938debbad (2019-09-08)
[indicate limited results in stats] was overlooked while fixing formatting
in v1.06-24-g28f38df922 (2019-10-08) [round total value in statistics].

comment long regexp in usage preparation

Insert whitespace and comments for readability.

strip pipe arguments from test options

Allow combination of -value and |command (or ?status) suffixes,
without the latter part being duplicated.

follow download redirects in example scripts

Found by examples.t tester because curl commands were literally incomplete.

custom diagnostics in example test failure

Replace constant "Failed test at line" by a more interesting report of
source location and result discrepancy.

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