miss-islington
diff --git a/‎Doc/c-api/marshal.rst
Copy file name to clipboardExpand all lines: Doc/c-api/marshal.rst
+4Lines changed: 4 additions & 0 deletions b/‎Doc/c-api/marshal.rst
Copy file name to clipboardExpand all lines: Doc/c-api/marshal.rst
+4Lines changed: 4 additions & 0 deletions
diff --git a/‎Python/marshal.c
Copy file name to clipboardExpand all lines: Python/marshal.c
+4Lines changed: 4 additions & 0 deletions b/‎Python/marshal.c
Copy file name to clipboardExpand all lines: Python/marshal.c
+4Lines changed: 4 additions & 0 deletions
@@ -25,12 +25,16 @@ unmarshalling.  Version 2 uses a binary format for floating point numbers.
    the least-significant 32 bits of *value*; regardless of the size of the
    native :c:expr:`long` type.  *version* indicates the file format.
 
+   This function can fail, in which case it sets the error indicator.
+   Use :c:func:`PyErr_Occurred` to check for that.
 
 .. c:function:: void PyMarshal_WriteObjectToFile(PyObject *value, FILE *file, int version)
 
    Marshal a Python object, *value*, to *file*.
    *version* indicates the file format.
 
+   This function can fail, in which case it sets the error indicator.
+   Use :c:func:`PyErr_Occurred` to check for that.
 
 .. c:function:: PyObject* PyMarshal_WriteObjectToString(PyObject *value, int version)
 
 
@@ -625,6 +625,10 @@ w_clear_refs(WFILE *wf)
 }
 
 /* version currently has no effect for writing ints. */
+/* Note that while the documentation states that this function
+ * can error, currently it never does. Setting an exception in
+ * this function should be regarded as an API-breaking change.
+ */
 void
 PyMarshal_WriteLongToFile(long x, FILE *fp, int version)
 {
Original file line number	Diff line number	Diff line change
`@@ -625,6 +625,10 @@ w_clear_refs(WFILE *wf)`
`625`	`625`	`}`
`626`	`626`
`627`	`627`	`/* version currently has no effect for writing ints. */`
	`628`	`+/* Note that while the documentation states that this function`
	`629`	`+ * can error, currently it never does. Setting an exception in`
	`630`	`+ * this function should be regarded as an API-breaking change.`
	`631`	`+ */`
`628`	`632`	`void`
`629`	`633`	`PyMarshal_WriteLongToFile(long x, FILE *fp, int version)`
`630`	`634`	`{`