diff options
| author | Nikos Mavrogiannopoulos <nmav@gnutls.org> | 2019-04-07 13:03:20 +0200 |
|---|---|---|
| committer | Nikos Mavrogiannopoulos <nmav@gnutls.org> | 2019-04-07 13:03:37 +0200 |
| commit | ef40ac594b8b5506b4143995c4ff16d7cc9c151a (patch) | |
| tree | 2f39e6a9c399c086bc8a5f1baeecd1372c4f9ac4 | |
| parent | d5f5b6a200c815245853e7a47a1ea666217473b7 (diff) | |
| download | gnutls-tmp-include-unit-testing-doc.tar.gz | |
CONTRIBUTING.md: document unit testing method of internal functions [ci skip]tmp-include-unit-testing-doc
Resolves: #749
Signed-off-by: Nikos Mavrogiannopoulos <nmav@gnutls.org>
| -rw-r--r-- | CONTRIBUTING.md | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 201efd133b..4c57a35773 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -99,6 +99,9 @@ following. * ```gnutls_credentials_``` for the credentials structures * ```gnutls_global_``` for the global structures handling +All exported API functions must be listed in libgnutls.map, +in order to be exported. + Internal functions, i.e, functions that are not exported in the API but are used internally by multiple files, should be prefixed with an underscore. For example `_gnutls_handshake_begin()`. @@ -108,9 +111,8 @@ not use the `_gnutls` prefix for simplicity, e.g., `get_version()`. 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, -in order to be exported. +They can however be used by unit tests in tests/ directory; in that +case they should be part of the GNUTLS_PRIVATE_3_4 tag in libgnutls.map. # Introducing new functions / API |