Sometimes there are a LOT of records going through logging backends
which contain notable number of empty (i.e. undefined) fields. This
humble patch solemnly introduces new function `lager:pr/3` designed to
help cope with such kind of issues, providing a one and only option `compress`
which, when turned on, effectively eliminates any empty fields in records.

Finish lager API modifications
Update config API to handle multiple sinks
Identify areas where new code is yet to be written

First pass at adding sink parameter into the external API layer.

TODO:
* config updates
* loglevel changes per sink

Improve format_reason for certain oddly formed badarg stacktraces

Typos, add formatting, rework the semi-iolist description

add per-module per-function trace example

Fix/make trace stop trace api consistent cleanup

Add optional log_root environment variable

Mention the color atom for the formatter config

Fix specification of backend config in log rotation example

add application stop/start suppression for ct logs

Reviewed-by: seancribbs

in common test, starting and stopping applications can make your logs
very noisy.  the patch allows these messages to be suppressed on the
happy path, and raises the high water mark during ct tests so that
messages aren't dropped.

needs log level explicitly set

removed other handlers for common test bounces

Reviewed-by: seancribbs

Add maps support

Fix ct backend dialyzer warnings

Note that compiling on OTP 17.0, or later, will produce beam files
(specifically lager_trunc_io) that are incompatible with R16B03-1, or
earlier, due to erlang:is_map/1 using a new beam opcode (156). However
if compiled on R16B03-1, or earlier, will produce beams files that are
compatible with 17.0, and later, and maps will be formatted where
supported by the active OTP release.

* Fix unmatched return
* Fix set_loglevel call to store mask in state
* Add common_test to plt for ct:pal spec

The example in "Internal log rotation" includes the tuple
{name, "error.log"}

This apparently should be

{file, "error.log"}

as seen in other config examples in README.md.

lager_common_test_backend

fix issue #215: lager.app env overwrites default handlers