doc/ref/deprecated.texi

   1 @c -*-texinfo-*-
   2 @c This is part of the GNU Guile Reference Manual.
   3 @c Copyright (C)  1996, 1997, 2000, 2001, 2002, 2003, 2004
   4 @c   Free Software Foundation, Inc.
   5 @c See the file guile.texi for copying conditions.
   6
   7 @page
   8 @node Deprecated
   9 @chapter Deprecated
  10
  11 The features and functions described in this chapter are considered
  12 obsolete and should not be used by new programs.  They're retained for
  13 compatibility with past versions of Guile.
  14
  15 @deffn {Scheme Procedure} substring-move-left! str1 start1 end1 str2 start2
  16 @deffnx {Scheme Procedure} substring-move-right! str1 start1 end1 str2 start2
  17 These functions are aliases for @code{substring-move!} and calls to
  18 them can simply be replaced by @code{substring-move!} (@pxref{String
  19 Modification}.)
  20
  21 In the past, if @var{str1} and @var{str2} were the same string, it was
  22 necessary to call @code{substring-move-left!} if the move was to the
  23 left (@math{@var{start2} < @var{start1}}), or call
  24 @code{substring-move-right!} if the move was to the right
  25 (@math{@var{start2} > @var{start1}}).  @code{substring-move!} is now
  26 able to do both.
  27 @end deffn
  28
  29 @deftypefn {C Function} void scm_remember (SCM *ptr)
  30 Create a reference to the object at @var{ptr}, so it's certain to be
  31 present on the stack and hence won't be freed by the garbage
  32 collector.
  33
  34 This function has been superceded by @code{scm_remember_upto_here_1}
  35 (which takes an object, not a pointer to one), @xref{Remembering
  36 During Operations}.
  37 @end deftypefn
  38
  39