libebl.h: Add comment from README that this is completely UNSUPPORTED.

Make it really, really clear that the libebl interface is NOT source and
NOT abi compatible and we will break any users.

Signed-off-by: Mark Wielaard <mjw@redhat.com>

diff --git a/libebl/ChangeLog b/libebl/ChangeLog
index 5e635f2160b93c3d077efcd3f36c538cc73c89fd..3655e72c55c76810ee736b6aab1430242d02c31e 100644 (file)
--- a/libebl/ChangeLog
+++ b/libebl/ChangeLog
@@ -1,3 +1,8 @@
+2015-01-27  Mark Wielaard  <mjw@redhat.com>
+
+       * libebl.h: Add comment from README that this is completely
+       UNSUPPORTED.
+
 2014-11-22  Mark Wielaard  <mjw@redhat.com>
 
        * ebl-hooks.h (bss_plt_p): Remove ehdr argument.

diff --git a/libebl/libebl.h b/libebl/libebl.h
index 7c3c76473d69e443de72fd3f0cb68cc33864cb23..7ead62caea2918fafe896f5ccfc9047c380b18f6 100644 (file)
--- a/libebl/libebl.h
+++ b/libebl/libebl.h
@@ -1,5 +1,5 @@
 /* Interface for libebl.
-   Copyright (C) 2000-2010, 2013, 2014 Red Hat, Inc.
+   Copyright (C) 2000-2010, 2013, 2014, 2015 Red Hat, Inc.
    This file is part of elfutils.
 
    This file is free software; you can redistribute it and/or modify
@@ -26,6 +26,19 @@
    the GNU Lesser General Public License along with this program.  If
    not, see <http://www.gnu.org/licenses/>.  */
 
+
+/* This is the interface for the Elfutils Backend Library.
+   It is a completely UNSUPPORTED interface.  Don't use any libebl
+   function directly.  These are only for internal elfutils backends
+   and tools.  There is NO source or binary compatible guarantee.
+
+   The ABI of the backend modules is not guaranteed.  Really, not guarantee
+   whatsoever.  We are enforcing this in the code.  The modules and their
+   users must match.  No third-party EBL module are supported or allowed.
+   The only reason there are separate modules is to not have the code for
+   all architectures in all the binaries.  */
+
+
 #ifndef _LIBEBL_H
 #define _LIBEBL_H 1