include: drivers: flash: clean up doxygen

Rework doxygen group naming and fold "internal" Flash API into the main
Flash API group.
Also a minor fix of a missing javadoc-style comment.

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