various HDrawable refactors
update documentation