From 28169cea3d722f699cba2503d3d9d99b096663af Mon Sep 17 00:00:00 2001 From: Campbell Barton Date: Tue, 8 Dec 2020 20:49:28 +1100 Subject: PyDoc: avoid blank lines at the beginning of code-examples --- doc/python_api/sphinx_doc_gen.py | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/doc/python_api/sphinx_doc_gen.py b/doc/python_api/sphinx_doc_gen.py index b148f4c6a46..930e5b88911 100644 --- a/doc/python_api/sphinx_doc_gen.py +++ b/doc/python_api/sphinx_doc_gen.py @@ -551,7 +551,7 @@ def example_extract_docstring(filepath): file.close() return "", 0 - for line in file.readlines(): + for line in file: line_no += 1 if line.startswith('"""'): break @@ -559,6 +559,13 @@ def example_extract_docstring(filepath): text.append(line.rstrip()) line_no += 1 + + # Skip over blank lines so the Python code doesn't have blank lines at the top. + for line in file: + if line.strip(): + break + line_no += 1 + file.close() return "\n".join(text), line_no -- cgit v1.2.3