API DOC generation issues fixed

1. Some handler class definitions are fixed.
2. API DOC generation issues fixed (listed in corresponding bug description).
3. Some API DOC generation tests are added.

Closes-Bug: #1262680

Change-Id: I52e7254b6f405b07e77a1dc79155445f24d6288a