From 6457ef9b3c2db13babe0588fa9b182560f2f71cc Mon Sep 17 00:00:00 2001 From: Gilles Peskine Date: Mon, 11 Apr 2022 16:42:37 +0200 Subject: [PATCH] Format literal # in a way that doesn't confuse older Doxygen With Doxygen 1.8.11 (as on Ubuntu 16.04), `#include` doesn't protect the hash character enough, and Doxygen tries to link to something called include. (Doxygen 1.8.17 doesn't have this problem.) Signed-off-by: Gilles Peskine --- include/mbedtls/mbedtls_config.h | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/include/mbedtls/mbedtls_config.h b/include/mbedtls/mbedtls_config.h index f4a9e3bdd..2d73b2abc 100644 --- a/include/mbedtls/mbedtls_config.h +++ b/include/mbedtls/mbedtls_config.h @@ -3105,9 +3105,9 @@ * `"mbedtls/mbedtls_config.h"`. * This header file specifies the compile-time configuration of Mbed TLS. * - * This macro is expanded after an `#include` directive. This is a popular but + * This macro is expanded after an \#include directive. This is a popular but * non-standard feature of the C language, so this feature is only available - * with compilers that perform macro expansion on an `#include` line. + * with compilers that perform macro expansion on an \#include line. * * The value of this symbol is typically a path in double quotes, relative * to a directory on the include search pah. @@ -3120,9 +3120,9 @@ * If defined, this is a header which will be included after * `"mbedtls/mbedtls_config.h"` or #MBEDTLS_CONFIG_FILE. * - * This macro is expanded after an `#include` directive. This is a popular but + * This macro is expanded after an \#include directive. This is a popular but * non-standard feature of the C language, so this feature is only available - * with compilers that perform macro expansion on an `#include` line. + * with compilers that perform macro expansion on an \#include line. * * The value of this symbol is typically a path in double quotes, relative * to a directory on the include search pah. @@ -3138,9 +3138,9 @@ * through the PSA API when #MBEDTLS_PSA_CRYPTO_CONFIG is enabled, and * is not used when #MBEDTLS_PSA_CRYPTO_CONFIG is disabled. * - * This macro is expanded after an `#include` directive. This is a popular but + * This macro is expanded after an \#include directive. This is a popular but * non-standard feature of the C language, so this feature is only available - * with compilers that perform macro expansion on an `#include` line. + * with compilers that perform macro expansion on an \#include line. * * The value of this symbol is typically a path in double quotes, relative * to a directory on the include search pah. @@ -3153,9 +3153,9 @@ * If defined, this is a header which will be included after * `"psa/crypto_config.h"` or #MBEDTLS_PSA_CRYPTO_CONFIG_FILE. * - * This macro is expanded after an `#include` directive. This is a popular but + * This macro is expanded after an \#include directive. This is a popular but * non-standard feature of the C language, so this feature is only available - * with compilers that perform macro expansion on an `#include` line. + * with compilers that perform macro expansion on an \#include line. * * The value of this symbol is typically a path in double quotes, relative * to a directory on the include search pah.