From 6a350fd788f3114629c9993aa4d1ec5c292182f5 Mon Sep 17 00:00:00 2001
From: Kaz Kylheku <kaz@kylheku.com>
Date: Fri, 10 Apr 2015 22:18:50 -0700
Subject: Functions open-fileno and fileno.

* stream.c (fd_k): New keyword variable.
(stdio_get_prop): Handle the :fd property by returning
the file descriptor.
(open_fileno): New function.
(stream_init): Initialize fd_k, and register fileno and open-fileno.

* stream.h (open_fileno): Declared.

* txr.1: Documented open-fileno and fileno.

* utf8.c (w_fdopen): New function.

* utf8.h (w_fdopen): Declared.
---
 txr.1 | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

(limited to 'txr.1')

diff --git a/txr.1 b/txr.1
index 5dd3e1f5..4537885c 100644
--- a/txr.1
+++ b/txr.1
@@ -24816,6 +24816,42 @@ or
 .codn nil ,
 rather than zero or nonzero. The others return integer values.
 
+.SS* Unix File Descriptors
+
+.coNP Function @ open-fileno
+.synb
+.mets (open-fileno < file-descriptor <> [ mode-string ])
+.syne
+The
+.code open-fileno
+function creates a \*(TX stream over a file descriptor. The
+.meta file-descriptor
+argument must be an integer denoting a valid file descriptor.
+
+For a description of
+.metn mode-string ,
+see the
+.code open-file
+function.
+
+.coNP Function @ fileno
+.synb
+.mets (fileno << stream )
+.syne
+.desc
+The
+.code fileno
+function returns the underlying file descriptor of
+.metn stream ,
+if it has one. Otherwise, it returns
+.codn nil.
+
+This is equivalent to querying the stream using
+.code stream-get-prop
+for the
+.code :fd
+property.
+
 .SS* Unix Itimers
 Itimers ("interval timers") can be used in combination with signal handling to
 execute asynchronous actions. Itimers deliver delayed, one-time signals,
-- 
cgit v1.2.3