code documentation.  no functional changes