BUG: Allow no . at end if indented

numpydoc/tests/test_validate.py

@@ -36,7 +36,10 @@ def plot(self, kind, color="blue", **kwargs):
         Parameters
         ----------
         kind : str
-            Kind of matplotlib plot.
+            Kind of matplotlib plot, e.g.::
+
+                'foo'
+
         color : str, default 'blue'
             Color name or rgb code.
         **kwargs
@@ -89,7 +92,9 @@ def sample(self):
         Returns
         -------
         float
-            Random number generated.
+            Random number generated, e.g.::
+
+                1.0
 
         See Also
         --------

numpydoc/validate.py

@@ -257,10 +257,13 @@ def extended_summary(self):
 
     @property
     def doc_parameters(self):
+        return self._get_doc_parameters()
+
+    def _get_doc_parameters(self, joiner=""):
         parameters = collections.OrderedDict()
         for names, type_, desc in self.doc["Parameters"]:
             for name in names.split(", "):
-                parameters[name] = (type_, "".join(desc))
+                parameters[name] = (type_, joiner.join(desc))
         return parameters
 
     @property
@@ -329,8 +332,8 @@ def directives_without_two_colons(self):
     def parameter_type(self, param):
         return self.doc_parameters[param][0]
 
-    def parameter_desc(self, param):
-        desc = self.doc_parameters[param][1]
+    def parameter_desc(self, param, joiner=""):
+        desc = self._get_doc_parameters(joiner)[param][1]
         # Find and strip out any sphinx directives
         for directive in DIRECTIVES:
             full_directive = ".. {}".format(directive)
@@ -541,12 +544,16 @@ def validate(func_name):
                                 wrong_type=wrong_type,
                             )
                         )
-        if not doc.parameter_desc(param):
+        this_desc = doc.parameter_desc(param, "\n").rstrip("\n")
+        if not this_desc:
             errs.append(error("PR07", param_name=param))
         else:
-            if doc.parameter_desc(param)[0].isalpha() and not doc.parameter_desc(param)[0].isupper():
+            if this_desc[0].isalpha() and not this_desc[0].isupper():
                 errs.append(error("PR08", param_name=param))
-            if doc.parameter_desc(param)[-1] != ".":
+            # Not ending in "." is only an error if the last bit is not
+            # indented (e.g., quote or code block)
+            if this_desc[-1] != "." and \
+                    not this_desc.split("\n")[-1].startswith(" "):
                 errs.append(error("PR09", param_name=param))
 
     if doc.is_function_or_method:
@@ -560,10 +567,11 @@ def validate(func_name):
                 if not desc:
                     errs.append(error("RT03"))
                 else:
-                    desc = " ".join(desc)
+                    desc = "\n".join(desc)
                     if desc[0].isalpha() and not desc[0].isupper():
                         errs.append(error("RT04"))
-                    if not desc.endswith("."):
+                    if not desc.endswith(".") and \
+                            not desc.split("\n")[-1].startswith(" "):
                         errs.append(error("RT05"))
 
         if not doc.yields and "yield" in doc.method_source: