revise how category building is done
make example more like SYNOPSIS
add a simple test
move example into t/lib
improve documentation
bump Changes