cleanup headings

Remove period at end of headings and don't precede each and every
heading with ^L.
replace it's with its in doc-strings