patch: some more documentation fixes

[Patrick Pelletier]

Here is a commit with some various documentation and comment  
nitpicks.  I've attached the output of "git format-patch" as an  
attachment to this message; I think that worked successfully the last  
time I submitted one of these.

--Patrick

-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-documentation-and-comment-fixes.patch
Type: application/octet-stream
Size: 8893 bytes
Desc: not available
URL: </pipermail/attachments/20120421/47d87704/attachment.obj>
-------------- next part --------------