When to use SCM_DEFINE vs SCM_GPROC vs SCM_PRIMITIVE_GENERIC?

[Mark H Weaver]

I am writing C versions of R6RS div/mod/div0/mod0, as well as
div-and-mod and div0-and-mod0, for numbers.c.

I notice that numbers.c uses three different macros to define public
procedures: SCM_DEFINE, SCM_GPROC, and SCM_PRIMITIVE_GENERIC.  I don't
see an obvious logic to the choices of which macro to use.  For
example, `exact->inexact' uses SCM_GPROC whereas `inexact->exact' uses
SCM_DEFINE.

One obvious disadvantage to SCM_GPROC is that it doesn't accept a
documentation string.

Can someone please enlighten me about the relevant factors to decide?
What macro do you think I should use for the functions I'm writing?
Note that `div-and-mod' and `div0-and-mod0' will return two values.

One more question: do you think I should give div/mod/div0/mod0 their
short R6RS names by default?

    Thanks,
      Mark