docs, code and fix for taint mode and library paths

Signed-off-by: Roy Storey <roy.storey@plantandfood.co.nz>