remove obsolete code from api - add test to check no regression
update extamples
add some comments to the code
enhance api failure function
tweak comment
stop testing deprecated format_params function & test via the wrapper