Mark macros in documentation

Arduino is a beginner-IDE afterall. Macros like constrain() can stump beginners. If you use constrain in a way similar to this:

// read values from eeprom and constrain to allowed range
int address = 0;
uint8_t value = constrain(, 23, 99);

It will no give the desired results because the expression is expanded to:

uint8_t value = < 23 ? 23 : > 99 ? 99 :;

I suggest a short note ala “This is a macro function. See here for possible pitfalls when using macros.”, linking to a short Macro topic (like #define which should also link there) that explains the above issue.

Best Regards,