From 05093fbf4999c0dc520549cd1224cc6828647092 Mon Sep 17 00:00:00 2001 From: Yuri D'Elia Date: Tue, 9 Aug 2022 17:15:54 +0200 Subject: [PATCH] lang: Add inline documentation for the various language macros --- Firmware/language.h | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/Firmware/language.h b/Firmware/language.h index 91a76a1c3..3e381fa3a 100644 --- a/Firmware/language.h +++ b/Firmware/language.h @@ -26,10 +26,10 @@ #define PROGMEM_I1 __attribute__((section(".progmem1"))) #define PROGMEM_N1 __attribute__((section(".progmem2"))) #define _I(s) (__extension__({static const char __c[] PROGMEM_I1 = s; &__c[0];})) -#define ISTR(s) s -#define _i(s) _I(s) -#define _T(s) s -#define _O(s) s +#define ISTR(s) (s) // declare a translatable string +#define _i(s) _I(s) // declare a translatable string and return the translated form +#define _T(s) (s) // return translated string from reference +#define _O(s) (s) // return original (untranslated) string from reference #else //(LANG_MODE == 0) // section .loc_sec (originaly .progmem0) will be used for localized translated strings #define PROGMEM_I2 __attribute__((section(".loc_sec"))) @@ -43,8 +43,9 @@ #define _T(s) lang_get_translation(s) #define _O(s) (s + 2) #endif //(LANG_MODE == 0) + #define _N(s) (__extension__({static const char __c[] PROGMEM_N1 = s; &__c[0];})) -#define _n(s) _N(s) +#define _n(s) _N(s) // declare and return untranslated string /** @brief lang_table_header_t structure - (size= 16byte) */ typedef struct