dts: gpio: add mention of pin number macros in nexus bindings docs

For all GPIO headers/connectors, add a short mention of the header file
that can be used to access pin numbers macros.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>