From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Newsgroups: gmane.lisp.guile.devel Subject: Re: [PATCH] Implement efficient 'scm_unget_bytes' and 'unget-bytevector' Date: Sun, 07 Apr 2013 11:28:16 +0200 Message-ID: <87ehemzo3z.fsf@gnu.org> References: <87d2u8uq9t.fsf@tines.lan> <878v4wumla.fsf@tines.lan> <8761zz1cnk.fsf@gnu.org> <874nfiu7su.fsf@tines.lan> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1365326918 31789 80.91.229.3 (7 Apr 2013 09:28:38 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 7 Apr 2013 09:28:38 +0000 (UTC) Cc: guile-devel@gnu.org To: Mark H Weaver Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Sun Apr 07 11:28:42 2013 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UOltt-0000bS-Kt for guile-devel@m.gmane.org; Sun, 07 Apr 2013 11:28:37 +0200 Original-Received: from localhost ([::1]:34877 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UOltt-0005FS-19 for guile-devel@m.gmane.org; Sun, 07 Apr 2013 05:28:37 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:49645) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UOltl-0005EE-04 for guile-devel@gnu.org; Sun, 07 Apr 2013 05:28:34 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UOlti-0002HU-Lz for guile-devel@gnu.org; Sun, 07 Apr 2013 05:28:28 -0400 Original-Received: from [2a01:e0b:1:123:ca0a:a9ff:fe03:271e] (port=44048 helo=xanadu.aquilenet.fr) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UOlti-0002Fv-FN for guile-devel@gnu.org; Sun, 07 Apr 2013 05:28:26 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by xanadu.aquilenet.fr (Postfix) with ESMTP id 8A3FA73E5; Sun, 7 Apr 2013 11:28:17 +0200 (CEST) Original-Received: from xanadu.aquilenet.fr ([127.0.0.1]) by localhost (xanadu.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id mhX1ikZlIRAM; Sun, 7 Apr 2013 11:28:17 +0200 (CEST) Original-Received: from pluto (reverse-83.fdn.fr [80.67.176.83]) by xanadu.aquilenet.fr (Postfix) with ESMTPSA id E738573E4; Sun, 7 Apr 2013 11:28:16 +0200 (CEST) X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 18 Germinal an 221 de la =?utf-8?Q?R=C3=A9volution?= X-PGP-Key-ID: 0xEA52ECF4 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 83C4 F8E5 10A3 3B4C 5BEA D15D 77DD 95E2 EA52 ECF4 X-OS: x86_64-unknown-linux-gnu In-Reply-To: <874nfiu7su.fsf@tines.lan> (Mark H. Weaver's message of "Sun, 07 Apr 2013 03:19:29 -0400") User-Agent: Gnus/5.130005 (Ma Gnus v0.5) Emacs/24.3 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2a01:e0b:1:123:ca0a:a9ff:fe03:271e X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:16184 Archived-At: Mark H Weaver skribis: > ludo@gnu.org (Ludovic Court=C3=A8s) writes: > >> Mark H Weaver skribis: [...] >>> I've used it to unget 15 megabytes, and it was quite fast. >>> Unfortunately, I'm at a bit of a loss of where to document it in the >>> manual. >> >> What about adding a sentence to mention (ice-9 bytevectors) under >> =E2=80=9CBytevectors=E2=80=9D, and then =E2=80=98unget-bytevector=E2=80= =99 under =E2=80=9CR6RS Binary Input=E2=80=9D? > > The problem is that "R6RS Binary Input" describes procedures exported > from (rnrs io ports), but 'unget-bytevector' is not exported from that > module, nor should it be. Of course. > 'unget-bytevector' is exported only from (ice-9 binary-ports), and there > is no section of the manual that describes that module. It is only > mentioned briefly at the end of 6.14.10 (R6RS I/O Ports) as follows: > > A subset of the `(rnrs io ports)' module is provided by the `(ice-9 > binary-ports)' module. It contains binary input/output procedures > and does not rely on R6RS support. > > Unfortunately, this patch invalidates the above claim that (ice-9 > binary-ports) is a subset of (rnrs io ports). > > I see no easy fix. Maybe the documentation for the procedures exported > from (ice-9 binary-ports) should be moved into a separate "Binary I/O" > subsection of 6.14 (Input and Output), and the corresponding procedure > entries in 6.14.10 (R6RS I/O Ports) should cross-reference the new > subsection? Yes, that=E2=80=99s one possibility. A faster possibility (aka. let=E2=80=99s release!) would be to add something like that at the end of =E2=80=9CBinary Input=E2=80=9D: The (ice-9 binary-ports) module provides the following procedure as an extension to (rnrs io ports): WDYT? Ludo=E2=80=99.