gh-113560: Improve docstrings for set.issubset() and set.issuperset() (GH-113562)

CharlieZhao95 · web-flow · commit 11c582235d86 · 2024-01-27T09:53:01.000Z
diff --git a/Objects/setobject.c b/Objects/setobject.c
@@ -1770,7 +1770,11 @@ set_issubset(PySetObject *so, PyObject *other)
     Py_RETURN_TRUE;
 }
 
-PyDoc_STRVAR(issubset_doc, "Report whether another set contains this set.");
+PyDoc_STRVAR(issubset_doc,
+"issubset($self, other, /)\n\
+--\n\
+\n\
+Test whether every element in the set is in other.");
 
 static PyObject *
 set_issuperset(PySetObject *so, PyObject *other)
@@ -1802,7 +1806,11 @@ set_issuperset(PySetObject *so, PyObject *other)
     Py_RETURN_TRUE;
 }
 
-PyDoc_STRVAR(issuperset_doc, "Report whether this set contains another set.");
+PyDoc_STRVAR(issuperset_doc,
+"issuperset($self, other, /)\n\
+--\n\
+\n\
+Test whether every element in other is in the set.");
 
 static PyObject *
 set_richcompare(PySetObject *v, PyObject *w, int op)
