include: drivers: dma format the documentation from header file

This patch is re-formating the doc generated from the dma.h
header file. Result to be accessible on the
https://docs.zephyrproject.org/latest/reference/peripherals/dma.html



Signed-off-by: Francois Ramu <francois.ramu@st.com>