include: implement REUSE with SPDX identifiers

[lttng-ust.git] / include / lttng / ust-api-compat.h

diff --git a/include/lttng/ust-api-compat.h b/include/lttng/ust-api-compat.h
index af9c272b64cde614693d5079feaaa412b099c58c..1f4e7bf9546a00f1e48950279a2ecedd1d80f2d7 100644 (file)
--- a/include/lttng/ust-api-compat.h
+++ b/include/lttng/ust-api-compat.h
@@ -1,8 +1,8 @@
+// SPDX-FileCopyrightText: 2021 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+//
+// SPDX-License-Identifier: MIT
+
 /*
- * SPDX-License-Identifier: MIT
- *
- * Copyright (C) 2021 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
- *
  * LTTng-UST API compatibility header
  */
 
@@ -10,15 +10,18 @@
 #define _LTTNG_UST_API_COMPAT_H
 
 /*
- * In order to disable compatibility API for a range of soname major
- * versions, define LTTNG_UST_COMPAT_API_VERSION to the oldest major
- * version API for which to provide compatibility.
+ * The compat API version controls backward API compatibility at the
+ * source-code level.
+ *
+ * In order to disable compatibility API for a range of API versions, define
+ * LTTNG_UST_COMPAT_API_VERSION to the oldest API version for which to provide
+ * compatibility.
  *
  * If LTTNG_UST_COMPAT_API_VERSION is undefined, API compatibility for
  * all API versions is provided.
  * If LTTNG_UST_COMPAT_API_VERSION is defined to N, API compatibility
- * for soname N or higher is provided, leaving out (not compiling)
- * compatibility for soname lower than N.
+ * for versions N or higher is provided, thus not defining compatibility macros
+ * for versions lower than N.
  */
 
 #ifndef LTTNG_UST_COMPAT_API_VERSION