fix whitespace
examples: put in more general meta info again

...with examples to the own project on github.
examples: less picky about vendor

...to make development on different vendors
less surprising.
autoreport: more mime types as binary
autoreport: rename function hook name

main_after_hook -> main_end_hook
autoreport: doc++ for function hooks
bash-test-utils: whitespace cleanup
bash-test-utils: re-introduce EXIT_ON_SKIPALL

A feature from autoreport that got lost here.
bash-test-utils: new function for one-time variables init

...as most other functions are called twice,
once during include/source and once again
on done_testing, which is a legacy of the
usage model from tapper-autoreport but makes
sense sometimes and is kept to keep both
libs more in sync.
bash-test-utils: rename (ltu_)suite_meta

Make this function sounding less private to look
better on later hooks feature.
bash-test-utils: run_hook() function

...to execute 'include hooks' - files to be
'source'd at different places so that you can
extend the functionality of 'bash-test-utils'
with non-generic features.

The most prominent feature will be a tapper/ hooks
directory which re-introduces features from autoreport
into bash-test-utils.
bash-test-utils: re-introduce meta info headers

These meta info headers are useful and got dropped
when it bash-test-utils got forked from autoreport.
bash-test-utils: whitespace
bash-test-utils: introduce a file_upload()

This is not really a direct file upload but more
a mark-up of files to be uploaded iff te TAP report
is packed into an archive for later sending to
a TAP database, like Tapper.

In that case the files marked with upload_file() are
added to that package and are later uploaded.

That is essentially the functionality from tapper-autoreport
but with a de-coupling of execution time and upload time.
bash-test-utils: rename function hook name

main_after_hook -> main_end_hook

And drop some superfluous progress output
which will be done differently now.
bash-test-utils: split done_testing()

...into two variants:

 - _to_stdout  ... the original way of direct output
 - _to_file    ... pack TAP and files into an archive
bash-test-utils: exit with EXITCODE=failcounter

Counts the 'not ok ' lines and provides that value
as exit code if PROVIDE_EXITCODE=1 is set.
bash-test-utils: call hook 'functions'

...if hooks should be called and the hook
exists.

Several other hook calls are hidden in other
commits just added minutes ago.
bash-test-utils: VERSION++

Not that this version would mean anything...
bash-test-utils: documentation++

Docmuent new features:

 - hooks
 - new env variables
 - upload_file
 - exit code behaviour