Mercurial > pylearn
diff doc/v2_planning/API_coding_style.txt @ 1173:a0f178bc9052
changes during the meeting
author | pascanur |
---|---|
date | Fri, 17 Sep 2010 16:12:33 -0400 |
parents | d7192e52653e |
children | fe6c25eb1e37 |
line wrap: on
line diff
--- a/doc/v2_planning/API_coding_style.txt Fri Sep 17 12:02:14 2010 -0400 +++ b/doc/v2_planning/API_coding_style.txt Fri Sep 17 16:12:33 2010 -0400 @@ -26,12 +26,12 @@ The four main documents describing our Python coding guidelines are: * `PEP 8 -- Style Guide for Python Code <http://www.python.org/dev/peps/pep-0008>`_ + * `Google Python Style Guide + <http://google-styleguide.googlecode.com/svn/trunk/pyguide.html>`_ * `PEP 257 -- Docstring Conventions <http://www.python.org/dev/peps/pep-0257>`_ * `Numpy Docstring Standard <http://projects.scipy.org/numpy/wiki/CodingStyleGuidelines#docstring-standard>`_ - * `Google Python Style Guide - <http://google-styleguide.googlecode.com/svn/trunk/pyguide.html>`_ However, there are a few points mentioned in those documents that we decided @@ -45,7 +45,8 @@ .. code-block:: python # Good. - """This is a multi-line docstring. + """ + This is a multi-line docstring. Which means it has more than one line. """ @@ -148,6 +149,7 @@ if (cond_1 and cond_2 and cond_3): + ... # Bad. if cond_1 and \