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: Identifying what's usable in installed headers [was Re: RFC: Foreign objects facility] Date: Mon, 05 May 2014 18:03:26 +0200 Message-ID: <874n14jjqp.fsf@gnu.org> References: <87mwf09zhg.fsf@gnu.org> <87oazf3h16.fsf@gnu.org> 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 1399413868 27301 80.91.229.3 (6 May 2014 22:04:28 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 6 May 2014 22:04:28 +0000 (UTC) Cc: guile-devel To: Doug Evans Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Wed May 07 00:04:21 2014 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 1WhnRr-0002FQ-7A for guile-devel@m.gmane.org; Wed, 07 May 2014 00:02:51 +0200 Original-Received: from localhost ([::1]:58587 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WhM0F-0006VX-Go for guile-devel@m.gmane.org; Mon, 05 May 2014 12:44:31 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44006) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WhLMf-0002sM-Lf for guile-devel@gnu.org; Mon, 05 May 2014 12:03:43 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WhLMX-0001ya-9n for guile-devel@gnu.org; Mon, 05 May 2014 12:03:37 -0400 Original-Received: from hera.aquilenet.fr ([2a01:474::1]:34881) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WhLMX-0001yS-3g for guile-devel@gnu.org; Mon, 05 May 2014 12:03:29 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by hera.aquilenet.fr (Postfix) with ESMTP id 2CACC239D; Mon, 5 May 2014 18:03:27 +0200 (CEST) Original-Received: from hera.aquilenet.fr ([127.0.0.1]) by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 6Ke9XKixb0Vt; Mon, 5 May 2014 18:03:27 +0200 (CEST) Original-Received: from pluto (pluto.bordeaux.inria.fr [193.50.110.57]) by hera.aquilenet.fr (Postfix) with ESMTPSA id E69A6259; Mon, 5 May 2014 18:03:26 +0200 (CEST) X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 16 =?utf-8?Q?Flor=C3=A9al?= an 222 de la =?utf-8?Q?R?= =?utf-8?Q?=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: (Doug Evans's message of "Fri, 2 May 2014 21:18:04 -0700") User-Agent: Gnus/5.130009 (Ma Gnus v0.9) Emacs/24.3 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2a01:474::1 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:17137 Archived-At: Doug Evans skribis: > On Fri, May 2, 2014 at 4:19 PM, Ludovic Court=C3=A8s wrote: >> Doug Evans skribis: >> >>> On Fri, May 2, 2014 at 4:44 AM, Ludovic Court=C3=A8s wro= te: >>>> Doug Evans skribis: >>>> >>>>> While function declarations are markable as being internal/external in >>>>> published headers (SCM_INTERNAL vs SCM_API), macros are not. >>>> >>>> Internal macros are marked by a naming convention: they are prefixed by >>>> =E2=80=98SCM_I=E2=80=99. >>> >>> Hi. Sorry, catching up on mail. >>> >>> So this means that struct.h:SCM_STRUCT_* are ok to use by apps, right? >> >> You got me. ;-) >> >> These ones are not documented, and some of them are clearly too >> low-level and expose too many implementation details (flags, indexes, >> etc.) >> >> =E2=80=98SCM_STRUCTP=E2=80=99, =E2=80=98SCM_STRUCT_SLOT_REF=E2=80=99, an= d a few others may be OK, but >> there are equivalent public functions anyway, so it=E2=80=99s better to = use >> them. > > Thing is, the public functions (scm_struct_ref/set_x) are not > equivalent (to SCM_STRUCT_SLOT_*). > Plus the public "slot accessing" functions use the SCM_STRUCT_DATA > interface. :-) > SCM_STRUCT_SLOT_* isn't used at all in struct.c. > > $ grep SCM_STRUCT_SLOT struct.c | wc > 0 0 0 Right. Well, I don=E2=80=99t know what the intent was, and C-x v g tells m= e we should ask Andy. Andy? :-) Interestingly, commit b6cf4d02, which added this, also has this bit: Remove foreign object implementation. =20=20=20=20 * libguile/goops.h: * libguile/goops.c (scm_make_foreign_object, scm_make_class) (scm_add_slot, scm_wrap_object, scm_wrap_component): Remove, these were undocumented and unworking. Ludo=E2=80=99.