include/drivers: Move 2 specific intc headers into public location

sam0 and stm32 specific interrupt controller headers are meant to be
public, and as such should be found in
include/drivers/interrupt_controller and not in
drivers/interrupt_controllers.

Fixing documentation issues as well.

Signed-off-by: Tomasz Bursztyka <tomasz.bursztyka@linux.intel.com>

drivers/gpio/gpio_sam0.c

@@ -8,7 +8,7 @@
 #include <device.h>
 #include <drivers/gpio.h>
 #include <soc.h>
-#include <interrupt_controller/intc_sam0_eic.h>
+#include <drivers/interrupt_controller/sam0_eic.h>
 
 #include "gpio_utils.h"
 

drivers/gpio/gpio_stm32.c

@@ -14,7 +14,7 @@
 #include <pinmux/stm32/pinmux_stm32.h>
 #include <drivers/pinmux.h>
 #include <sys/util.h>
-#include <interrupt_controller/intc_exti_stm32.h>
+#include <drivers/interrupt_controller/exti_stm32.h>
 
 #include "gpio_stm32.h"
 #include "gpio_utils.h"

drivers/interrupt_controller/intc_exti_stm32.c

@@ -19,7 +19,7 @@
 #include <device.h>
 #include <soc.h>
 #include <sys/__assert.h>
-#include "intc_exti_stm32.h"
+#include <drivers/interrupt_controller/exti_stm32.h>
 
 #if defined(CONFIG_SOC_SERIES_STM32F0X) || \
     defined(CONFIG_SOC_SERIES_STM32L0X) || \

drivers/interrupt_controller/intc_sam0_eic.c

@@ -6,7 +6,7 @@
 
 #include <device.h>
 #include <soc.h>
-#include "intc_sam0_eic.h"
+#include <drivers/interrupt_controller/sam0_eic.h>
 #include "intc_sam0_eic_priv.h"
 
 struct sam0_eic_line_assignment {

include/drivers/interrupt_controller/exti_stm32.h

@@ -65,11 +65,12 @@ typedef void (*stm32_exti_callback_t) (int line, void *user);
  * @brief set EXTI interrupt callback
  *
  * @param line EXI# line
+ * @param port port index
  * @param cb   user callback
- * @param arg  user arg
+ * @param data user data
  */
-int stm32_exti_set_callback(int line, int port, stm32_exti_callback_t cb,
-				void *data);
+int stm32_exti_set_callback(int line, int port,
+			    stm32_exti_callback_t cb, void *data);
 
 /**
  * @brief unset EXTI interrupt callback

include/drivers/interrupt_controller/sam0_eic.h

@@ -40,6 +40,7 @@ enum sam0_eic_trigger {
  * @param port port index (A=0, etc)
  * @param pin pin in the port
  * @param trigger trigger condition
+ * @param filter enable filter
  * @param cb interrupt callback
  * @param data parameter to the interrupt callback
  */
@@ -79,6 +80,6 @@ int sam0_eic_disable_interrupt(int port, int pin);
  *
  * @param port port index (A=0, etc)
  */
-u32_t sam0_eic_interrupt_pending(int por);
+u32_t sam0_eic_interrupt_pending(int port);
 
 #endif /* ZEPHYR_DRIVERS_INTERRUPT_CONTROLLER_INTC_SAM0_EIC_H_ */