Next: , Previous: , Up: Guile API Conventions   [Contents][Index]

3.2 Procedure Names

Unlike C functions in GnuTLS, the corresponding Scheme procedures are named in a way that is close to natural English. Abbreviations are also avoided. For instance, the Scheme procedure corresponding to gnutls_certificate_set_dh_params is named set-certificate-credentials-dh-parameters!. The gnutls_ prefix is always omitted from variable names since a similar effect can be achieved using Guile’s nifty binding renaming facilities, should it be needed (see Using Guile Modules in The GNU Guile Reference Manual).

Often Scheme procedure names differ from C function names in a way that makes it clearer what objects they operate on. For example, the Scheme procedure named set-session-transport-port! corresponds to gnutls_transport_set_ptr, making it clear that this procedure applies to session.