add footnote to comments
more doc changes