intr: Add Interrupt Manager implementation group

The shared BSP interrupt controller support code actually implements
parts of the Interrupt Manager.

Update #3706.

bsps/arm/altera-cyclone-v/include/bsp/irq.h

@@ -52,7 +52,7 @@ extern "C" {
  *
  * @ingroup RTEMSBSPsARMCycV
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief Intel Cyclone V Interrupt Support.
  *

bsps/arm/beagle/irq/irq.c

@@ -1,7 +1,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  * @ingroup arm_beagle
  *
  * @brief Interrupt support.

bsps/arm/lpc176x/include/bsp/irq.h

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief LPC176X interrupt definitions.
  */
@@ -43,7 +43,7 @@
 #endif
 
 /**
- * @addtogroup bsp_interrupt
+ * @addtogroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/arm/lpc176x/irq/irq.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief LPC176X interrupt support.
  */

bsps/arm/lpc24xx/include/bsp/irq.h

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief LPC24XX interrupt definitions.
  */
@@ -43,7 +43,7 @@
 #endif
 
 /**
- * @addtogroup bsp_interrupt
+ * @addtogroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/arm/lpc24xx/irq/irq-dispatch.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief LPC24XX interrupt support.
  */

bsps/arm/lpc24xx/irq/irq.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief LPC24XX interrupt support.
  */

bsps/arm/lpc32xx/include/bsp/irq.h

@@ -51,7 +51,7 @@ extern "C" {
  *
  * @ingroup RTEMSBSPsARMLPC32XX
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/include/bsp/irq-generic.h

@@ -3,10 +3,10 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
- * @brief This header file provides interfaces of the generic interrupt
- *   controller support.
+ * @brief This header file provides interfaces of the Interrupt Manager
+ *   implementation.
  */
 
 /*
@@ -101,29 +101,29 @@ static inline rtems_vector_number bsp_interrupt_dispatch_index(
 }
 
 /**
- * @defgroup bsp_interrupt BSP Interrupt Support
+ * @defgroup RTEMSImplClassicIntr Interrupt Manager
  *
- * @ingroup RTEMSBSPsShared
+ * @ingroup RTEMSImplClassic
  *
- * @brief Generic BSP Interrupt Support
+ * @brief This group contains the Interrupt Manager implementation.
  *
- * The BSP interrupt support manages a sequence of interrupt vector numbers
- * greater than or equal to zero and less than @ref BSP_INTERRUPT_VECTOR_COUNT
- * It provides methods to install, remove, and @ref
- * bsp_interrupt_handler_dispatch() "dispatch" interrupt entries for each
- * vector number.  It implements parts of the RTEMS interrupt manager.
+ * The Interrupt Manager implementation manages a sequence of interrupt vector
+ * numbers greater than or equal to zero and less than
+ * ``BSP_INTERRUPT_VECTOR_COUNT``.  It provides methods to install, remove, and
+ * dispatch interrupt entries for each vector number, see
+ * bsp_interrupt_dispatch_entries().
  *
  * The entry points to a list of interrupt entries are stored in a table
  * (= dispatch table).
  *
- * You have to configure the BSP interrupt support in the <bsp/irq.h> file
+ * You have to configure the Interrupt Manager implementation in the <bsp/irq.h> file
  * for each BSP.  For a minimum configuration you have to provide
- * @ref BSP_INTERRUPT_VECTOR_COUNT.
+ * ``BSP_INTERRUPT_VECTOR_COUNT``.
  *
  * For boards with small memory requirements you can define
- * @ref BSP_INTERRUPT_USE_INDEX_TABLE.  With an enabled index table the
+ * ``BSP_INTERRUPT_USE_INDEX_TABLE``.  With an enabled index table the
  * dispatch table will be accessed via a small index table.  You can define the
- * size of the dispatch table with @ref BSP_INTERRUPT_DISPATCH_TABLE_SIZE.
+ * size of the dispatch table with ``BSP_INTERRUPT_DISPATCH_TABLE_SIZE``.
  *
  * You have to provide some special routines in your BSP (follow the links for
  * the details):
@@ -175,7 +175,7 @@ static inline rtems_vector_number bsp_interrupt_dispatch_index(
 void bsp_interrupt_handler_default(rtems_vector_number vector);
 
 /**
- * @brief Initialize BSP interrupt support.
+ * @brief Initialize Interrupt Manager implementation.
  *
  * You must call this function before you can install, remove and dispatch
  * interrupt entries.  There is no protection against concurrent

bsps/include/bsp/irq-info.h

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This header file provides interfaces of the generic interrupt
  *   controller support for the RTEMS Shell.

bsps/lm32/include/bsp/irq.h

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief BSP interrupt support for LM32.
  */
@@ -41,7 +41,7 @@
 #include <stdint.h>
 
 /**
- * @addtogroup bsp_interrupt
+ * @addtogroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/mips/csb350/include/bsp/irq.h

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief interrupt definitions.
  */
@@ -45,7 +45,7 @@
 #endif
 
 /**
- * @addtogroup bsp_interrupt
+ * @addtogroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/mips/hurricane/include/bsp/irq.h

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief interrupt definitions.
  */
@@ -45,7 +45,7 @@
 #endif
 
 /**
- * @addtogroup bsp_interrupt
+ * @addtogroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/mips/jmr3904/include/bsp/irq.h

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief jmr3904 interrupt definitions.
  */
@@ -45,7 +45,7 @@
 #endif
 
 /**
- * @addtogroup bsp_interrupt
+ * @addtogroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/mips/malta/include/bsp/irq.h

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief Malta Interrupt Definitions
  */
@@ -45,7 +45,7 @@
 #endif
 
 /**
- * @addtogroup bsp_interrupt
+ * @addtogroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/mips/rbtx4925/include/bsp/irq.h

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief interrupt definitions.
  */
@@ -45,7 +45,7 @@
 #endif
 
 /**
- * @addtogroup bsp_interrupt
+ * @addtogroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/mips/rbtx4938/include/bsp/irq.h

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief interrupt definitions.
  */
@@ -45,7 +45,7 @@
 #endif
 
 /**
- * @addtogroup bsp_interrupt
+ * @addtogroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/mips/shared/irq/irq.c

@@ -1,7 +1,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief Interrupt support.
  */

bsps/powerpc/mpc55xxevb/include/bsp/irq.h

@@ -485,7 +485,7 @@ rtems_status_code mpc55xx_intc_raise_software_irq(rtems_vector_number vector);
 rtems_status_code mpc55xx_intc_clear_software_irq(rtems_vector_number vector);
 
 /**
- * @addtogroup bsp_interrupt
+ * @addtogroup RTEMSImplClassicIntr
  *
  * @{
  */

bsps/shared/irq/irq-affinity.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the implementation of
  *   rtems_interrupt_get_affinity() and rtems_interrupt_set_affinity().

bsps/shared/irq/irq-default-handler.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the default implementation of
  *   bsp_interrupt_handler_default().

bsps/shared/irq/irq-default.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the default implementation of
  *   bsp_interrupt_vector_enable(), bsp_interrupt_vector_disable(), and

bsps/shared/irq/irq-enable-disable.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the implementation of
  *   rtems_interrupt_get_attributes(), rtems_interrupt_vector_is_enabled(),

bsps/shared/irq/irq-entry-remove.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the implementation of
  *   rtems_interrupt_entry_remove() and bsp_interrupt_entry_remove().

bsps/shared/irq/irq-generic.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the generic interrupt controller support
  *   implementation.

bsps/shared/irq/irq-handler-install.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the rtems_interrupt_handler_install()
  *   implementation.

bsps/shared/irq/irq-handler-iterate.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the implementation of
  *   rtems_interrupt_handler_iterate().

bsps/shared/irq/irq-handler-remove.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the implementation of
  *   rtems_interrupt_handler_remove().

bsps/shared/irq/irq-info.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the implementation of
  *   bsp_interrupt_report() and bsp_interrupt_report_with_plugin().

bsps/shared/irq/irq-legacy.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the legacy interrupt controller support
  *   implementation.

bsps/shared/irq/irq-lock.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the implementation of
  *   bsp_interrupt_lock() and bsp_interrupt_unlock().

bsps/shared/irq/irq-raise-clear.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the implementation of
  *   rtems_interrupt_clear().

bsps/shared/irq/irq-record.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the implementation of the interrupt event
  *   recording support.

bsps/shared/irq/irq-server.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the interrupt server implementation.
  */

bsps/shared/irq/irq-shell.c

@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup bsp_interrupt
+ * @ingroup RTEMSImplClassicIntr
  *
  * @brief This source file contains the definition of
  *   ::bsp_interrupt_shell_command.