From 3c12ee0950f63e83d4a29f420bb4cff13a2a899b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mikolai=20G=C3=BCtschow?= Date: Thu, 27 Mar 2025 14:25:15 +0100 Subject: [PATCH] doc: deprecate RIOT_FILE_* macros --- doc.txt | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc.txt b/doc.txt index 94cd317455..f55d7a4323 100644 --- a/doc.txt +++ b/doc.txt @@ -65,8 +65,9 @@ * @warning This only works within `*.c` and `*.cpp` files. For `*.h`/`*.hpp` files the * source compiles, however, the including `*.c`/`*.cpp` file will be * substituted. - * @see `__FILE__` for absolute filenames that also work with *.h files * @see @ref RIOT_FILE_NOPATH + * @deprecated This macro will be removed after the 2025.10 release. + * Use the compiler builtin `__FILE__` instead (GCC 8+, clang 10+) */ #if DOXYGEN # define RIOT_FILE_RELATIVE @@ -78,8 +79,9 @@ * @warning This only works within `*.c` and `*.cpp` files. For `*.h`/`*.hpp` files the * source compiles, however, the including `*.c`/`*.cpp` file will be * substituted. - * @see `__FILE__` for absolute filenames that also work with *.h files * @see @ref RIOT_FILE_RELATIVE + * @deprecated This macro will be removed after the 2025.10 release. + * Use the compiler builtin `__FILE_NAME__` instead (GCC 12+, clang 9+) */ #if DOXYGEN # define RIOT_FILE_NOPATH