include: drivers: gpio: gpio_utils doxygen improvements

add a missing doc + actually show up the utilities from the gpio_utils.h
header file in the doxygen documentation.

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