1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-30 11:50:28 +02:00

no need to warn people off of s_FOO generated by SCM_DEFINE

* doc/ref/libguile-snarf.texi (Function Snarfing): The s_FOO binding
  isn't deprecated; no need to warn people to stop using it.  Thanks to
  Peter Brett for the hint.
This commit is contained in:
Andy Wingo 2012-01-08 17:55:01 +01:00
parent fb2be758b7
commit c60e6ed4b8

View file

@ -1,6 +1,6 @@
@c -*-texinfo-*- @c -*-texinfo-*-
@c This is part of the GNU Guile Reference Manual. @c This is part of the GNU Guile Reference Manual.
@c Copyright (C) 1996, 1997, 2000, 2001, 2002, 2003, 2004 @c Copyright (C) 1996, 1997, 2000, 2001, 2002, 2003, 2004, 2012
@c Free Software Foundation, Inc. @c Free Software Foundation, Inc.
@c See the file guile.texi for copying conditions. @c See the file guile.texi for copying conditions.
@ -82,10 +82,10 @@ The @code{SCM_DEFINE} declaration says that the C function
rest argument. The string @code{"Clear the image."} provides a short rest argument. The string @code{"Clear the image."} provides a short
help text for the function, it is called a @dfn{docstring}. help text for the function, it is called a @dfn{docstring}.
For historical reasons, the @code{SCM_DEFINE} macro also defines a @code{SCM_DEFINE} macro also defines a static array of characters
static array of characters named @code{s_clear_image}, initialized to initialized to the Scheme name of the function. In this case,
the string "clear-image". You shouldn't use this array, but you might @code{s_clear_image} is set to the C string, "clear-image". You might
need to be aware that it exists. want to use this symbol when generating error messages.
Assuming the text above lives in a file named @file{image-type.c}, you Assuming the text above lives in a file named @file{image-type.c}, you
will need to execute the following command to prepare this file for will need to execute the following command to prepare this file for