Cleanup the template some

* The modeline at top just mentions file encoding since python uses
  that. Rest of the options should be set in syntax files.
* Mix in some rst style documentation to show the differences.