Document the fact that pin names should not include too many alternative functions

[poeschlr]

Mainly a topic for micro controllers:

I think the current way of doing it is that no alternative functions are included.
Exception: Things that are very likely used like the xtal pins, reset, programmer interface, ...