GNU logs - #31154, boring messages

Message sent to bug-guile@HIDDEN:

Subject: bug#31154: predicate function for foreign-object not obvious
Resent-From: Matt Wette <matt.wette@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-guile@HIDDEN
Resent-Date: Sat, 14 Apr 2018 18:35:01 +0000
Resent-Message-ID: <handler.31154.B.152373085729032 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 31154 <at> debbugs.gnu.org
From: Matt Wette <matt.wette@HIDDEN>
Message-ID: <689d625b-94f7-919b-c017-fa921d54c744@HIDDEN>
Date: Sat, 14 Apr 2018 11:33:59 -0700
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101
 Thunderbird/52.7.0
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
Content-Language: en-US
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

The reference manual (guile-2.2.3) does not provide instruction on how to generate
a predicate for a foreign object, and it is not obvious.  Maybe it doesn't need to
be in the manual but should then be in an example somewhere, IMO.

The following patch to the reference manual is one option:


--- doc/ref/api-foreign-objects.texi-orig	2018-04-14 11:26:35.779502997 -0700
+++ doc/ref/api-foreign-objects.texi	2018-04-14 11:28:42.823072217 -0700
@@ -96,6 +96,33 @@
  needed.
  @end deftypefn
  
+To generate a predicate for a foreign object use the @code{SCM_IS_A_P}
+macro as follows.
+
+@example
+static SCM foo_type;
+
+static SCM
+scm_foo_p(SCM obj) {
+  return SCM_IS_A_P(obj, foo_type)? SCM_BOOL_T: SCM_BOOL_F;
+}
+
+void
+init_foo()
+{
+  SCM name, slots;
+
+  name = scm_from_utf8_symbol("foo");
+  slots = scm_list_2 (scm_from_utf8_symbol ("data"),
+		      scm_from_utf8_symbol ("deps"));
+  finalizer = NULL;
+  foo_type = scm_make_foreign_object_type(name, slots, finalizer);
+
+  scm_c_define_gsubr("foo?", 1, 0, 0, scm_foo_p);
+  ...
+}
+@end example
+
  One can also access foreign objects from Scheme.  @xref{Foreign Objects
  and Scheme}, for some examples.

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Matt Wette <matt.wette@HIDDEN>
Subject: bug#31154: Acknowledgement (predicate function for foreign-object
 not obvious)
Message-ID: <handler.31154.B.152373085729032.ack <at> debbugs.gnu.org>
References: <689d625b-94f7-919b-c017-fa921d54c744@HIDDEN>
X-Gnu-PR-Message: ack 31154
X-Gnu-PR-Package: guile
Reply-To: 31154 <at> debbugs.gnu.org
Date: Sat, 14 Apr 2018 18:35:01 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-guile@HIDDEN

If you wish to submit further information on this problem, please
send it to 31154 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
31154: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D31154
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Message sent to bug-guile@HIDDEN:

Subject: bug#31154: Acknowledgement (predicate function for foreign-object not obvious)
Resent-From: Matt Wette <matt.wette@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-guile@HIDDEN
Resent-Date: Sat, 14 Apr 2018 19:26:01 +0000
Resent-Message-ID: <handler.31154.B31154.152373394416773 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 31154 <at> debbugs.gnu.org
References: <689d625b-94f7-919b-c017-fa921d54c744@HIDDEN>
 <handler.31154.B.152373085729032.ack <at> debbugs.gnu.org>
From: Matt Wette <matt.wette@HIDDEN>
Message-ID: <664618b2-ad6b-5b29-c181-b3157e953209@HIDDEN>
Date: Sat, 14 Apr 2018 12:25:34 -0700
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101
 Thunderbird/52.7.0
MIME-Version: 1.0
In-Reply-To: <handler.31154.B.152373085729032.ack <at> debbugs.gnu.org>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
Content-Language: en-US
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

Perhaps it belongs with the demo in Section 5.5 Defining New Foreign Object Types,
with the image demo.

Last modified: Mon, 25 Nov 2019 12:00:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.