From 3480ddc40b8f9a9fb277fe1883e359db3db0ab17 Mon Sep 17 00:00:00 2001 From: Carlos O'Donell Date: Mon, 16 Oct 2017 20:43:28 +0200 Subject: [PATCH] shlib-compat: Update documentation of the compat_symbol_reference macro --- ChangeLog | 5 +++++ include/shlib-compat.h | 8 ++++++-- 2 files changed, 11 insertions(+), 2 deletions(-) diff --git a/ChangeLog b/ChangeLog index e45b749a40..debac64d25 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2017-10-16 Carlos O'Donell + + * include/shlib-compat.h (compat_symbol_reference): Update + comment. + 2017-10-16 Joseph Myers * math/Makefile (test-types): Add diff --git a/include/shlib-compat.h b/include/shlib-compat.h index d872afcbab..6f11be804a 100644 --- a/include/shlib-compat.h +++ b/include/shlib-compat.h @@ -78,8 +78,12 @@ #endif -/* Use compat_symbol_reference for a reference to a specific version - of a symbol. Use compat_symbol to define such a symbol. */ +/* Use compat_symbol_reference for a reference *or* definition of a + specific version of a symbol. Definitions are primarily used to + ensure tests reference the exact compat symbol required, or define an + interposing symbol of the right version e.g. __malloc_initialize_hook + in mcheck-init.c. Use compat_symbol to define such a symbol within + the shared libraries that are built for users. */ #define compat_symbol_reference(lib, local, symbol, version) \ compat_symbol_reference_1 (lib, local, symbol, version) #define compat_symbol_reference_1(lib, local, symbol, version) \ -- 2.11.4.GIT