From 8c46b30e0a9dc91b56cec1d1204069c47a64f217 Mon Sep 17 00:00:00 2001
From: "Andrew M. Kuchling" <amk@amk.ca>
Date: Thu, 13 Jul 2000 23:58:16 +0000
Subject: [PATCH] Document PyObject_AsFileDescriptor

---
 Doc/api/api.tex       | 7 +++++++
 Doc/api/refcounts.dat | 3 +++
 2 files changed, 10 insertions(+)

diff --git a/Doc/api/api.tex b/Doc/api/api.tex
index 31ba95ee4b3..367cb065b96 100644
--- a/Doc/api/api.tex
+++ b/Doc/api/api.tex
@@ -1419,6 +1419,13 @@ failure. This is the equivalent of the Python statement \samp{del
 \var{o}[\var{key}]}.
 \end{cfuncdesc}
 
+\begin{cfuncdesc}{int}{PyObject_AsFileDescriptor}{PyObject *o}
+Derives a file-descriptor from a Python object.  If the object
+is an integer or long integer, its value is returned.  If not, the
+object's \method{fileno()} method is called if it exists; the method
+must return an integer or long integer, which is returned as the file
+descriptor value.  Returns \code{-1} on failure.
+\end{cfuncdesc}
 
 \section{Number Protocol \label{number}}
 
diff --git a/Doc/api/refcounts.dat b/Doc/api/refcounts.dat
index be4651893a8..c31d3b379f7 100644
--- a/Doc/api/refcounts.dat
+++ b/Doc/api/refcounts.dat
@@ -539,6 +539,9 @@ PyNumber_Xor:PyObject*:o2:0:
 PyOS_GetLastModificationTime:long:::
 PyOS_GetLastModificationTime:char*:filename::
 
+PyObject_AsFileDescriptor:int::: 
+PyObject_AsFileDescriptor:PyObject*:o:0:
+
 PyObject_CallFunction:PyObject*::+1:
 PyObject_CallFunction:PyObject*:callable_object:0:
 PyObject_CallFunction:char*:format::