guile/guile-doc/ref ChangeLog posix.texi

[Gary Houston]

CVSROOT:        /cvs
Module name:    guile
Changes by:     Gary Houston <address@hidden>   00/11/09 14:49:00

Modified files:
        guile-doc/ref  : ChangeLog posix.texi 

Log message:
        2000-11-09  Gary Houston  <address@hidden>
        
        * posix.texi (Ports and File Descriptors): updated
        close-all-ports-except.
        
        2000-11-07  Gary Houston  <address@hidden>
        
        * posix.texi (Ports and File Descriptors): added dup2, close-fdes
        and port-for-each.
        (Pipes): synchronise open-input-pipe, open-output-pipe with
        popen.scm.

CVSWeb URLs:
http://subversions.gnu.org/cgi-bin/cvsweb/guile/guile-doc/ref/ChangeLog.diff?r1=1.76&r2=1.77
http://subversions.gnu.org/cgi-bin/cvsweb/guile/guile-doc/ref/posix.texi.diff?r1=1.16&r2=1.17

Patches:
Index: guile/guile-doc/ref/ChangeLog
diff -u guile/guile-doc/ref/ChangeLog:1.76 guile/guile-doc/ref/ChangeLog:1.77
--- guile/guile-doc/ref/ChangeLog:1.76  Sat Nov  4 15:26:59 2000
+++ guile/guile-doc/ref/ChangeLog       Thu Nov  9 14:49:00 2000
@@ -1,3 +1,15 @@
+2000-11-09  Gary Houston  <address@hidden>
+
+       * posix.texi (Ports and File Descriptors): updated
+       close-all-ports-except.
+
+2000-11-07  Gary Houston  <address@hidden>
+
+       * posix.texi (Ports and File Descriptors): added dup2, close-fdes
+       and port-for-each.
+       (Pipes): synchronise open-input-pipe, open-output-pipe with
+       popen.scm.
+
 2000-11-04  Gary Houston  <address@hidden>
 
        * scheme.texi (Generic Port Operations): "port?" added.
Index: guile/guile-doc/ref/posix.texi
diff -u guile/guile-doc/ref/posix.texi:1.16 guile/guile-doc/ref/posix.texi:1.17
--- guile/guile-doc/ref/posix.texi:1.16 Fri Oct  6 08:58:07 2000
+++ guile/guile-doc/ref/posix.texi      Thu Nov  9 14:49:00 2000
@@ -274,6 +274,15 @@
 their revealed counts set to zero.
 @end deffn
 
address@hidden docstring begin (texi-doc-string "guile" "close-fdes")
address@hidden primitive close-fdes fd
+A simple wrapper for the @code{close} system call.
+Close file descriptor @var{fd}, which must be an integer.
+Unlike close (@pxref{Ports and File Descriptors, close}),
+the file descriptor will be closed even if a port is using it.
+The return value is unspecified.
address@hidden deffn
+
 @c docstring begin (texi-doc-string "guile" "unread-char")
 @deffn primitive unread-char char [port]
 Place @var{char} in @var{port} so that it will be read by the
@@ -371,6 +380,18 @@
 revealed counts.
 @end deffn
 
address@hidden docstring begin (texi-doc-string "guile" "dup2")
address@hidden primitive dup2 oldfd newfd
+A simple wrapper for the @code{dup2} system call.
+Copies the file descriptor @var{oldfd} to descriptor
+number @var{newfd}, replacing the previous meaning
+of @var{newfd}.  Both @var{oldfd} and @var{newfd} must
+be integers.
+Unlike for dup->fdes or primitive-move->fdes, no attempt
+is made to move away ports which are using @var{newfd}.
+The return value is unspecified.
address@hidden deffn
+
 @c docstring begin (texi-doc-string "guile" "port-mode")
 @deffn primitive port-mode port
 Returns the port modes associated with the open port @var{port}.  These
@@ -381,10 +402,18 @@
 
 @c docstring begin (texi-doc-string "guile" "close-all-ports-except")
 @deffn primitive close-all-ports-except . ports
-Close all open file ports used by the interpreter
+[DEPRECATED] Close all open file ports used by the interpreter
 except for those supplied as arguments.  This procedure
-is intended to be used before an exec call to close file descriptors
-which are not needed in the new process.
+was intended to be used before an exec call to close file descriptors
+which are not needed in the new process.  However it has the
+undesirable side-effect of flushing buffes, so it's deprecated.
+Use port-for-each instead.
address@hidden deffn
+
address@hidden docstring begin (texi-doc-string "guile" "port-for-each")
address@hidden primitive port-for-each proc
+Apply @var{proc} to each port in the Guile port table
+in turn.  The return value is unspecified.
 @end deffn
 
 @c docstring begin (texi-doc-string "guile" "setvbuf")
@@ -1497,11 +1526,11 @@
 @end deffn
 
 @deffn procedure open-input-pipe command
-Equivalent to @code{(open-pipe command OPEN_READ)}.
+Equivalent to @code{open-pipe} with mode @code{OPEN_READ}.
 @end deffn
 
 @deffn procedure open-output-pipe command
-Equivalent to @code{(open-pipe command OPEN_WRITE)}.
+Equivalent to @code{open-pipe} with mode @code{OPEN_WRITE}.
 @end deffn
 
 @findex pclose