From: Fred Drake <fdrake@acm.org>
Date: Mon, 15 Feb 1999 20:15:39 +0000 (+0000)
Subject: Be explicit about the reference count of the original value of the
X-Git-Tag: v1.5.2b2~58
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=66b989c80594dba22bcb2e3a37aefca1c8824414;p=python

Be explicit about the reference count of the original value of the
first parameter to PyString_Concat().
---

diff --git a/Doc/api/api.tex b/Doc/api/api.tex
index 58c2f45df7..02e31c925b 100644
--- a/Doc/api/api.tex
+++ b/Doc/api/api.tex
@@ -1737,8 +1737,12 @@ Resturns a \NULL{} terminated representation of the contents of \var{string}.
 
 \begin{cfuncdesc}{void}{PyString_Concat}{PyObject **string,
                                          PyObject *newpart}
-Creates a new string object in \var{*string} containing the contents
-of \var{newpart} appended to \var{string}.
+Creates a new string object in \var{*string} containing the
+contents of \var{newpart} appended to \var{string}.  The old value of
+\var{string} have its reference count decremented.  If the new string
+cannot be created, the old reference to \var{string} will still be
+discarded and the value of \var{*string} will be set to
+\NULL{}; the appropriate exception will be set.
 \end{cfuncdesc}
 
 \begin{cfuncdesc}{void}{PyString_ConcatAndDel}{PyObject **string,