Documentation updates to camera HAL interfaces. am: 48f3952ffc
am: cf1fd4de74

Change-Id: I851b8dc19b70048389823d7b8c74035844f07c45