Re: Identifying what's usable in installed headers [was Re: RFC: Foreign objects facility]

[Ludovic Courtès]

Doug Evans <address@hidden> skribis:

> On Fri, May 2, 2014 at 4:44 AM, Ludovic Courtès <address@hidden> wrote:
>> Doug Evans <address@hidden> 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
>> ‘SCM_I’.
>
> 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.)

‘SCM_STRUCTP’, ‘SCM_STRUCT_SLOT_REF’, and a few others may be OK, but
there are equivalent public functions anyway, so it’s better to use
them.

I’m not sure what to do for this particular header.

Ludo’.