Hi Jeff, After reading this document http://docutils.sourceforge.net/docs/user/rst/quickref.html I've made the following change: - Use regular lists ("- xyz") - Replace the weird \ **xyz** \ to ``xyz`` when used for verbatim text - Added/removed newlines and fixed EOL whitespace - Used links for sections references ("`THE SECTION`_") - Use definition lists for parameters: foo=bar desc desc desc. desc desc. I've already done mount.cifs.rst so far (attached). Feel free to use it in your patch. PS: it's Aurélien (you can drop the é but please keep the last e :)