Changes between Version 5 and Version 6 of ChimeraPythonStyle

Timestamp:

Feb 2, 2011, 11:33:11 AM (15 years ago)

Author:

Darren Weber

Comment:

--

ChimeraPythonStyle

@@ -1 +1 @@
 
-== Chimera Python Style Guide ==
+== Chimera Python Styles ==
 
-There is no generally accepted convention for python coding style in Chimera.  I follow an interpretation of the python style guidelines by Guido, see the snippet below and the full spiel at: http://www.python.org/dev/peps/pep-0008/
+There is specific convention for python coding style in Chimera.  Developers are free to use a familiar coding style, so long as it is consistent.  To follow a familar and consistent style, I've adopted the python style guidelines by Guido (see [http://www.python.org/dev/peps/pep-0008/ PEP8]).
 
-My style is 4 spaces for each indentation level (no tabs).  My .vimrc contains:
+The style is 4 spaces for each indentation level (no tabs).  It can be coded into a .vimrc like so:
 {{{
-" global settings
-set tabstop=4
-set shiftwidth=4
-set expandtab
 " python settings
 autocmd BufRead,BufNewFile *.py set ft=python ai sw=4 ts=4 sta et fo=croql foldmethod=indent
 }}}
 
-It's possible to insert a mode line into each file to override user editor settings.  The first line of the file might contain something like this (which should work for both emacs and vim):
+It's also possible to insert a mode line into the first line of a python file to override any editor settings.  The first line of the file might contain something like this (which should work for both emacs and vim):
 {{{
 # -*- coding: utf-8; mode: python; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- vim:fenc=utf-8:ft=python:et:sw=4:ts=4:sts=4:fdm=indent:fo+=croql
 }}}
 
-Note that the encoding (coding) is utf-8 here, which is recommended for python 3.x, but earlier versions are recommended to use ISO-8859-1, so the PEP8 recommends a mode line like this:
+Note that the encoding (coding) is utf-8 above, which is recommended for python 3.x, while python 2.x recommends ISO-8859-1, e.g.:
 {{{
 # -*- coding: ISO-8859-1; mode: python; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- vim:fenc=ISO-8859-1:ft=python:et:sw=4:ts=4:sts=4