Document PyDoc_STR alongside PyDoc_STRVAR

bsolomon1124 · bsolomon1124 · commit c05b5bac74d6 · 2020-01-26T18:29:46.000-05:00
diff --git a/Doc/c-api/intro.rst b/Doc/c-api/intro.rst
@@ -177,10 +177,10 @@ complete listing.
 .. c:macro:: PyDoc_STRVAR(name, str)
 
    Creates a variable with name ``name`` that can be used in docstrings.
+   If Python is built without docstrings, the value will be empty.
 
-   Use the :c:macro:`PyDoc_STRVAR` or :c:macro:`PyDoc_STR` macros for
-   docstrings to support building Python without docstrings,
-   as specified in :pep:`7`.
+   Use :c:macro:`PyDoc_STRVAR` for docstrings to support building
+   Python without docstrings, as specified in :pep:`7`.
 
    Example::
 
@@ -192,6 +192,22 @@ complete listing.
           // ...
       }
 
+.. c:macro:: PyDoc_STR(str)
+
+   Creates a docstring for the given input string or an empty string
+   if docstrings are disabled.
+
+   Use :c:macro:`PyDoc_STR` in specifying docstrings to support
+   building Python without docstrings, as specified in :pep:`7`.
+
+   Example::
+
+      static PyMethodDef pysqlite_row_methods[] = {
+          {"keys", (PyCFunction)pysqlite_row_keys, METH_NOARGS,
+              PyDoc_STR("Returns the keys of the row.")},
+          {NULL, NULL}
+      };
+
 .. _api-objects:
 
 Objects, Types and Reference Counts
