Doc update

This is based atop the hawk branch.

Update the documentation with the new APIs and hawk support.
put uppercase ?