validation: Use spec:* references

Update #3716.

testsuites/validation/tc-acfg-one-cpu.c

@@ -73,7 +73,7 @@
  *
  *   - Check that the CONFIGURE_MAXIMUM_PRIORITY application configuration
  *     option resulted in the expected system setting using
- *     /rtems/task/if/maximum-priority.
+ *     spec:/rtems/task/if/maximum-priority.
  *
  *   - Check that the Deterministic Priority Scheduler which was configured by
  *     the CONFIGURE_SCHEDULER_PRIORITY application configuration in the test
@@ -122,7 +122,7 @@ static void AcfgValOneCpu_Action_0( void )
   /*
    * Check that the CONFIGURE_MAXIMUM_PRIORITY application configuration option
    * resulted in the expected system setting using
-   * /rtems/task/if/maximum-priority.
+   * spec:/rtems/task/if/maximum-priority.
    */
   T_eq_u32( RTEMS_MAXIMUM_PRIORITY, 127 );
 

testsuites/validation/tc-acfg.c

@@ -132,11 +132,11 @@
  *
  *   - Check the configured CONFIGURE_TASK_STACK_ALLOCATOR hook.  Using the
  *     test stack allocator validates also
- *     /acfg/if/init-task-construct-storage-size, since the
+ *     spec:/acfg/if/init-task-construct-storage-size, since the
  *     test_task_stack_allocate() allocate handler only supports
  *     CONFIGURE_MAXIMUM_TASKS minus one stacks and the validation test for
- *     /rtems/task/req/create-errors creates for some pre-condition variants
+ *     spec:/rtems/task/req/create-errors creates for some pre-condition
- *     all tasks until RTEMS_TOO_MANY is returned.  In addition,
+ *     variants all tasks until RTEMS_TOO_MANY is returned.  In addition,
  *     test_task_stack_allocate() checks that the allocation size is greater
  *     than or equal to TEST_MINIMUM_STACK_SIZE which validates
  *     CONFIGURE_MINIMUM_TASK_STACK_SIZE.
@@ -342,11 +342,12 @@ static void AcfgValAcfg_Action_0( void )
 
   /*
    * Check the configured CONFIGURE_TASK_STACK_ALLOCATOR hook.  Using the test
-   * stack allocator validates also /acfg/if/init-task-construct-storage-size,
+   * stack allocator validates also
-   * since the test_task_stack_allocate() allocate handler only supports
+   * spec:/acfg/if/init-task-construct-storage-size, since the
+   * test_task_stack_allocate() allocate handler only supports
    * CONFIGURE_MAXIMUM_TASKS minus one stacks and the validation test for
-   * /rtems/task/req/create-errors creates for some pre-condition variants all
+   * spec:/rtems/task/req/create-errors creates for some pre-condition variants
-   * tasks until RTEMS_TOO_MANY is returned.  In addition,
+   * all tasks until RTEMS_TOO_MANY is returned.  In addition,
    * test_task_stack_allocate() checks that the allocation size is greater than
    * or equal to TEST_MINIMUM_STACK_SIZE which validates
    * CONFIGURE_MINIMUM_TASK_STACK_SIZE.

testsuites/validation/tc-barrier-ident.c

@@ -66,7 +66,7 @@
  * This test case performs the following actions:
  *
  * - Run the generic object identification tests for Classic API partition
- *   class objects defined by /rtems/req/ident-local.
+ *   class objects defined by spec:/rtems/req/ident-local.
  *
  * @{
  */
@@ -83,7 +83,7 @@ static rtems_status_code ClassicBarrierIdentAction(
 
 /**
  * @brief Run the generic object identification tests for Classic API partition
- *   class objects defined by /rtems/req/ident-local.
+ *   class objects defined by spec:/rtems/req/ident-local.
  */
 static void RtemsBarrierValIdent_Action_0( void )
 {

testsuites/validation/tc-event-send-receive.c

@@ -72,7 +72,7 @@
  * This test case performs the following actions:
  *
  * - Run the event send and receive tests for the application event set defined
- *   by /rtems/event/req/send-receive.
+ *   by spec:/rtems/event/req/send-receive.
  *
  * @{
  */
@@ -105,7 +105,7 @@ static rtems_event_set GetPendingEvents( Thread_Control *thread )
 
 /**
  * @brief Run the event send and receive tests for the application event set
- *   defined by /rtems/event/req/send-receive.
+ *   defined by spec:/rtems/event/req/send-receive.
  */
 static void RtemsEventValSendReceive_Action_0( void )
 {
@@ -140,7 +140,7 @@ T_TEST_CASE( RtemsEventValSendReceive )
  * This test case performs the following actions:
  *
  * - Run the event send and receive tests for the system event set defined by
- *   /rtems/event/req/send-receive.
+ *   spec:/rtems/event/req/send-receive.
  *
  * @{
  */
@@ -178,7 +178,7 @@ static rtems_event_set GetPendingSystemEvents( Thread_Control *thread )
 
 /**
  * @brief Run the event send and receive tests for the system event set defined
- *   by /rtems/event/req/send-receive.
+ *   by spec:/rtems/event/req/send-receive.
  */
 static void RtemsEventValSystemSendReceive_Action_0( void )
 {

testsuites/validation/tc-message-ident.c

@@ -66,7 +66,7 @@
  * This test case performs the following actions:
  *
  * - Run the generic object identification tests for Classic API message queue
- *   class objects defined by /rtems/req/ident.
+ *   class objects defined by spec:/rtems/req/ident.
  *
  * @{
  */
@@ -95,7 +95,7 @@ static rtems_status_code ClassicMessageIdentAction(
 
 /**
  * @brief Run the generic object identification tests for Classic API message
- *   queue class objects defined by /rtems/req/ident.
+ *   queue class objects defined by spec:/rtems/req/ident.
  */
 static void RtemsMessageValIdent_Action_0( void )
 {

testsuites/validation/tc-part-ident.c

@@ -66,7 +66,7 @@
  * This test case performs the following actions:
  *
  * - Run the generic object identification tests for Classic API partition
- *   class objects defined by /rtems/req/ident.
+ *   class objects defined by spec:/rtems/req/ident.
  *
  * @{
  */
@@ -84,7 +84,7 @@ static rtems_status_code ClassicPartIdentAction(
 
 /**
  * @brief Run the generic object identification tests for Classic API partition
- *   class objects defined by /rtems/req/ident.
+ *   class objects defined by spec:/rtems/req/ident.
  */
 static void RtemsPartValIdent_Action_0( void )
 {

testsuites/validation/tc-ratemon-ident.c

@@ -66,7 +66,7 @@
  * This test case performs the following actions:
  *
  * - Run the generic object identification tests for Classic API rate monotonic
- *   class objects defined by /rtems/req/ident-local.
+ *   class objects defined by spec:/rtems/req/ident-local.
  *
  * @{
  */
@@ -83,7 +83,7 @@ static rtems_status_code ClassicRatemonIdentAction(
 
 /**
  * @brief Run the generic object identification tests for Classic API rate
- *   monotonic class objects defined by /rtems/req/ident-local.
+ *   monotonic class objects defined by spec:/rtems/req/ident-local.
  */
 static void RtemsRatemonValIdent_Action_0( void )
 {

testsuites/validation/tc-sem-flush.c

@@ -405,7 +405,7 @@ static void RtemsSemReqFlush_Post_Action_Check(
     case RtemsSemReqFlush_Post_Action_FlushFIFO: {
       /*
        * The calling task shall flush the semaphore as specified by
-       * /score/tq/req/flush-fifo.
+       * spec:/score/tq/req/flush-fifo.
        */
       ScoreTqReqFlushFifo_Run( &ctx->tq_ctx, false );
       break;
@@ -414,7 +414,7 @@ static void RtemsSemReqFlush_Post_Action_Check(
     case RtemsSemReqFlush_Post_Action_FlushPriority: {
       /*
        * The calling task shall flush the semaphore as specified by
-       * /score/tq/req/flush-priority.
+       * spec:/score/tq/req/flush-priority.
        */
       ScoreTqReqFlushPriority_Run( &ctx->tq_ctx, true );
       break;
@@ -423,7 +423,7 @@ static void RtemsSemReqFlush_Post_Action_Check(
     case RtemsSemReqFlush_Post_Action_FlushPriorityCeiling: {
       /*
        * The calling task shall flush the semaphore as specified by
-       * /score/tq/req/flush-priority.
+       * spec:/score/tq/req/flush-priority.
        */
       ScoreTqReqFlushPriority_Run( &ctx->tq_ctx, false );
       break;
@@ -432,7 +432,7 @@ static void RtemsSemReqFlush_Post_Action_Check(
     case RtemsSemReqFlush_Post_Action_FlushPriorityInherit: {
       /*
        * The calling task shall flush the semaphore as specified by
-       * /score/tq/req/flush-priority-inherit.
+       * spec:/score/tq/req/flush-priority-inherit.
        */
       ScoreTqReqFlushPriorityInherit_Run( &ctx->tq_ctx );
       break;

testsuites/validation/tc-sem-ident.c

@@ -66,7 +66,7 @@
  * This test case performs the following actions:
  *
  * - Run the generic object identification tests for Classic API semaphore
- *   class objects defined by /rtems/req/ident.
+ *   class objects defined by spec:/rtems/req/ident.
  *
  * @{
  */
@@ -84,7 +84,7 @@ static rtems_status_code ClassicSemIdentAction(
 
 /**
  * @brief Run the generic object identification tests for Classic API semaphore
- *   class objects defined by /rtems/req/ident.
+ *   class objects defined by spec:/rtems/req/ident.
  */
 static void RtemsSemValIdent_Action_0( void )
 {

testsuites/validation/tc-sem-obtain.c

@@ -390,7 +390,7 @@ static void RtemsSemReqObtain_Post_Action_Check(
     case RtemsSemReqObtain_Post_Action_SemSeizeTry: {
       /*
        * The calling task shall try to seize the semaphore as specified by
-       * /score/sem/req/seize-try.
+       * spec:/score/sem/req/seize-try.
        */
       ctx->tq_sem_ctx.get_count = TQSemGetCountClassic;
       ctx->tq_sem_ctx.set_count = TQSemSetCountClassic;
@@ -401,7 +401,7 @@ static void RtemsSemReqObtain_Post_Action_Check(
     case RtemsSemReqObtain_Post_Action_SemSeizeWait: {
       /*
        * The calling task shall wait to seize the semaphore as specified by
-       * /score/sem/req/seize-wait.
+       * spec:/score/sem/req/seize-wait.
        */
       ctx->tq_sem_ctx.get_count = TQSemGetCountClassic;
       ctx->tq_sem_ctx.set_count = TQSemSetCountClassic;
@@ -412,8 +412,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
     case RtemsSemReqObtain_Post_Action_MtxSeizeTry: {
       /*
        * The calling task shall try to seize the mutex as specified by
-       * /score/mtx/req/seize-try where an enqueue blocks, a recursive seize is
+       * spec:/score/mtx/req/seize-try where an enqueue blocks, a recursive
-       * allowed, and no locking protocol is used.
+       * seize is allowed, and no locking protocol is used.
        */
       ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_mtx_ctx.protocol = TQ_MTX_NO_PROTOCOL;
@@ -426,8 +426,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
     case RtemsSemReqObtain_Post_Action_MtxSeizeWait: {
       /*
        * The calling task shall wait to seize the mutex as specified by
-       * /score/mtx/req/seize-wait where an enqueue blocks, a recursive seize
+       * spec:/score/mtx/req/seize-wait where an enqueue blocks, a recursive
-       * is allowed, and no locking protocol is used.
+       * seize is allowed, and no locking protocol is used.
        */
       ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_mtx_ctx.protocol = TQ_MTX_NO_PROTOCOL;
@@ -440,8 +440,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
     case RtemsSemReqObtain_Post_Action_InheritMtxSeizeTry: {
       /*
        * The calling task shall try to seize the mutex as specified by
-       * /score/mtx/req/seize-try where an enqueue blocks, a recursive seize is
+       * spec:/score/mtx/req/seize-try where an enqueue blocks, a recursive
-       * allowed, and a priority inheritance protocol is used.
+       * seize is allowed, and a priority inheritance protocol is used.
        */
       ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_mtx_ctx.protocol = TQ_MTX_NO_PROTOCOL;
@@ -454,8 +454,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
     case RtemsSemReqObtain_Post_Action_InheritMtxSeizeWait: {
       /*
        * The calling task shall wait to seize the mutex as specified by
-       * /score/mtx/req/seize-wait where an enqueue blocks, a recursive seize
+       * spec:/score/mtx/req/seize-wait where an enqueue blocks, a recursive
-       * is allowed, and a priority inheritance protocol is used.
+       * seize is allowed, and a priority inheritance protocol is used.
        */
       ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_mtx_ctx.protocol = TQ_MTX_NO_PROTOCOL;
@@ -468,8 +468,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
     case RtemsSemReqObtain_Post_Action_CeilingMtxSeizeTry: {
       /*
        * The calling task shall try to seize the mutex as specified by
-       * /score/mtx/req/seize-try where an enqueue blocks, a recursive seize is
+       * spec:/score/mtx/req/seize-try where an enqueue blocks, a recursive
-       * allowed, and a priority ceiling is used.
+       * seize is allowed, and a priority ceiling is used.
        */
       ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_mtx_ctx.protocol = TQ_MTX_PRIORITY_CEILING;
@@ -482,8 +482,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
     case RtemsSemReqObtain_Post_Action_CeilingMtxSeizeWait: {
       /*
        * The calling task shall wait to seize the mutex as specified by
-       * /score/mtx/req/seize-wait where an enqueue blocks, a recursive seize
+       * spec:/score/mtx/req/seize-wait where an enqueue blocks, a recursive
-       * is allowed, and a priority ceiling is used.
+       * seize is allowed, and a priority ceiling is used.
        */
       ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_mtx_ctx.protocol = TQ_MTX_PRIORITY_CEILING;
@@ -496,8 +496,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
     case RtemsSemReqObtain_Post_Action_MrsPMtxSeizeTry: {
       /*
        * The calling task shall try to seize the mutex as specified by
-       * /score/mtx/req/seize-try where an enqueue is sticky, a recursive seize
+       * spec:/score/mtx/req/seize-try where an enqueue is sticky, a recursive
-       * returns an error status, and a priority ceiling is used.
+       * seize returns an error status, and a priority ceiling is used.
        */
       ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_STICKY;
       ctx->tq_mtx_ctx.protocol = TQ_MTX_MRSP;
@@ -510,7 +510,7 @@ static void RtemsSemReqObtain_Post_Action_Check(
     case RtemsSemReqObtain_Post_Action_MrsPMtxSeizeWait: {
       /*
        * The calling task shall wait to seize the mutex as specified by
-       * /score/mtx/req/seize-wait where an enqueue is sticky, a recursive
+       * spec:/score/mtx/req/seize-wait where an enqueue is sticky, a recursive
        * seize returns an error status, and a priority ceiling is used.
        */
       ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_STICKY;

testsuites/validation/tc-sem-release.c

@@ -331,7 +331,7 @@ static void RtemsSemReqRelease_Post_Action_Check(
     case RtemsSemReqRelease_Post_Action_BinarySurrender: {
       /*
        * The calling task shall surrender the binary semaphore as specified by
-       * /score/sem/req/surrender.
+       * spec:/score/sem/req/surrender.
        */
       ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_ctx.get_owner = NULL;
@@ -345,7 +345,7 @@ static void RtemsSemReqRelease_Post_Action_Check(
     case RtemsSemReqRelease_Post_Action_CountingSurrender: {
       /*
        * The calling task shall surrender the counting semaphore as specified
-       * by /score/sem/req/surrender.
+       * by spec:/score/sem/req/surrender.
        */
       ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_ctx.get_owner = NULL;
@@ -359,8 +359,9 @@ static void RtemsSemReqRelease_Post_Action_Check(
     case RtemsSemReqRelease_Post_Action_MtxSurrender: {
       /*
        * The calling task shall surrender the mutex as specified by
-       * /score/mtx/req/surrender where an enqueue blocks, a recursive seize is
+       * spec:/score/mtx/req/surrender where an enqueue blocks, a recursive
-       * allowed, the owner is checked, and no locking protocol is used.
+       * seize is allowed, the owner is checked, and no locking protocol is
+       * used.
        */
       ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_ctx.get_owner = TQGetOwnerClassicSem;
@@ -375,9 +376,9 @@ static void RtemsSemReqRelease_Post_Action_Check(
     case RtemsSemReqRelease_Post_Action_InheritMtxSurrender: {
       /*
        * The calling task shall surrender the mutex as specified by
-       * /score/mtx/req/surrender where an enqueue blocks, a recursive seize is
+       * spec:/score/mtx/req/surrender where an enqueue blocks, a recursive
-       * allowed, the owner is checked, and a priority inheritance protocol is
+       * seize is allowed, the owner is checked, and a priority inheritance
-       * used.
+       * protocol is used.
        */
       ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_ctx.get_owner = TQGetOwnerClassicSem;
@@ -392,8 +393,9 @@ static void RtemsSemReqRelease_Post_Action_Check(
     case RtemsSemReqRelease_Post_Action_CeilingMtxSurrender: {
       /*
        * The calling task shall surrender the mutex as specified by
-       * /score/mtx/req/surrender where an enqueue blocks, a recursive seize is
+       * spec:/score/mtx/req/surrender where an enqueue blocks, a recursive
-       * allowed, the owner is checked, and a priority ceiling is used.
+       * seize is allowed, the owner is checked, and a priority ceiling is
+       * used.
        */
       ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_BLOCKS;
       ctx->tq_ctx.get_owner = TQGetOwnerClassicSem;
@@ -408,9 +410,9 @@ static void RtemsSemReqRelease_Post_Action_Check(
     case RtemsSemReqRelease_Post_Action_MrsPMtxSurrender: {
       /*
        * The calling task shall surrender the mutex as specified by
-       * /score/mtx/req/surrender where an enqueue is sticky, a recursive seize
+       * spec:/score/mtx/req/surrender where an enqueue is sticky, a recursive
-       * returns an error status, the owner is checked, and a priority ceiling
+       * seize returns an error status, the owner is checked, and a priority
-       * is used.
+       * ceiling is used.
        */
       ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_STICKY;
       ctx->tq_ctx.get_owner = TQGetOwnerClassicSem;

testsuites/validation/tc-sem-timeout.c

@@ -273,7 +273,7 @@ static void RtemsSemReqTimeout_Post_Action_Check(
     case RtemsSemReqTimeout_Post_Action_Timeout: {
       /*
        * The semaphore obtain timeout actions shall be done as specified by
-       * /score/tq/req/timeout.
+       * spec:/score/tq/req/timeout.
        */
       ctx->tq_ctx.wait = TQ_WAIT_TIMED;
       ScoreTqReqTimeout_Run( &ctx->tq_ctx );
@@ -283,7 +283,7 @@ static void RtemsSemReqTimeout_Post_Action_Check(
     case RtemsSemReqTimeout_Post_Action_TimeoutMrsP: {
       /*
        * The semaphore obtain timeout actions shall be done as specified by
-       * /score/tq/req/timeout-mrsp.
+       * spec:/score/tq/req/timeout-mrsp.
        */
       ctx->tq_ctx.wait = TQ_WAIT_TIMED;
       ScoreTqReqTimeoutMrsp_Run( &ctx->tq_ctx );
@@ -293,7 +293,7 @@ static void RtemsSemReqTimeout_Post_Action_Check(
     case RtemsSemReqTimeout_Post_Action_TimeoutPriorityInherit: {
       /*
        * The semaphore obtain timeout actions shall be done as specified by
-       * /score/tq/req/timeout-priority-inherit.
+       * spec:/score/tq/req/timeout-priority-inherit.
        */
       ctx->tq_ctx.wait = TQ_WAIT_FOREVER;
       ScoreTqReqTimeoutPriorityInherit_Run( &ctx->tq_ctx );

testsuites/validation/tc-task-ident.c

@@ -167,7 +167,7 @@ static void RtemsTaskReqIdent_Pre_Name_Prepare(
       /*
        * While the ``name`` is not equal to RTEMS_WHO_AM_I or ``id`` parameter
        * is equal to NULL, the behaviour of rtems_task_ident() shall be
-       * specified by /rtems/req/ident.
+       * specified by spec:/rtems/req/ident.
        */
       ctx->id = NULL;
       /* Preparation performed by RtemsReqIdent_Run() */

testsuites/validation/tc-timer-ident.c

@@ -66,7 +66,7 @@
  * This test case performs the following actions:
  *
  * - Run the generic object identification tests for Classic API timer class
- *   objects defined by /rtems/req/ident-local.
+ *   objects defined by spec:/rtems/req/ident-local.
  *
  * @{
  */
@@ -83,7 +83,7 @@ static rtems_status_code ClassicTimerIdentAction(
 
 /**
  * @brief Run the generic object identification tests for Classic API timer
- *   class objects defined by /rtems/req/ident-local.
+ *   class objects defined by spec:/rtems/req/ident-local.
  */
 static void RtemsTimerValIdent_Action_0( void )
 {

testsuites/validation/tc-userext-ident.c

@@ -66,7 +66,7 @@
  * This test case performs the following actions:
  *
  * - Run the generic object identification tests for Classic API user extension
- *   class objects defined by /rtems/req/ident-local.
+ *   class objects defined by spec:/rtems/req/ident-local.
  *
  * @{
  */
@@ -83,7 +83,7 @@ static rtems_status_code ClassicUserExtIdentAction(
 
 /**
  * @brief Run the generic object identification tests for Classic API user
- *   extension class objects defined by /rtems/req/ident-local.
+ *   extension class objects defined by spec:/rtems/req/ident-local.
  */
 static void RtemsUserextValIdent_Action_0( void )
 {