doc: Add inline documentation to interfaces and controller.

This simply add inline documentation.
OK, sounds good.  And yeah, that indentation does look pretty nasty... I will also go for 100 character line length.