Fix grammar in comment
More doc cleanup to replace =item with =head{2,3}