update doc for retina functionality
put citation in same format as it appears in a latex rendered article
fixed other sphinx warnings
Merge pull request #549 from goodfeli/doc_retina

update doc for retina functionality