drivers: fixes to the low-level GPIO driver

- fixed doxygen comments
- added GPIO_UNDEFINED value
- added return values to all functions
Merge pull request #971 from haukepetersen/periph_gpio_fix

drivers: fixes to the low-level GPIO driver