Remove comment about semicolons for inner attributes from docs and adjust comments.
auto merge of #13920 : Ryman/rust/inner_attr_doc, r=alexcrichton

Also updated the comment for `parse_inner_attrs_and_next` and removed extra whitespace on line endings.