Document new interfaces

* NEWS: Update.
* doc/ref/api-io.texi (Bytevector Ports): Add docs.

diff --git a/NEWS b/NEWS
index 6f4f6dac701a4d962bb6c9038b857a1c7f641fc1..234885d4d50a9e3e37043ce06a19f03d4052e2c1 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -4,6 +4,27 @@ See the end for copying conditions.
 
 Please send Guile bug reports to bug-guile@gnu.org.
 
+\f
+Changes in 3.0.6 (since 3.0.5)
+
+* New interfaces and functionality
+
+** `call-with-port'
+
+See "Ports" in the manual.
+
+** `call-with-input-bytevector', `call-with-output-bytevector'
+
+See "Bytevector Ports" in the manual.
+
+* Incompatible changes
+
+** `call-with-output-string' closes port on normal exit
+
+This procedure used to leave the port open, even though there was no
+useful way to access it.  Now we clean it up more promptly, disposing
+any possible associated iconv descriptor.
+
 \f
 Changes in 3.0.5 (since 3.0.4)
 

diff --git a/doc/ref/api-io.texi b/doc/ref/api-io.texi
index 50296057f9e90f13397b510eb01ac450ad9aa653..777f282e99c2d39faca1d4478bfe9f43492cd56e 100644 (file)
--- a/doc/ref/api-io.texi
+++ b/doc/ref/api-io.texi
@@ -1166,6 +1166,19 @@ the data accumulated by the port, as illustrated below.
 The @var{transcoder} argument is currently not supported.
 @end deffn
 
+@deffn {Scheme Procedure} call-with-output-bytevector proc
+Call the one-argument procedure @var{proc} with a newly created
+bytevector output port.  When the function returns, the bytevector
+composed of the characters written into the port is returned.
+@var{proc} should not close the port.
+@end deffn
+
+@deffn {Scheme Procedure} call-with-input-bytevector bytevector proc
+Call the one-argument procedure @var{proc} with a newly created input
+port from which @var{bytevector}'s contents may be read.  The values
+yielded by the @var{proc} is returned.
+@end deffn
+
 
 @node String Ports
 @subsubsection String Ports