Revert "whitespace cleanup. removing confusing comment. misc cleanup."

This reverts commit a9ffdd49864a420de1cbdab26759faaf093364e6.
Revert "adding complete known attribute list to docs"

This reverts commit 069b0e3bddeeff310a1809f46c83c1f3f978dc67.