Pydoc: Fix sphinx compile warnings about freestyle

Sphinx expects functions and methods with the same name and different
parameters to be written using one directive. See:
https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#basic-markup

Unfortunately this makes giving different descriptions for each harder.
This was already a request for better support for this in sphinx, see:
https://github.com/sphinx-doc/sphinx/issues/7787

Reviewed By: campbellbarton

Differential Revision: https://developer.blender.org/D9170

1 files changed, 4 insertions, 10 deletions

diff --git a/source/blender/freestyle/intern/python/Iterator/BPy_AdjacencyIterator.cpp b/source/blender/freestyle/intern/python/Iterator/BPy_AdjacencyIterator.cpp
index 90e751333b9..dc32b73fda1 100644
--- a/source/blender/freestyle/intern/python/Iterator/BPy_AdjacencyIterator.cpp
+++ b/source/blender/freestyle/intern/python/Iterator/BPy_AdjacencyIterator.cpp
@@ -41,20 +41,14 @@ PyDoc_STRVAR(
     "traverse() method of the ChainingIterator.\n"
     "\n"
     ".. method:: __init__()\n"
+    "            __init__(brother)\n"
+    "            __init__(vertex, restrict_to_selection=True, restrict_to_unvisited=True)\n"
     "\n"
-    "   Default constructor.\n"
-    "\n"
-    ".. method:: __init__(brother)\n"
-    "\n"
-    "   Copy constructor.\n"
+    "   Builds an :class:`AdjacencyIterator` using the default constructor,\n"
+    "   copy constructor or the overloaded constructor.\n"
     "\n"
     "   :arg brother: An AdjacencyIterator object.\n"
     "   :type brother: :class:`AdjacencyIterator`\n"
-    "\n"
-    ".. method:: __init__(vertex, restrict_to_selection=True, restrict_to_unvisited=True)\n"
-    "\n"
-    "   Builds a AdjacencyIterator object.\n"
-    "\n"
     "   :arg vertex: The vertex which is the next crossing.\n"
     "   :type vertex: :class:`ViewVertex`\n"
     "   :arg restrict_to_selection: Indicates whether to force the chaining\n"