Internal structures should not be exported. Especially pointers to
internal data. Doing so harms future reorganization/rewrite of subsystems.
-All exported functions must be listed in libgnutls.map.in
+All exported functions must be listed in libgnutls.map.in,
in order to be exported.
On the other hand, it is often desirable to support more than one
versions of the library. In that case you could utilize compile-time
-feature checks using the the @code{GNUTLS_VERSION_NUMBER} macro.
+feature checks using the @code{GNUTLS_VERSION_NUMBER} macro.
For example, to conditionally add code for GnuTLS 3.2.1 or later, you may use:
@example
#if GNUTLS_VERSION_NUMBER >= 0x030201
/* Weak-key hash table. */
static SCM weak_refs;
-/* Register a weak reference from FROM to TO, such that the lifetime of TO is
+/* Register a weak reference from @FROM to @TO, such that the lifetime of TO is
greater than or equal to that of FROM. */
static void
register_weak_reference (SCM from, SCM to)
* @chain_size: The size of the chain
* @chain_type: The type of the certificate chain
* @r: DANE data to check against
- * @sflags: Flags for the the initialization of @s (if NULL)
+ * @sflags: Flags for the initialization of @s (if NULL)
* @vflags: Verification flags; an OR'ed list of %dane_verify_flags_t.
* @verify: An OR'ed list of %dane_verify_status_t.
*
* @hostname: The hostname associated with the chain
* @proto: The protocol of the service connecting (e.g. tcp)
* @port: The port of the service connecting (e.g. 443)
- * @sflags: Flags for the the initialization of @s (if NULL)
+ * @sflags: Flags for the initialization of @s (if NULL)
* @vflags: Verification flags; an OR'ed list of %dane_verify_flags_t.
* @verify: An OR'ed list of %dane_verify_status_t.
*
* @hostname: The hostname associated with the chain
* @proto: The protocol of the service connecting (e.g. tcp)
* @port: The port of the service connecting (e.g. 443)
- * @sflags: Flags for the the initialization of @s (if NULL)
+ * @sflags: Flags for the initialization of @s (if NULL)
* @vflags: Verification flags; an OR'ed list of %dane_verify_flags_t.
* @verify: An OR'ed list of %dane_verify_status_t.
*