misc. inline doc updates