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 deprecated substring-move-left! and right! Date: Sat, 24 May 2003 08:03:38 +1000 Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Message-ID: <87vfw1l3r9.fsf@zip.com.au> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: main.gmane.org 1053728574 5987 80.91.224.249 (23 May 2003 22:22:54 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Fri, 23 May 2003 22:22:54 +0000 (UTC) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Sat May 24 00:22:50 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 19JKv4-0001QG-00 for ; Sat, 24 May 2003 00:21:46 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.20) id 19JKsJ-00034Q-GS for guile-devel@m.gmane.org; Fri, 23 May 2003 18:18:55 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.20) id 19JKpH-0001oe-MP for guile-devel@gnu.org; Fri, 23 May 2003 18:15:47 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.20) id 19JKdo-0002Vq-RP for guile-devel@gnu.org; Fri, 23 May 2003 18:04:00 -0400 Original-Received: from snoopy.pacific.net.au ([61.8.0.36]) by monty-python.gnu.org with esmtp (Exim 4.20) id 19JKdi-0002Ef-Q9 for guile-devel@gnu.org; Fri, 23 May 2003 18:03:51 -0400 Original-Received: from sunny.pacific.net.au (sunny.pacific.net.au [203.2.228.40]) h4NM3mPB020626 for ; Sat, 24 May 2003 08:03:49 +1000 Original-Received: from wisma.pacific.net.au (wisma.pacific.net.au [210.23.129.72]) by sunny.pacific.net.au with ESMTP id h4NM3mQg029672 for ; Sat, 24 May 2003 08:03:48 +1000 (EST) Original-Received: from localhost (ppp126.dyn228.pacific.net.au [203.143.228.126]) by wisma.pacific.net.au (8.12.9/8.12.9) with ESMTP id h4NM3lYZ010282 for ; Sat, 24 May 2003 08:03:47 +1000 (EST) Original-Received: from gg by localhost with local (Exim 3.35 #1 (Debian)) id 19JKdW-0000j2-00; Sat, 24 May 2003 08:03:38 +1000 Original-To: guile-devel@gnu.org Mail-Copies-To: never 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:2432 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.devel:2432 --=-=-= I think it'd be good to have all superceded functions appear in the deprecated chapter of the manual. It can say what they do, for the benefit of anyone seeing them in old code, and can explain what they've been replaced by or what was wrong with them. As a bit of a start: * deprecated.texi: Add substring-move-left! and substring-move-right!. Deprecated ********** The features and functions described in this chapter are considered obsolete and should not be used by new programs. They're retained for compatibility with past versions of Guile. - Scheme Procedure: substring-move-left! str1 start1 end1 str2 start2 - Scheme Procedure: substring-move-right! str1 start1 end1 str2 start2 These functions are aliases for `substring-move!' and calls to them can simply be replaced by `substring-move!' (*note String Modification::.) In the past, if STR1 and STR2 were the same string, it was necessary to call `substring-move-left!' if the move was to the left (START2 < START1), or call `substring-move-right!' if the move was to the right (START2 > START1). `substring-move!' is able to do both. --=-=-= Content-Disposition: attachment; filename=deprecated.texi.substring-move.diff --- deprecated.texi.~1.3.~ 2002-03-16 23:51:03.000000000 +1000 +++ deprecated.texi 2003-05-23 15:24:08.000000000 +1000 @@ -1,3 +1,24 @@ @page @node Deprecated @chapter Deprecated + +The features and functions described in this chapter are considered +obsolete and should not be used by new programs. They're retained for +compatibility with past versions of Guile. + +@deffn {Scheme Procedure} substring-move-left! str1 start1 end1 str2 start2 +@deffnx {Scheme Procedure} substring-move-right! str1 start1 end1 str2 start2 +These functions are aliases for @code{substring-move!} and calls to +them can simply be replaced by @code{substring-move!} (@pxref{String +Modification}.) + +In the past, if @var{str1} and @var{str2} were the same string, it was +necessary to call @code{substring-move-left!} if the move was to the +left (@math{@var{start2} < @var{start1}}), or call +@code{substring-move-right!} if the move was to the right +(@math{@var{start2} > @var{start1}}). @code{substring-move!} is able +to do both. +@end deffn + + + --=-=-= 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 --=-=-=--