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, 14 insertions, 16 deletions

diff --git a/source/blender/freestyle/intern/python/Interface0D/ViewVertex/BPy_NonTVertex.cpp b/source/blender/freestyle/intern/python/Interface0D/ViewVertex/BPy_NonTVertex.cpp
index 9295e4f424b..ff53f5bfcbe 100644
--- a/source/blender/freestyle/intern/python/Interface0D/ViewVertex/BPy_NonTVertex.cpp
+++ b/source/blender/freestyle/intern/python/Interface0D/ViewVertex/BPy_NonTVertex.cpp
@@ -31,22 +31,20 @@ extern "C" {
 
 /*----------------------NonTVertex methods ----------------------------*/
 
-PyDoc_STRVAR(NonTVertex_doc,
-             "Class hierarchy: :class:`Interface0D` > :class:`ViewVertex` > :class:`NonTVertex`\n"
-             "\n"
-             "View vertex for corners, cusps, etc. associated to a single SVertex.\n"
-             "Can be associated to 2 or more view edges.\n"
-             "\n"
-             ".. method:: __init__()\n"
-             "\n"
-             "   Default constructor.\n"
-             "\n"
-             ".. method:: __init__(svertex)\n"
-             "\n"
-             "   Build a NonTVertex from a SVertex.\n"
-             "\n"
-             "   :arg svertex: An SVertex object.\n"
-             "   :type svertex: :class:`SVertex`");
+PyDoc_STRVAR(
+    NonTVertex_doc,
+    "Class hierarchy: :class:`Interface0D` > :class:`ViewVertex` > :class:`NonTVertex`\n"
+    "\n"
+    "View vertex for corners, cusps, etc. associated to a single SVertex.\n"
+    "Can be associated to 2 or more view edges.\n"
+    "\n"
+    ".. method:: __init__()\n"
+    "            __init__(svertex)\n"
+    "\n"
+    "   Builds a :class:`NonTVertex` using the default constructor or a :class:`SVertex`.\n"
+    "\n"
+    "   :arg svertex: An SVertex object.\n"
+    "   :type svertex: :class:`SVertex`");
 
 /* Note: No copy constructor in Python because the C++ copy constructor is 'protected'. */