upon discussions, it was indicated that some of the apis that were
introduced in the commit e432c4d9 are not required. Leaving this behind
can misguide users in their configurations. Best course of action is to
remove them and introduce in the future if necessary.

also, minor fixes in error checking and documentation

Test: ./ultrahdr_unit_test