Added docs and tidy up

Author: Nurdok

docs/release_notes.rst

@@ -13,11 +13,16 @@ New Features
   classes are considered public if their names are not prepended with an
   underscore and if their parent class is public, recursively (#13, #146).
 
+* Added the D403 error code - "First word of the first line should be
+  properly capitalized". This new error is turned on by default (#164, #165).
 
 Bug Fixes
 
-* Fixed an issue where a `NameError` was raised when parsing complex defintions
-  of `__all__` (#142, #143).
+* Fixed an issue where a ``NameError`` was raised when parsing complex defintions
+  of ``__all__`` (#142, #143).
+
+* Fixed a bug where D202 was falsely reported when a function with just a
+  docstring and no content was followed by a comment (#165).
 
 
 0.7.0 - October 9th, 2015
@@ -26,21 +31,21 @@ Bug Fixes
 New Features
 
 * Added the D104 error code - "Missing docstring in public package". This new
-  error is turned on by default. Missing docstring in `__init__.py` files which
+  error is turned on by default. Missing docstring in ``__init__.py`` files which
   previously resulted in D100 errors ("Missing docstring in public module")
   will now result in D104 (#105, #127).
 
 * Added the D105 error code - "Missing docstring in magic method'. This new
   error is turned on by default. Missing docstrings in magic method which
   previously resulted in D102 error ("Missing docstring in public method")
   will now result in D105. Note that exceptions to this rule are variadic
-  magic methods - specifically `__init__`, `__call__` and `__new__`, which
+  magic methods - specifically ``__init__``, ``__call__`` and ``__new__``, which
   will be considered non-magic and missing docstrings in them will result
   in D102 (#60, #139).
 
 * Support the option to exclude all error codes. Running pep257 with
-  `--select=` (or `select=` in the configuration file) will exclude all errors
-  which could then be added one by one using `add-select`. Useful for projects
+  ``--select=`` (or ``select=`` in the configuration file) will exclude all errors
+  which could then be added one by one using ``add-select``. Useful for projects
   new to pep257 (#132, #135).
 
 * Added check D211: No blank lines allowed before class docstring. This change

src/pep257.py

@@ -133,10 +133,10 @@ def source(self):
         """Return the source code for the definition."""
         full_src = self._source[self._slice]
 
-        def predicate(line):
+        def is_empty_or_comment(line):
             return line.strip() == '' or line.strip().startswith('#')
 
-        filtered_src = dropwhile(predicate, reversed(full_src))
+        filtered_src = dropwhile(is_empty_or_comment, reversed(full_src))
         return ''.join(reversed(list(filtered_src)))
 
     def __str__(self):
@@ -689,8 +689,6 @@ def to_rst(cls):
                          '%r, not %r')
 D402 = D4xx.create_error('D402', 'First line should not be the function\'s '
                                  '"signature"')
-D402 = D4xx.create_error('D402', 'First line should not be the function\'s '
-                                 '"signature"')
 D403 = D4xx.create_error('D403', 'First word of the first line should be '
                                  'properly capitalized', '%r, not %r')