documentation of parameters
fix some error handling to be more fault tolerant.
Merge remote-tracking branch 'origin/1.4.5' into 1.4.6