manual: Various fixes and improvements

These are mostly small issues I found as I worked through the manual. I also changed the strings of a few examples to something that I thought made the feature being demonstrated more obvious and added a description for docstrings, which I took from #939 (closed).