From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Kevin Ryde Newsgroups: gmane.lisp.guile.devel Subject: doco write and display Date: Sun, 04 May 2003 09:07:18 +1000 Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Message-ID: <871xzfmxy1.fsf@zip.com.au> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: main.gmane.org 1052003328 28403 80.91.224.249 (3 May 2003 23:08:48 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sat, 3 May 2003 23:08:48 +0000 (UTC) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Sun May 04 01:08:46 2003 Return-path: Original-Received: from monty-python.gnu.org ([199.232.76.173]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19C67a-0007Ny-00 for ; Sun, 04 May 2003 01:08:46 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19C67f-0006ME-00 for guile-devel@m.gmane.org; Sat, 03 May 2003 19:08:51 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 19C677-00065a-00 for guile-devel@gnu.org; Sat, 03 May 2003 19:08:17 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 19C66j-0005OT-00 for guile-devel@gnu.org; Sat, 03 May 2003 19:07:53 -0400 Original-Received: from snoopy.pacific.net.au ([61.8.0.36]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19C66N-0005AL-00 for guile-devel@gnu.org; Sat, 03 May 2003 19:07:31 -0400 Original-Received: from sunny.pacific.net.au (sunny.pacific.net.au [203.2.228.40]) h43N7Ts7025199 for ; Sun, 4 May 2003 09:07:29 +1000 Original-Received: from wisma.pacific.net.au (wisma.pacific.net.au [210.23.129.72]) by sunny.pacific.net.au with ESMTP id h43N7TQg027884 for ; Sun, 4 May 2003 09:07:29 +1000 (EST) Original-Received: from localhost (ppp30.dyn228.pacific.net.au [203.143.228.30]) by wisma.pacific.net.au (8.12.9/8.12.9) with ESMTP id h43N7RYZ012895 for ; Sun, 4 May 2003 09:07:27 +1000 (EST) Original-Received: from gg by localhost with local (Exim 3.35 #1 (Debian)) id 19C66C-0000JT-00; Sun, 04 May 2003 09:07:20 +1000 Original-To: guile-devel@gnu.org User-Agent: Gnus/5.090019 (Oort Gnus v0.19) Emacs/21.2 (gnu/linux) X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Developers list for Guile, the GNU extensibility library List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.lisp.guile.devel:2252 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.devel:2252 --=-=-= I thought to add something for `write' in the manual, and to emphasise the machine/human readability of it versus `display'. * scheme-io.texi (Writing): Add write, revise display. New text, for contemplation: - Scheme Procedure: write obj [port] Send a representation of OBJ to PORT or to the current output port if not given. The output is designed to be machine readable, and can be read back with `read' (*note Reading::). Strings are printed in doublequotes, with escapes if necessary, and characters are printed in `#\' notation. - Scheme Procedure: display obj [port] Send a representation of OBJ to PORT or to the current output port if not given. The output is designed for human readability, it differs from `write' in that strings are printed without doublequotes and escapes, and characters are printed as per `write-char', not in `#\' form. --=-=-= Content-Disposition: attachment; filename=scheme-io.texi.write-display.diff --- scheme-io.texi.~1.9.~ 2003-05-04 08:57:36.000000000 +1000 +++ scheme-io.texi 2003-05-04 09:05:51.000000000 +1000 @@ -180,13 +180,26 @@ has no associated print state, @code{#f} is returned. @end deffn +@rnindex write +@deffn {Scheme Procedure} write obj [port] +Send a representation of @var{obj} to @var{port} or to the current +output port if not given. + +The output is designed to be machine readable, and can be read back +with @code{read} (@pxref{Reading}). Strings are printed in +doublequotes, with escapes if necessary, and characters are printed in +@samp{#\} notation. +@end deffn + @rnindex display @deffn {Scheme Procedure} display obj [port] -Send a representation of @var{obj} to @var{current-output-port}. -Optional second arg @var{port} specifies an alternative output port. -The representation is similar to that produced by @code{write} (REFFIXME), -the differences being strings are not quoted (and their characters are not -escaped), and characters are rendered as if with @code{write-char}. +Send a representation of @var{obj} to @var{port} or to the current +output port if not given. + +The output is designed for human readability, it differs from +@code{write} in that strings are printed without doublequotes and +escapes, and characters are printed as per @code{write-char}, not in +@samp{#\} form. @end deffn @rnindex newline --=-=-= Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit _______________________________________________ Guile-devel mailing list Guile-devel@gnu.org http://mail.gnu.org/mailman/listinfo/guile-devel --=-=-=--