Documentation comment changes.

Documentation comment changes after reviewing Doxygen output. Minor
identifier change in pin_id.h PIN -> Pin