doxygen: Use @anchor for appl config options

The application configuration options are documented in
"cpukit/doxygen/appl-config.h".  Since the application configuration
option defines are also present in multiple test program sources, the
"#OPTION" references cannot be mapped to a unique definition.  Add an
anchor for each option and reference it to avoid the issues with the
multiple definitions.

Update #3994.

13 files changed, 103 insertions, 99 deletions

diff --git a/cpukit/include/rtems/rtems/barrier.h b/cpukit/include/rtems/rtems/barrier.h
index 348610d886..d713930b1d 100644
--- a/cpukit/include/rtems/rtems/barrier.h
+++ b/cpukit/include/rtems/rtems/barrier.h
@@ -137,7 +137,7 @@ extern "C" {
  *
  * @retval ::RTEMS_TOO_MANY There was no inactive object available to create a
  *   barrier.  The number of barriers available to the application is
- *   configured through the #CONFIGURE_MAXIMUM_BARRIERS application
+ *   configured through the @ref CONFIGURE_MAXIMUM_BARRIERS application
  *   configuration option.
  *
  * @par Notes
@@ -157,7 +157,7 @@ extern "C" {
  *   cause the calling task to be preempted.
  *
  * * The number of barriers available to the application is configured through
- *   the #CONFIGURE_MAXIMUM_BARRIERS application configuration option.
+ *   the @ref CONFIGURE_MAXIMUM_BARRIERS application configuration option.
  *
  * * Where the object class corresponding to the directive is configured to use
  *   unlimited objects, the directive may allocate memory from the RTEMS
diff --git a/cpukit/include/rtems/rtems/clock.h b/cpukit/include/rtems/rtems/clock.h
index 2f541d46a2..3dff28e3d9 100644
--- a/cpukit/include/rtems/rtems/clock.h
+++ b/cpukit/include/rtems/rtems/clock.h
@@ -116,8 +116,8 @@ struct bintime;
  * before 2100-01-01:00:00.000000000Z.  The latest valid time of day accepted
  * by the POSIX clock_settime() is 2400-01-01T00:00:00.999999999Z.
  *
- * The specified time is based on the configured clock tick rate, see the
- * #CONFIGURE_MICROSECONDS_PER_TICK application configuration option.
+ * The specified time is based on the configured clock tick rate, see the @ref
+ * CONFIGURE_MICROSECONDS_PER_TICK application configuration option.
  *
  * Setting the time forward will fire all CLOCK_REALTIME timers which are
  * scheduled at a time point before or at the time set by the directive.  This
@@ -853,8 +853,8 @@ rtems_status_code rtems_clock_get_seconds_since_epoch(
  *   application.
  *
  * @par Notes
- * The number of clock ticks per second is defined indirectly by the
- * #CONFIGURE_MICROSECONDS_PER_TICK configuration option.
+ * The number of clock ticks per second is defined indirectly by the @ref
+ * CONFIGURE_MICROSECONDS_PER_TICK configuration option.
  *
  * @par Constraints
  * @parblock
diff --git a/cpukit/include/rtems/rtems/config.h b/cpukit/include/rtems/rtems/config.h
index 4a6e6c8e2e..dd9d1436b1 100644
--- a/cpukit/include/rtems/rtems/config.h
+++ b/cpukit/include/rtems/rtems/config.h
@@ -80,7 +80,7 @@ typedef struct {
    * @brief This member contains the maximum number of Classic API Tasks
    *   configured for this application.
    *
-   * See #CONFIGURE_MAXIMUM_TASKS.
+   * See @ref CONFIGURE_MAXIMUM_TASKS.
    */
   uint32_t maximum_tasks;
 
@@ -94,7 +94,7 @@ typedef struct {
    * @brief This member contains the maximum number of Classic API Timers
    *   configured for this application.
    *
-   * See #CONFIGURE_MAXIMUM_TIMERS.
+   * See @ref CONFIGURE_MAXIMUM_TIMERS.
    */
   uint32_t maximum_timers;
 
@@ -102,7 +102,7 @@ typedef struct {
    * @brief This member contains the maximum number of Classic API Semaphores
    *   configured for this application.
    *
-   * See #CONFIGURE_MAXIMUM_SEMAPHORES.
+   * See @ref CONFIGURE_MAXIMUM_SEMAPHORES.
    */
   uint32_t maximum_semaphores;
 
@@ -110,7 +110,7 @@ typedef struct {
    * @brief This member contains the maximum number of Classic API Message Queues
    *   configured for this application.
    *
-   * See #CONFIGURE_MAXIMUM_MESSAGE_QUEUES.
+   * See @ref CONFIGURE_MAXIMUM_MESSAGE_QUEUES.
    */
   uint32_t maximum_message_queues;
 
@@ -118,7 +118,7 @@ typedef struct {
    * @brief This member contains the maximum number of Classic API Partitions
    *   configured for this application.
    *
-   * See #CONFIGURE_MAXIMUM_PARTITIONS.
+   * See @ref CONFIGURE_MAXIMUM_PARTITIONS.
    */
   uint32_t maximum_partitions;
 
@@ -126,7 +126,7 @@ typedef struct {
    * @brief This member contains the maximum number of Classic API Regions
    *   configured for this application.
    *
-   * See #CONFIGURE_MAXIMUM_REGIONS.
+   * See @ref CONFIGURE_MAXIMUM_REGIONS.
    */
   uint32_t maximum_regions;
 
@@ -134,7 +134,7 @@ typedef struct {
    * @brief This member contains the maximum number of Classic API Dual-Ported
    *   Memories configured for this application.
    *
-   * See #CONFIGURE_MAXIMUM_PORTS.
+   * See @ref CONFIGURE_MAXIMUM_PORTS.
    */
   uint32_t maximum_ports;
 
@@ -142,7 +142,7 @@ typedef struct {
    * @brief This member contains the maximum number of Classic API Rate Monotonic
    *   Periods configured for this application.
    *
-   * See #CONFIGURE_MAXIMUM_PERIODS.
+   * See @ref CONFIGURE_MAXIMUM_PERIODS.
    */
   uint32_t maximum_periods;
 
@@ -150,7 +150,7 @@ typedef struct {
    * @brief This member contains the maximum number of Classic API Barriers
    *   configured for this application.
    *
-   * See #CONFIGURE_MAXIMUM_BARRIERS.
+   * See @ref CONFIGURE_MAXIMUM_BARRIERS.
    */
   uint32_t maximum_barriers;
 
@@ -158,7 +158,7 @@ typedef struct {
    * @brief This member contains the number of Classic API Initialization Tasks
    *   configured for this application.
    *
-   * See #CONFIGURE_RTEMS_INIT_TASKS_TABLE.
+   * See @ref CONFIGURE_RTEMS_INIT_TASKS_TABLE.
    */
   uint32_t number_of_initialization_tasks;
 
@@ -166,7 +166,7 @@ typedef struct {
    * @brief This member contains the pointer to Classic API Initialization Tasks
    *   Table of this application.
    *
-   * See #CONFIGURE_RTEMS_INIT_TASKS_TABLE.
+   * See @ref CONFIGURE_RTEMS_INIT_TASKS_TABLE.
    */
   const rtems_initialization_tasks_table *User_initialization_tasks_table;
 } rtems_api_configuration_table;
@@ -183,7 +183,7 @@ typedef struct {
  *   configured for this application.
  *
  * @par Notes
- * The resource number is defined by the #CONFIGURE_MAXIMUM_BARRIERS
+ * The resource number is defined by the @ref CONFIGURE_MAXIMUM_BARRIERS
  * application configuration option.  See also rtems_resource_is_unlimited()
  * and rtems_resource_maximum_per_allocation().
  *
@@ -210,7 +210,7 @@ uint32_t rtems_configuration_get_maximum_barriers( void );
  *   configured for this application.
  *
  * @par Notes
- * The resource number is defined by the #CONFIGURE_MAXIMUM_MESSAGE_QUEUES
+ * The resource number is defined by the @ref CONFIGURE_MAXIMUM_MESSAGE_QUEUES
  * application configuration option.  See also rtems_resource_is_unlimited()
  * and rtems_resource_maximum_per_allocation().
  *
@@ -237,7 +237,7 @@ uint32_t rtems_configuration_get_maximum_message_queues( void );
  *   configured for this application.
  *
  * @par Notes
- * The resource number is defined by the #CONFIGURE_MAXIMUM_PARTITIONS
+ * The resource number is defined by the @ref CONFIGURE_MAXIMUM_PARTITIONS
  * application configuration option.  See also rtems_resource_is_unlimited()
  * and rtems_resource_maximum_per_allocation().
  *
@@ -264,9 +264,9 @@ uint32_t rtems_configuration_get_maximum_partitions( void );
  *   configured for this application.
  *
  * @par Notes
- * The resource number is defined by the #CONFIGURE_MAXIMUM_PERIODS application
- * configuration option.  See also rtems_resource_is_unlimited() and
- * rtems_resource_maximum_per_allocation().
+ * The resource number is defined by the @ref CONFIGURE_MAXIMUM_PERIODS
+ * application configuration option.  See also rtems_resource_is_unlimited()
+ * and rtems_resource_maximum_per_allocation().
  *
  * @par Constraints
  * @parblock
@@ -291,9 +291,9 @@ uint32_t rtems_configuration_get_maximum_periods( void );
  *   configured for this application.
  *
  * @par Notes
- * The resource number is defined by the #CONFIGURE_MAXIMUM_PORTS application
- * configuration option.  See also rtems_resource_is_unlimited() and
- * rtems_resource_maximum_per_allocation().
+ * The resource number is defined by the @ref CONFIGURE_MAXIMUM_PORTS
+ * application configuration option.  See also rtems_resource_is_unlimited()
+ * and rtems_resource_maximum_per_allocation().
  *
  * @par Constraints
  * @parblock
@@ -318,9 +318,9 @@ uint32_t rtems_configuration_get_maximum_ports( void );
  *   configured for this application.
  *
  * @par Notes
- * The resource number is defined by the #CONFIGURE_MAXIMUM_REGIONS application
- * configuration option.  See also rtems_resource_is_unlimited() and
- * rtems_resource_maximum_per_allocation().
+ * The resource number is defined by the @ref CONFIGURE_MAXIMUM_REGIONS
+ * application configuration option.  See also rtems_resource_is_unlimited()
+ * and rtems_resource_maximum_per_allocation().
  *
  * @par Constraints
  * @parblock
@@ -345,7 +345,7 @@ uint32_t rtems_configuration_get_maximum_regions( void );
  *   configured for this application.
  *
  * @par Notes
- * The resource number is defined by the #CONFIGURE_MAXIMUM_SEMAPHORES
+ * The resource number is defined by the @ref CONFIGURE_MAXIMUM_SEMAPHORES
  * application configuration option.  See also rtems_resource_is_unlimited()
  * and rtems_resource_maximum_per_allocation().
  *
@@ -372,9 +372,9 @@ uint32_t rtems_configuration_get_maximum_semaphores( void );
  *   configured for this application.
  *
  * @par Notes
- * The resource number is defined by the #CONFIGURE_MAXIMUM_TASKS application
- * configuration option.  See also rtems_resource_is_unlimited() and
- * rtems_resource_maximum_per_allocation().
+ * The resource number is defined by the @ref CONFIGURE_MAXIMUM_TASKS
+ * application configuration option.  See also rtems_resource_is_unlimited()
+ * and rtems_resource_maximum_per_allocation().
  *
  * @par Constraints
  * @parblock
@@ -399,9 +399,9 @@ uint32_t rtems_configuration_get_maximum_tasks( void );
  *   configured for this application.
  *
  * @par Notes
- * The resource number is defined by the #CONFIGURE_MAXIMUM_TIMERS application
- * configuration option.  See also rtems_resource_is_unlimited() and
- * rtems_resource_maximum_per_allocation().
+ * The resource number is defined by the @ref CONFIGURE_MAXIMUM_TIMERS
+ * application configuration option.  See also rtems_resource_is_unlimited()
+ * and rtems_resource_maximum_per_allocation().
  *
  * @par Constraints
  * @parblock
diff --git a/cpukit/include/rtems/rtems/dpmem.h b/cpukit/include/rtems/rtems/dpmem.h
index 855ea3ddc6..48fbf9f9f3 100644
--- a/cpukit/include/rtems/rtems/dpmem.h
+++ b/cpukit/include/rtems/rtems/dpmem.h
@@ -114,7 +114,7 @@ extern "C" {
  *
  * @retval ::RTEMS_TOO_MANY There was no inactive object available to create a
  *   port.  The number of port available to the application is configured
- *   through the #CONFIGURE_MAXIMUM_PORTS application configuration option.
+ *   through the @ref CONFIGURE_MAXIMUM_PORTS application configuration option.
  *
  * @par Notes
  * @parblock
@@ -138,7 +138,7 @@ extern "C" {
  *   cause the calling task to be preempted.
  *
  * * The number of ports available to the application is configured through the
- *   #CONFIGURE_MAXIMUM_PORTS application configuration option.
+ *   @ref CONFIGURE_MAXIMUM_PORTS application configuration option.
  *
  * * Where the object class corresponding to the directive is configured to use
  *   unlimited objects, the directive may allocate memory from the RTEMS
diff --git a/cpukit/include/rtems/rtems/message.h b/cpukit/include/rtems/rtems/message.h
index 4f2bb69500..a7575b81e2 100644
--- a/cpukit/include/rtems/rtems/message.h
+++ b/cpukit/include/rtems/rtems/message.h
@@ -212,14 +212,14 @@ typedef struct {
  *
  * @retval ::RTEMS_TOO_MANY There was no inactive object available to create a
  *   message queue.  The number of message queue available to the application
- *   is configured through the #CONFIGURE_MAXIMUM_MESSAGE_QUEUES application
- *   configuration option.
+ *   is configured through the @ref CONFIGURE_MAXIMUM_MESSAGE_QUEUES
+ *   application configuration option.
  *
  * @retval ::RTEMS_TOO_MANY In multiprocessing configurations, there was no
  *   inactive global object available to create a global message queue.  The
  *   number of global objects available to the application is configured
- *   through the #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration
- *   option.
+ *   through the @ref CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application
+ *   configuration option.
  *
  * @retval ::RTEMS_INVALID_NUMBER The product of ``count`` and
  *   ``max_message_size`` is greater than the maximum storage size.
@@ -260,16 +260,16 @@ typedef struct {
  *   message to remote nodes.  This may preempt the calling task.
  *
  * * The number of message queues available to the application is configured
- *   through the #CONFIGURE_MAXIMUM_MESSAGE_QUEUES application configuration
- *   option.
+ *   through the @ref CONFIGURE_MAXIMUM_MESSAGE_QUEUES application
+ *   configuration option.
  *
  * * Where the object class corresponding to the directive is configured to use
  *   unlimited objects, the directive may allocate memory from the RTEMS
  *   Workspace.
  *
  * * The number of global objects available to the application is configured
- *   through the #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration
- *   option.
+ *   through the @ref CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application
+ *   configuration option.
  * @endparblock
  */
 rtems_status_code rtems_message_queue_create(
@@ -342,8 +342,8 @@ rtems_status_code rtems_message_queue_create(
  * runtime memory allocators.  This can simplify the application architecture
  * as well as any analysis that may be required.
  *
- * The value for #CONFIGURE_MESSAGE_BUFFER_MEMORY should not include memory for
- * message queues constructed by rtems_message_queue_construct().
+ * The value for @ref CONFIGURE_MESSAGE_BUFFER_MEMORY should not include memory
+ * for message queues constructed by rtems_message_queue_construct().
  * @endparblock
  *
  * @par Constraints
@@ -362,16 +362,16 @@ rtems_status_code rtems_message_queue_create(
  *   message to remote nodes.  This may preempt the calling task.
  *
  * * The number of message queues available to the application is configured
- *   through the #CONFIGURE_MAXIMUM_MESSAGE_QUEUES application configuration
- *   option.
+ *   through the @ref CONFIGURE_MAXIMUM_MESSAGE_QUEUES application
+ *   configuration option.
  *
  * * Where the object class corresponding to the directive is configured to use
  *   unlimited objects, the directive may allocate memory from the RTEMS
  *   Workspace.
  *
  * * The number of global objects available to the application is configured
- *   through the #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration
- *   option.
+ *   through the @ref CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application
+ *   configuration option.
  * @endparblock
  */
 rtems_status_code rtems_message_queue_construct(
diff --git a/cpukit/include/rtems/rtems/part.h b/cpukit/include/rtems/rtems/part.h
index 10091b48f4..f127fb8347 100644
--- a/cpukit/include/rtems/rtems/part.h
+++ b/cpukit/include/rtems/rtems/part.h
@@ -168,13 +168,13 @@ extern "C" {
  *
  * @retval ::RTEMS_TOO_MANY There was no inactive object available to create a
  *   partition.  The number of partitions available to the application is
- *   configured through the #CONFIGURE_MAXIMUM_PARTITIONS application
+ *   configured through the @ref CONFIGURE_MAXIMUM_PARTITIONS application
  *   configuration option.
  *
  * @retval ::RTEMS_TOO_MANY In multiprocessing configurations, there was no
  *   inactive global object available to create a global semaphore.  The number
  *   of global objects available to the application is configured through the
- *   #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration option.
+ *   @ref CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration option.
  *
  * @par Notes
  * @parblock
@@ -220,7 +220,7 @@ extern "C" {
  *   message to remote nodes.  This may preempt the calling task.
  *
  * * The number of partitions available to the application is configured
- *   through the #CONFIGURE_MAXIMUM_PARTITIONS application configuration
+ *   through the @ref CONFIGURE_MAXIMUM_PARTITIONS application configuration
  *   option.
  *
  * * Where the object class corresponding to the directive is configured to use
@@ -228,8 +228,8 @@ extern "C" {
  *   Workspace.
  *
  * * The number of global objects available to the application is configured
- *   through the #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration
- *   option.
+ *   through the @ref CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application
+ *   configuration option.
  * @endparblock
  */
 rtems_status_code rtems_partition_create(
diff --git a/cpukit/include/rtems/rtems/ratemon.h b/cpukit/include/rtems/rtems/ratemon.h
index 7c789a204b..1408b862f4 100644
--- a/cpukit/include/rtems/rtems/ratemon.h
+++ b/cpukit/include/rtems/rtems/ratemon.h
@@ -245,7 +245,8 @@ struct rtems_printer;
  *
  * @retval ::RTEMS_TOO_MANY There was no inactive object available to create a
  *   period.  The number of periods available to the application is configured
- *   through the #CONFIGURE_MAXIMUM_PERIODS application configuration option.
+ *   through the @ref CONFIGURE_MAXIMUM_PERIODS application configuration
+ *   option.
  *
  * @par Notes
  * @parblock
@@ -269,7 +270,7 @@ struct rtems_printer;
  *   cause the calling task to be preempted.
  *
  * * The number of periods available to the application is configured through
- *   the #CONFIGURE_MAXIMUM_PERIODS application configuration option.
+ *   the @ref CONFIGURE_MAXIMUM_PERIODS application configuration option.
  *
  * * Where the object class corresponding to the directive is configured to use
  *   unlimited objects, the directive may allocate memory from the RTEMS
diff --git a/cpukit/include/rtems/rtems/region.h b/cpukit/include/rtems/rtems/region.h
index 94a8d7008f..6cbc95d9bd 100644
--- a/cpukit/include/rtems/rtems/region.h
+++ b/cpukit/include/rtems/rtems/region.h
@@ -195,7 +195,8 @@ rtems_status_code rtems_region_get_segment_size(
  *
  * @retval ::RTEMS_TOO_MANY There was no inactive object available to create a
  *   region.  The number of regions available to the application is configured
- *   through the #CONFIGURE_MAXIMUM_REGIONS application configuration option.
+ *   through the @ref CONFIGURE_MAXIMUM_REGIONS application configuration
+ *   option.
  *
  * @retval ::RTEMS_INVALID_SIZE The ``page_size`` parameter was invalid.
  *
@@ -219,7 +220,7 @@ rtems_status_code rtems_region_get_segment_size(
  *   cause the calling task to be preempted.
  *
  * * The number of regions available to the application is configured through
- *   the #CONFIGURE_MAXIMUM_REGIONS application configuration option.
+ *   the @ref CONFIGURE_MAXIMUM_REGIONS application configuration option.
  *
  * * Where the object class corresponding to the directive is configured to use
  *   unlimited objects, the directive may allocate memory from the RTEMS
diff --git a/cpukit/include/rtems/rtems/scheduler.h b/cpukit/include/rtems/rtems/scheduler.h
index 8bd041558f..a582662000 100644
--- a/cpukit/include/rtems/rtems/scheduler.h
+++ b/cpukit/include/rtems/rtems/scheduler.h
@@ -383,8 +383,8 @@ uint32_t rtems_scheduler_get_processor( void );
  *
  * Where the system was built with SMP support enabled, this directive returns
  * the minimum of the processors (physically or virtually) available at the
- * target and the configured processor maximum (see
- * #CONFIGURE_MAXIMUM_PROCESSORS).  Not all processors in the range from
+ * target and the configured processor maximum (see @ref
+ * CONFIGURE_MAXIMUM_PROCESSORS).  Not all processors in the range from
  * processor index zero to the last processor index (which is the processor
  * maximum minus one) may be configured to be used by a scheduler or may be
  * online (online processors have a scheduler assigned).
diff --git a/cpukit/include/rtems/rtems/sem.h b/cpukit/include/rtems/rtems/sem.h
index 31156b5e43..2729438f97 100644
--- a/cpukit/include/rtems/rtems/sem.h
+++ b/cpukit/include/rtems/rtems/sem.h
@@ -203,13 +203,13 @@ extern "C" {
  *
  * @retval ::RTEMS_TOO_MANY There was no inactive object available to create a
  *   semaphore.  The number of semaphores available to the application is
- *   configured through the #CONFIGURE_MAXIMUM_SEMAPHORES application
+ *   configured through the @ref CONFIGURE_MAXIMUM_SEMAPHORES application
  *   configuration option.
  *
  * @retval ::RTEMS_TOO_MANY In multiprocessing configurations, there was no
  *   inactive global object available to create a global semaphore.  The number
  *   of global objects available to the application is configured through the
- *   #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration option.
+ *   @ref CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration option.
  *
  * @retval ::RTEMS_INVALID_PRIORITY The ``priority_ceiling`` parameter was
  *   invalid.
@@ -243,7 +243,7 @@ extern "C" {
  *   message to remote nodes.  This may preempt the calling task.
  *
  * * The number of semaphores available to the application is configured
- *   through the #CONFIGURE_MAXIMUM_SEMAPHORES application configuration
+ *   through the @ref CONFIGURE_MAXIMUM_SEMAPHORES application configuration
  *   option.
  *
  * * Where the object class corresponding to the directive is configured to use
@@ -251,8 +251,8 @@ extern "C" {
  *   Workspace.
  *
  * * The number of global objects available to the application is configured
- *   through the #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration
- *   option.
+ *   through the @ref CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application
+ *   configuration option.
  * @endparblock
  */
 rtems_status_code rtems_semaphore_create(
diff --git a/cpukit/include/rtems/rtems/support.h b/cpukit/include/rtems/rtems/support.h
index 356e29739b..69cda32048 100644
--- a/cpukit/include/rtems/rtems/support.h
+++ b/cpukit/include/rtems/rtems/support.h
@@ -115,8 +115,8 @@ static inline bool rtems_is_name_valid( rtems_name name )
  *   value.
  *
  * @par Notes
- * The number of clock ticks per second is defined by the
- * #CONFIGURE_MICROSECONDS_PER_TICK application configuration option.
+ * The number of clock ticks per second is defined by the @ref
+ * CONFIGURE_MICROSECONDS_PER_TICK application configuration option.
  *
  * @par Constraints
  * @parblock
@@ -166,8 +166,8 @@ static inline bool rtems_is_name_valid( rtems_name name )
  * @return Returns the number of clock ticks for the milliseconds value.
  *
  * @par Notes
- * The number of clock ticks per second is defined by the
- * #CONFIGURE_MICROSECONDS_PER_TICK application configuration option.
+ * The number of clock ticks per second is defined by the @ref
+ * CONFIGURE_MICROSECONDS_PER_TICK application configuration option.
  *
  * @par Constraints
  * @parblock
diff --git a/cpukit/include/rtems/rtems/tasks.h b/cpukit/include/rtems/rtems/tasks.h
index 6d643b7fbe..f28b464ec6 100644
--- a/cpukit/include/rtems/rtems/tasks.h
+++ b/cpukit/include/rtems/rtems/tasks.h
@@ -160,8 +160,8 @@ typedef struct {
    * alignment of an application executable.
    *
    * The application may configure the maximum thread-local storage size for all
-   * threads explicitly through the #CONFIGURE_MAXIMUM_THREAD_LOCAL_STORAGE_SIZE
-   * configuration option.
+   * threads explicitly through the @ref
+   * CONFIGURE_MAXIMUM_THREAD_LOCAL_STORAGE_SIZE configuration option.
    */
   size_t maximum_thread_local_storage_size;
 
@@ -325,8 +325,8 @@ rtems_task_priority _RTEMS_Maximum_priority( void );
  * risk of blown stacks for most user applications.  Using this constant when
  * specifying the task stack size, indicates that the stack size will be at
  * least RTEMS_MINIMUM_STACK_SIZE bytes in size.  If the user configured
- * minimum stack size (see #CONFIGURE_MINIMUM_TASK_STACK_SIZE) is larger than
- * the recommended minimum, then it will be used.
+ * minimum stack size (see @ref CONFIGURE_MINIMUM_TASK_STACK_SIZE) is larger
+ * than the recommended minimum, then it will be used.
  */
 #define RTEMS_MINIMUM_STACK_SIZE STACK_MINIMUM_SIZE
 
@@ -454,8 +454,8 @@ typedef bool( *rtems_task_visitor )( rtems_tcb *, void * );
  * The **stack size** of the task is specified in ``stack_size``.  If the
  * requested stack size is less than the configured minimum stack size, then
  * RTEMS will use the configured minimum as the stack size for this task.  The
- * configured minimum stack size is defined by the
- * #CONFIGURE_MINIMUM_TASK_STACK_SIZE application configuration option.  In
+ * configured minimum stack size is defined by the @ref
+ * CONFIGURE_MINIMUM_TASK_STACK_SIZE application configuration option.  In
  * addition to being able to specify the task stack size as a integer, there
  * are two constants which may be specified:
  *
@@ -583,12 +583,12 @@ typedef bool( *rtems_task_visitor )( rtems_tcb *, void * );
  *
  * @retval ::RTEMS_TOO_MANY There was no inactive object available to create a
  *   task.  The number of tasks available to the application is configured
- *   through the #CONFIGURE_MAXIMUM_TASKS application configuration option.
+ *   through the @ref CONFIGURE_MAXIMUM_TASKS application configuration option.
  *
  * @retval ::RTEMS_TOO_MANY In multiprocessing configurations, there was no
  *   inactive global object available to create a global task.  The number of
- *   global objects available to the application is configured through the
- *   #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration option.
+ *   global objects available to the application is configured through the @ref
+ *   CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration option.
  *
  * @retval ::RTEMS_UNSATISFIED There was not enough memory to allocate the task
  *   storage area.  The task storage area contains the task stack, the
@@ -615,7 +615,7 @@ typedef bool( *rtems_task_visitor )( rtems_tcb *, void * );
  * The task stack size shall account for an target processor dependent
  * interrupt stack frame which may be placed on the stack of the interrupted
  * task while servicing an interrupt.  The stack checker may be used to monitor
- * the stack usage, see #CONFIGURE_STACK_CHECKER_ENABLED.
+ * the stack usage, see @ref CONFIGURE_STACK_CHECKER_ENABLED.
  *
  * For control and maintenance of the task, RTEMS allocates a TCB from the
  * local TCB free pool and initializes it.
@@ -644,15 +644,15 @@ typedef bool( *rtems_task_visitor )( rtems_tcb *, void * );
  *   message to remote nodes.  This may preempt the calling task.
  *
  * * The number of tasks available to the application is configured through the
- *   #CONFIGURE_MAXIMUM_TASKS application configuration option.
+ *   @ref CONFIGURE_MAXIMUM_TASKS application configuration option.
  *
  * * Where the object class corresponding to the directive is configured to use
  *   unlimited objects, the directive may allocate memory from the RTEMS
  *   Workspace.
  *
  * * The number of global objects available to the application is configured
- *   through the #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration
- *   option.
+ *   through the @ref CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application
+ *   configuration option.
  * @endparblock
  */
 rtems_status_code rtems_task_create(
@@ -690,12 +690,13 @@ rtems_status_code rtems_task_create(
  * @retval ::RTEMS_INVALID_SIZE The thread-local storage size is greater than
  *   the maximum thread-local storage size specified in the task configuration.
  *   The thread-local storage size is determined by the thread-local variables
- *   used by the application and #CONFIGURE_MAXIMUM_THREAD_LOCAL_STORAGE_SIZE.
+ *   used by the application and @ref
+ *   CONFIGURE_MAXIMUM_THREAD_LOCAL_STORAGE_SIZE.
  *
  * @retval ::RTEMS_INVALID_SIZE The task storage area was too small to provide
- *   a task stack of the configured minimum size, see
- *   #CONFIGURE_MINIMUM_TASK_STACK_SIZE. The task storage area contains the
- *   task stack, the thread-local storage, and the floating-point context on
+ *   a task stack of the configured minimum size, see @ref
+ *   CONFIGURE_MINIMUM_TASK_STACK_SIZE. The task storage area contains the task
+ *   stack, the thread-local storage, and the floating-point context on
  *   architectures with a separate floating-point context.
  *
  * @retval ::RTEMS_TOO_MANY There was no inactive task object available to
@@ -736,11 +737,11 @@ rtems_status_code rtems_task_create(
  *
  * The stack space estimate done by <rtems/confdefs.h> assumes that all tasks
  * are created by rtems_task_create().  The estimate can be adjusted to take
- * user-provided task storage areas into account through the
- * #CONFIGURE_MINIMUM_TASKS_WITH_USER_PROVIDED_STORAGE application
- * configuration option.
+ * user-provided task storage areas into account through the @ref
+ * CONFIGURE_MINIMUM_TASKS_WITH_USER_PROVIDED_STORAGE application configuration
+ * option.
  *
- * The #CONFIGURE_MAXIMUM_TASKS should include tasks constructed by
+ * The @ref CONFIGURE_MAXIMUM_TASKS should include tasks constructed by
  * rtems_task_construct().
  * @endparblock
  *
@@ -760,15 +761,15 @@ rtems_status_code rtems_task_create(
  *   message to remote nodes.  This may preempt the calling task.
  *
  * * The number of tasks available to the application is configured through the
- *   #CONFIGURE_MAXIMUM_TASKS application configuration option.
+ *   @ref CONFIGURE_MAXIMUM_TASKS application configuration option.
  *
  * * Where the object class corresponding to the directive is configured to use
  *   unlimited objects, the directive may allocate memory from the RTEMS
  *   Workspace.
  *
  * * The number of global objects available to the application is configured
- *   through the #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration
- *   option.
+ *   through the @ref CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application
+ *   configuration option.
  * @endparblock
  */
 rtems_status_code rtems_task_construct(
diff --git a/cpukit/include/rtems/rtems/timer.h b/cpukit/include/rtems/rtems/timer.h
index 0f13c04bda..658d2517c1 100644
--- a/cpukit/include/rtems/rtems/timer.h
+++ b/cpukit/include/rtems/rtems/timer.h
@@ -284,7 +284,8 @@ typedef rtems_timer_service_routine ( *rtems_timer_service_routine_entry )( rtem
  *
  * @retval ::RTEMS_TOO_MANY There was no inactive object available to create a
  *   timer.  The number of timers available to the application is configured
- *   through the #CONFIGURE_MAXIMUM_TIMERS application configuration option.
+ *   through the @ref CONFIGURE_MAXIMUM_TIMERS application configuration
+ *   option.
  *
  * @par Notes
  * @parblock
@@ -308,7 +309,7 @@ typedef rtems_timer_service_routine ( *rtems_timer_service_routine_entry )( rtem
  *   cause the calling task to be preempted.
  *
  * * The number of timers available to the application is configured through
- *   the #CONFIGURE_MAXIMUM_TIMERS application configuration option.
+ *   the @ref CONFIGURE_MAXIMUM_TIMERS application configuration option.
  *
  * * Where the object class corresponding to the directive is configured to use
  *   unlimited objects, the directive may allocate memory from the RTEMS
@@ -600,7 +601,7 @@ rtems_status_code rtems_timer_fire_when(
  * * The directive may be called from within task context.
  *
  * * The number of timers available to the application is configured through
- *   the #CONFIGURE_MAXIMUM_TIMERS application configuration option.
+ *   the @ref CONFIGURE_MAXIMUM_TIMERS application configuration option.
  *
  * * Where the object class corresponding to the directive is configured to use
  *   unlimited objects, the directive may allocate memory from the RTEMS