document caveats for quoting functions; fix documentation indenting/wrapping.