fixed function headers in docs; minor cleanup