Clean up sphinx warnings.

- Fix minor formatting issues. - Fix reference the gloassary TLS using ':term:'. - Make sure nothing is between an anchor and the heading where ':ref:' references the anchor. This meant moving all the recently added '.. index::' entries. Update #3232. Update #3229.
2025-05-15 07:16:37 +08:00 · 2017-11-13 13:25:18 +11:00 · 2017-11-13 13:25:18 +11:00 · 33849946ff
commit 33849946ff
parent ac0eaff941
35 changed files with 707 additions and 427 deletions
--- a/c-user/ada_support.rst
+++ b/c-user/ada_support.rst
@ -4,9 +4,8 @@
 .. COMMENT: On-Line Applications Research Corporation (OAR).
 .. COMMENT: All rights reserved.
 .. _ada_support
 .. index:: Ada
 .. _ada_support:
 Ada Support
 ************
--- a/c-user/board_support_packages.rst
+++ b/c-user/board_support_packages.rst
@ -4,13 +4,13 @@
 .. COMMENT: On-Line Applications Research Corporation (OAR).
 .. COMMENT: All rights reserved.
 Board Support Packages
 **********************
 .. index:: Board Support Packages
 .. index:: BSPs
 .. index:: BSP, definition
 Board Support Packages
 **********************
 Introduction
 ============
--- a/c-user/chains.rst
+++ b/c-user/chains.rst
@ -3,11 +3,11 @@
 .. COMMENT: Copyright 2014 Gedare Bloom.
 .. COMMENT: All rights reserved.
 .. index:: chains
 Chains
 ******
 .. index:: chains
 Introduction
 ============
--- a/c-user/clock_manager.rst
+++ b/c-user/clock_manager.rst
@ -4,11 +4,11 @@
 .. COMMENT: On-Line Applications Research Corporation (OAR).
 .. COMMENT: All rights reserved.
 .. index:: clock
 Clock Manager
 *************
 .. index:: clock
 Introduction
 ============
--- a/c-user/configuring_a_system.rst
+++ b/c-user/configuring_a_system.rst
--- a/c-user/constant_bandwidth_server.rst
+++ b/c-user/constant_bandwidth_server.rst
@ -4,11 +4,11 @@
 .. COMMENT: On-Line Applications Research Corporation (OAR).
 .. COMMENT: All rights reserved.
 .. index:: cbs
 Constant Bandwidth Server Scheduler API
 ***************************************
 .. index:: cbs
 Introduction
 ============
@ -40,11 +40,12 @@ provided by the CBS API are:
 - rtems_cbs_get_approved_budget_ - Get scheduler approved execution time
 Background
 ==========
 .. index:: CBS parameters
 .. index:: rtems_cbs_parameters
 Background
 ==========
 Constant Bandwidth Server Definitions
 -------------------------------------
@ -232,9 +233,9 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_cbs_initialize:
 .. index:: initialize the CBS library
 .. index:: rtems_cbs_initialize
 .. _rtems_cbs_initialize:
 CBS_INITIALIZE - Initialize the CBS library
 -------------------------------------------
@ -270,10 +271,11 @@ NOTES:
   \clearpage
 .. _rtems_cbs_cleanup:
 .. index:: cleanup the CBS library
 .. index:: rtems_cbs_cleanup
 .. _rtems_cbs_cleanup:
 CBS_CLEANUP - Cleanup the CBS library
 -------------------------------------
@ -300,10 +302,11 @@ NOTES:
   \clearpage
 .. _rtems_cbs_create_server:
 .. index:: create a new bandwidth server
 .. index:: rtems_cbs_create_server
 .. _rtems_cbs_create_server:
 CBS_CREATE_SERVER - Create a new bandwidth server
 -------------------------------------------------
@ -348,10 +351,11 @@ NOTES:
   \clearpage
 .. _rtems_cbs_attach_thread:
 .. index:: attach a thread to server
 .. index:: rtems_cbs_attach_thread
 .. _rtems_cbs_attach_thread:
 CBS_ATTACH_THREAD - Attach a thread to server
 ---------------------------------------------
@ -390,10 +394,11 @@ NOTES:
   \clearpage
 .. _rtems_cbs_detach_thread:
 .. index:: detach a thread from server
 .. index:: rtems_cbs_detach_thread
 .. _rtems_cbs_detach_thread:
 CBS_DETACH_THREAD - Detach a thread from server
 -----------------------------------------------
@ -427,10 +432,11 @@ NOTES:
   \clearpage
 .. _rtems_cbs_destroy_server:
 .. index:: destroy a bandwidth server
 .. index:: rtems_cbs_destroy_server
 .. _rtems_cbs_destroy_server:
 CBS_DESTROY_SERVER - Destroy a bandwidth server
 -----------------------------------------------
@ -464,10 +470,11 @@ NOTES:
   \clearpage
 .. _rtems_cbs_get_server_id:
 .. index:: get an ID of a server
 .. index:: rtems_cbs_get_server_id
 .. _rtems_cbs_get_server_id:
 CBS_GET_SERVER_ID - Get an ID of a server
 -----------------------------------------
@ -495,10 +502,11 @@ DESCRIPTION:
   \clearpage
 .. _rtems_cbs_get_parameters:
 .. index:: get scheduling parameters of a server
 .. index:: rtems_cbs_get_parameters
 .. _rtems_cbs_get_parameters:
 CBS_GET_PARAMETERS - Get scheduling parameters of a server
 ----------------------------------------------------------
@ -532,10 +540,11 @@ NOTES:
   \clearpage
 .. _rtems_cbs_set_parameters:
 .. index:: set scheduling parameters
 .. index:: rtems_cbs_set_parameters
 .. _rtems_cbs_set_parameters:
 CBS_SET_PARAMETERS - Set scheduling parameters
 ----------------------------------------------
@ -571,10 +580,11 @@ NOTES:
   \clearpage
 .. _rtems_cbs_get_execution_time:
 .. index:: get elapsed execution time
 .. index:: rtems_cbs_get_execution_time
 .. _rtems_cbs_get_execution_time:
 CBS_GET_EXECUTION_TIME - Get elapsed execution time
 ---------------------------------------------------
@ -609,10 +619,11 @@ NOTES:
   \clearpage
 .. _rtems_cbs_get_remaining_budget:
 .. index:: get remaining execution time
 .. index:: rtems_cbs_get_remaining_budget
 .. _rtems_cbs_get_remaining_budget:
 CBS_GET_REMAINING_BUDGET - Get remaining execution time
 -------------------------------------------------------
@ -647,10 +658,11 @@ NOTES:
   \clearpage
 .. _rtems_cbs_get_approved_budget:
 .. index:: get scheduler approved execution time
 .. index:: rtems_cbs_get_approved_budget
 .. _rtems_cbs_get_approved_budget:
 CBS_GET_APPROVED_BUDGET - Get scheduler approved execution time
 ---------------------------------------------------------------
--- a/c-user/cpu_usage_statistics.rst
+++ b/c-user/cpu_usage_statistics.rst
@ -110,9 +110,10 @@ calling sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_cpu_usage_report:
 .. index:: rtems_cpu_usage_report
 .. _rtems_cpu_usage_report:
 cpu_usage_report - Report CPU Usage Statistics
 ----------------------------------------------
@ -135,9 +136,10 @@ NOTES:
   \clearpage
 .. _rtems_cpu_usage_reset:
 .. index:: rtems_cpu_usage_reset
 .. _rtems_cpu_usage_reset:
 cpu_usage_reset - Reset CPU Usage Statistics
 --------------------------------------------
--- a/c-user/directive_status_codes.rst
+++ b/c-user/directive_status_codes.rst
@ -84,9 +84,10 @@ The directives are:
   \clearpage
 .. _rtems_status_text:
 .. index:: rtems_status_text
 .. _rtems_status_text:
 STATUS_TEXT - Returns the enumeration name for a status code
 ------------------------------------------------------------
--- a/c-user/dual_ports_memory_manager.rst
+++ b/c-user/dual_ports_memory_manager.rst
@ -99,10 +99,11 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_port_create:
 .. index:: create a port
 .. index:: rtems_port_create
 .. _rtems_port_create:
 PORT_CREATE - Create a port
 ---------------------------
@ -152,11 +153,12 @@ NOTES:
   \clearpage
 .. _rtems_port_ident:
 .. index:: get ID of a port
 .. index:: obtain ID of a port
 .. index:: rtems_port_ident
 .. _rtems_port_ident:
 PORT_IDENT - Get ID of a port
 -----------------------------
@ -193,10 +195,11 @@ NOTES:
   \clearpage
 .. _rtems_port_delete:
 .. index:: delete a port
 .. index:: rtems_port_delete
 .. _rtems_port_delete:
 PORT_DELETE - Delete a port
 ---------------------------
@ -230,10 +233,11 @@ NOTES:
   \clearpage
 .. _rtems_port_external_to_internal:
 .. index:: convert external to internal address
 .. index:: rtems_port_external_to_internal
 .. _rtems_port_external_to_internal:
 PORT_EXTERNAL_TO_INTERNAL - Convert external to internal address
 ----------------------------------------------------------------
@ -270,10 +274,11 @@ NOTES:
   \clearpage
 .. _rtems_port_internal_to_external:
 .. index:: convert internal to external address
 .. index:: rtems_port_internal_to_external
 .. _rtems_port_internal_to_external:
 PORT_INTERNAL_TO_EXTERNAL - Convert internal to external address
 ----------------------------------------------------------------
--- a/c-user/event_manager.rst
+++ b/c-user/event_manager.rst
@ -182,10 +182,11 @@ related constants, usage, and status codes.
   \clearpage
 .. _rtems_event_send:
 .. index:: send event set to a task
 .. index:: rtems_event_send
 .. _rtems_event_send:
 EVENT_SEND - Send event set to a task
 -------------------------------------
@ -233,10 +234,11 @@ NOTES:
   \clearpage
 .. _rtems_event_receive:
 .. index:: receive event condition
 .. index:: rtems_event_receive
 .. _rtems_event_receive:
 EVENT_RECEIVE - Receive event condition
 ---------------------------------------
--- a/c-user/fatal_error.rst
+++ b/c-user/fatal_error.rst
@ -4,9 +4,10 @@
 .. COMMENT: On-Line Applications Research Corporation (OAR).
 .. COMMENT: All rights reserved.
 .. _fatal_error_manager:
 .. index:: fatal errors
 .. _fatal_error_manager:
 Fatal Error Manager
 *******************
@ -386,9 +387,10 @@ INTERNAL_ERROR_LIBIO_STDERR_FD_OPEN_FAILED (37)
 Operations
 ==========
 .. _Terminate:
 .. index:: _Terminate
 .. _Terminate:
 Announcing a Fatal Error
 ------------------------
@ -441,11 +443,12 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_fatal:
 .. index:: announce fatal error
 .. index:: fatal error, announce
 .. index:: rtems_fatal
 .. _rtems_fatal:
 FATAL - Invoke the fatal error
 ------------------------------
@ -471,10 +474,11 @@ NOTE:
   \clearpage
 .. _rtems_shutdown_executive:
 .. index:: shutdown RTEMS
 .. index:: rtems_shutdown_executive
 .. _rtems_shutdown_executive:
 SHUTDOWN_EXECUTIVE - Shutdown RTEMS
 -----------------------------------
@ -503,10 +507,11 @@ NOTES:
   \clearpage
 .. _rtems_exception_frame_print:
 .. index:: exception frame
 .. index:: rtems_exception_frame_print
 .. _rtems_exception_frame_print:
 EXCEPTION_FRAME_PRINT - Prints the exception frame
 --------------------------------------------------
@ -527,10 +532,11 @@ DESCRIPTION:
   \clearpage
 .. _rtems_fatal_source_text:
 .. index:: fatal error
 .. index:: rtems_fatal_source_text
 .. _rtems_fatal_source_text:
 FATAL_SOURCE_TEXT - Returns a text for a fatal source
 -----------------------------------------------------
@ -552,10 +558,11 @@ DESCRIPTION:
   \clearpage
 .. _rtems_internal_error_text:
 .. index:: fatal error
 .. index:: rtems_internal_error_text
 .. _rtems_internal_error_text:
 INTERNAL_ERROR_TEXT - Returns a text for an internal error code
 ---------------------------------------------------------------
@ -577,11 +584,12 @@ DESCRIPTION:
   \clearpage
 .. _rtems_fatal_error_occurred:
 .. index:: announce fatal error
 .. index:: fatal error, announce
 .. index:: rtems_fatal_error_occurred
 .. _rtems_fatal_error_occurred:
 FATAL_ERROR_OCCURRED - Invoke the fatal error handler (deprecated)
 ------------------------------------------------------------------
--- a/c-user/initialization.rst
+++ b/c-user/initialization.rst
@ -71,7 +71,7 @@ Initializing RTEMS
 ------------------
 The Initialization Manager :c:func:`rtems_initialize_executive()` directives is
-called by the :c:ref:`boot_card()` routine which is invoked by the Board
+called by the :c:func:`boot_card()` routine which is invoked by the Board
 Support Package once a basic C run-time environment is set up.  This consists
 of
@ -305,11 +305,12 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_initialize_executive:
 .. index:: initialize RTEMS
 .. index:: start multitasking
 .. index:: rtems_initialize_executive
 .. _rtems_initialize_executive:
 INITIALIZE_EXECUTIVE - Initialize RTEMS
 ---------------------------------------
--- a/c-user/interrupt_manager.rst
+++ b/c-user/interrupt_manager.rst
@ -268,11 +268,12 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_interrupt_catch:
 .. index:: establish an ISR
 .. index:: install an ISR
 .. index:: rtems_interrupt_catch
 .. _rtems_interrupt_catch:
 INTERRUPT_CATCH - Establish an ISR
 ----------------------------------
@ -312,10 +313,11 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_disable:
 .. index:: disable interrupts
 .. index:: rtems_interrupt_disable
 .. _rtems_interrupt_disable:
 INTERRUPT_DISABLE - Disable Interrupts
 --------------------------------------
@ -350,10 +352,11 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_enable:
 .. index:: enable interrupts
 .. index:: rtems_interrupt_enable
 .. _rtems_interrupt_enable:
 INTERRUPT_ENABLE - Enable Interrupts
 ------------------------------------
@ -385,10 +388,11 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_flash:
 .. index:: flash interrupts
 .. index:: rtems_interrupt_flash
 .. _rtems_interrupt_flash:
 INTERRUPT_FLASH - Flash Interrupts
 ----------------------------------
@ -420,10 +424,11 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_local_disable:
 .. index:: disable interrupts
 .. index:: rtems_interrupt_local_disable
 .. _rtems_interrupt_local_disable:
 INTERRUPT_LOCAL_DISABLE - Disable Interrupts on Current Processor
 -----------------------------------------------------------------
@ -457,10 +462,11 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_local_enable:
 .. index:: enable interrupts
 .. index:: rtems_interrupt_local_enable
 .. _rtems_interrupt_local_enable:
 INTERRUPT_LOCAL_ENABLE - Enable Interrupts on Current Processor
 ---------------------------------------------------------------
@ -488,9 +494,10 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_lock_initialize:
 .. index:: rtems_interrupt_lock_initialize
 .. _rtems_interrupt_lock_initialize:
 INTERRUPT_LOCK_INITIALIZE - Initialize an ISR Lock
 --------------------------------------------------
@ -516,9 +523,10 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_lock_acquire:
 .. index:: rtems_interrupt_lock_acquire
 .. _rtems_interrupt_lock_acquire:
 INTERRUPT_LOCK_ACQUIRE - Acquire an ISR Lock
 --------------------------------------------
@ -551,9 +559,10 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_lock_release:
 .. index:: rtems_interrupt_lock_release
 .. _rtems_interrupt_lock_release:
 INTERRUPT_LOCK_RELEASE - Release an ISR Lock
 --------------------------------------------
@ -583,9 +592,10 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_lock_acquire_isr:
 .. index:: rtems_interrupt_lock_acquire_isr
 .. _rtems_interrupt_lock_acquire_isr:
 INTERRUPT_LOCK_ACQUIRE_ISR - Acquire an ISR Lock from ISR
 ---------------------------------------------------------
@ -621,9 +631,10 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_lock_release_isr:
 .. index:: rtems_interrupt_lock_release_isr
 .. _rtems_interrupt_lock_release_isr:
 INTERRUPT_LOCK_RELEASE_ISR - Release an ISR Lock from ISR
 ---------------------------------------------------------
@ -653,10 +664,11 @@ NOTES:
   \clearpage
 .. _rtems_interrupt_is_in_progress:
 .. index:: is interrupt in progress
 .. index:: rtems_interrupt_is_in_progress
 .. _rtems_interrupt_is_in_progress:
 INTERRUPT_IS_IN_PROGRESS - Is an ISR in Progress
 ------------------------------------------------
--- a/c-user/io_manager.rst
+++ b/c-user/io_manager.rst
@ -230,10 +230,11 @@ related constants, usage, and status codes.
   \clearpage
 .. _rtems_io_register_driver:
 .. index:: register a device driver
 .. index:: rtems_io_register_driver
 .. _rtems_io_register_driver:
 IO_REGISTER_DRIVER - Register a device driver
 ---------------------------------------------
@ -288,10 +289,11 @@ NOTES:
   \clearpage
 .. _rtems_io_unregister_driver:
 .. index:: unregister a device driver
 .. index:: rtems_io_unregister_driver
 .. _rtems_io_unregister_driver:
 IO_UNREGISTER_DRIVER - Unregister a device driver
 -------------------------------------------------
@ -321,10 +323,11 @@ NOTES:
   \clearpage
 .. _rtems_io_initialize:
 .. index:: initialize a device driver
 .. index:: rtems_io_initialize
 .. _rtems_io_initialize:
 IO_INITIALIZE - Initialize a device driver
 ------------------------------------------
@ -364,10 +367,11 @@ NOTES:
   \clearpage
 .. _rtems_io_register_name:
 .. index:: register device
 .. index:: rtems_io_register_name
 .. _rtems_io_register_name:
 IO_REGISTER_NAME - Register a device
 ------------------------------------
@ -399,10 +403,11 @@ NOTES:
   \clearpage
 .. _rtems_io_lookup_name:
 .. index:: lookup device major and minor number
 .. index:: rtems_io_lookup_name
 .. _rtems_io_lookup_name:
 IO_LOOKUP_NAME - Lookup a device
 --------------------------------
@ -434,10 +439,11 @@ NOTES:
   \clearpage
 .. _rtems_io_open:
 .. index:: open a devive
 .. index:: rtems_io_open
 .. _rtems_io_open:
 IO_OPEN - Open a device
 -----------------------
@ -472,10 +478,11 @@ NOTES:
   \clearpage
 .. _rtems_io_close:
 .. index:: close a device
 .. index:: rtems_io_close
 .. _rtems_io_close:
 IO_CLOSE - Close a device
 -------------------------
@ -510,10 +517,11 @@ NOTES:
   \clearpage
 .. _rtems_io_read:
 .. index:: read from a device
 .. index:: rtems_io_read
 .. _rtems_io_read:
 IO_READ - Read from a device
 ----------------------------
@ -549,10 +557,11 @@ NOTES:
   \clearpage
 .. _rtems_io_write:
 .. index:: write to a device
 .. index:: rtems_io_write
 .. _rtems_io_write:
 IO_WRITE - Write to a device
 ----------------------------
@ -588,11 +597,12 @@ NOTES:
   \clearpage
 .. _rtems_io_control:
 .. index:: special device services
 .. index:: IO Control
 .. index:: rtems_io_control
 .. _rtems_io_control:
 IO_CONTROL - Special device services
 ------------------------------------
--- a/c-user/key_concepts.rst
+++ b/c-user/key_concepts.rst
@ -270,9 +270,10 @@ relationships define a directed acyclic graph (DAG).  The run-time of the mutex
 obtain, release and timeout operations depend on the complexity of this
 resource dependency graph.
 .. _PriorityInversion:
 .. index:: priority inversion
 .. _PriorityInversion:
 Priority Inversion
 ------------------
@ -286,10 +287,11 @@ priority tasks.  Because the low priority task is not executing, it cannot
 complete its interaction with the resource and release that resource.  The high
 priority task is effectively prevented from executing by lower priority tasks.
 .. _PriorityCeiling:
 .. index:: priority ceiling protocol
 .. index:: immediate ceiling priority protocol
 .. _PriorityCeiling:
 Immediate Ceiling Priority Protocol (ICPP)
 ------------------------------------------
@ -312,9 +314,10 @@ may occur while a thread owns a particular mutex, the priority inheritance
 protocol is more forgiving in that it does not require this apriori
 information.
 .. _PriorityInheritance:
 .. index:: priority inheritance protocol
 .. _PriorityInheritance:
 Priority Inheritance Protocol
 -----------------------------
@ -323,9 +326,10 @@ threads that currently wait for ownership of this mutex :cite:`Sha:1990:PI`.
 Since RTEMS 5.1, priority updates due to the priority inheritance protocol
 take place immediately and are propagated recursively.
 .. _MrsP:
 .. index:: Multiprocessor Resource Sharing Protocol (MrsP)
 .. _MrsP:
 Multiprocessor Resource Sharing Protocol (MrsP)
 -----------------------------------------------
@ -344,9 +348,10 @@ protocol is available since RTEMS 4.11. It was re-implemented in RTEMS 5.1 to
 overcome some shortcomings of the original implementation
 :cite:`Catellani:2015:MrsP`.
 .. _OMIP:
 .. index:: O(m) Independence-Preserving Protocol (OMIP)
 .. _OMIP:
 O(m) Independence-Preserving Protocol (OMIP)
 ----------------------------------------------------
--- a/c-user/linker_sets.rst
+++ b/c-user/linker_sets.rst
@ -4,9 +4,10 @@
 .. COMMENT: On-Line Applications Research Corporation (OAR).
 .. COMMENT: All rights reserved.
 .. _linker_sets:
 .. index:: linkersets
 .. _linker_sets:
 Linker Sets
 ***********
@ -126,9 +127,10 @@ Directives
   \clearpage
 .. _RTEMS_LINKER_SET_BEGIN:
 .. index:: RTEMS_LINKER_SET_BEGIN
 .. _RTEMS_LINKER_SET_BEGIN:
 RTEMS_LINKER_SET_BEGIN - Designator of the linker set begin marker
 ------------------------------------------------------------------
@ -159,9 +161,10 @@ NOTE:
   \clearpage
 .. _RTEMS_LINKER_SET_END:
 .. index:: RTEMS_LINKER_SET_END
 .. _RTEMS_LINKER_SET_END:
 RTEMS_LINKER_SET_END - Designator of the linker set end marker
 --------------------------------------------------------------
@ -181,9 +184,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_SET_SIZE:
 .. index:: RTEMS_LINKER_SET_SIZE
 .. _RTEMS_LINKER_SET_SIZE:
 RTEMS_LINKER_SET_SIZE - The linker set size in characters
 ---------------------------------------------------------
@ -202,9 +206,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_SET_ITEM_COUNT:
 .. index:: RTEMS_LINKER_SET_ITEM_COUNT
 .. _RTEMS_LINKER_SET_ITEM_COUNT:
 RTEMS_LINKER_SET_ITEM_COUNT - The linker set item count
 ---------------------------------------------------------
@ -222,9 +227,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_SET_IS_EMPTY:
 .. index:: RTEMS_LINKER_SET_IS_EMPTY
 .. _RTEMS_LINKER_SET_IS_EMPTY:
 RTEMS_LINKER_SET_IS_EMPTY - Is the linker set empty?
 ---------------------------------------------------------
@ -243,9 +249,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_SET_FOREACH:
 .. index:: RTEMS_LINKER_SET_FOREACH
 .. _RTEMS_LINKER_SET_FOREACH:
 RTEMS_LINKER_SET_FOREACH - Iterate through the linker set items
 ---------------------------------------------------------
@ -279,9 +286,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_ROSET_DECLARE:
 .. index:: RTEMS_LINKER_ROSET_DECLARE
 .. _RTEMS_LINKER_ROSET_DECLARE:
 RTEMS_LINKER_ROSET_DECLARE - Declares a read-only linker set
 ------------------------------------------------------------
@ -302,9 +310,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_ROSET:
 .. index:: RTEMS_LINKER_ROSET
 .. _RTEMS_LINKER_ROSET:
 RTEMS_LINKER_ROSET - Defines a read-only linker set
 ---------------------------------------------------
@ -325,9 +334,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_ROSET_ITEM_DECLARE:
 .. index:: RTEMS_LINKER_ROSET_ITEM_DECLARE
 .. _RTEMS_LINKER_ROSET_ITEM_DECLARE:
 RTEMS_LINKER_ROSET_ITEM_DECLARE - Declares a read-only linker set item
 ----------------------------------------------------------------------
@ -350,9 +360,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_ROSET_ITEM_REFERENCE:
 .. index:: RTEMS_LINKER_ROSET_ITEM_REFERENCE
 .. _RTEMS_LINKER_ROSET_ITEM_REFERENCE:
 RTEMS_LINKER_ROSET_ITEM_REFERENCE - References a read-only linker set item
 --------------------------------------------------------------------------
@ -375,9 +386,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_ROSET_ITEM:
 .. index:: RTEMS_LINKER_ROSET_ITEM
 .. _RTEMS_LINKER_ROSET_ITEM:
 RTEMS_LINKER_ROSET_ITEM - Defines a read-only linker set item
 -------------------------------------------------------------
@ -400,9 +412,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_ROSET_ITEM_ORDERED:
 .. index:: RTEMS_LINKER_ROSET_ITEM_ORDERED
 .. _RTEMS_LINKER_ROSET_ITEM_ORDERED:
 RTEMS_LINKER_ROSET_ITEM_ORDERED - Defines an ordered read-only linker set item
 ------------------------------------------------------------------------------
@ -457,9 +470,10 @@ NOTES:
   \clearpage
 .. _RTEMS_LINKER_ROSET_CONTENT:
 .. index:: RTEMS_LINKER_ROSET_CONTENT
 .. _RTEMS_LINKER_ROSET_CONTENT:
 RTEMS_LINKER_ROSET_CONTENT - Marks a declaration as a read-only linker set content
 ----------------------------------------------------------------------------------
@ -479,9 +493,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_RWSET_DECLARE:
 .. index:: RTEMS_LINKER_RWSET_DECLARE
 .. _RTEMS_LINKER_RWSET_DECLARE:
 RTEMS_LINKER_RWSET_DECLARE - Declares a read-write linker set
 -------------------------------------------------------------
@ -502,9 +517,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_RWSET:
 .. index:: RTEMS_LINKER_RWSET
 .. _RTEMS_LINKER_RWSET:
 RTEMS_LINKER_RWSET - Defines a read-write linker set
 ----------------------------------------------------
@ -525,9 +541,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_RWSET_ITEM_DECLARE:
 .. index:: RTEMS_LINKER_RWSET_ITEM_DECLARE
 .. _RTEMS_LINKER_RWSET_ITEM_DECLARE:
 RTEMS_LINKER_RWSET_ITEM_DECLARE - Declares a read-write linker set item
 -----------------------------------------------------------------------
@ -550,9 +567,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_RWSET_ITEM_REFERENCE:
 .. index:: RTEMS_LINKER_RWSET_ITEM_REFERENCE
 .. _RTEMS_LINKER_RWSET_ITEM_REFERENCE:
 RTEMS_LINKER_RWSET_ITEM_REFERENCE - References a read-write linker set item
 ---------------------------------------------------------------------------
@ -575,9 +593,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_RWSET_ITEM:
 .. index:: RTEMS_LINKER_RWSET_ITEM
 .. _RTEMS_LINKER_RWSET_ITEM:
 RTEMS_LINKER_RWSET_ITEM - Defines a read-write linker set item
 --------------------------------------------------------------
@ -600,9 +619,10 @@ DESCRIPTION:
   \clearpage
 .. _RTEMS_LINKER_RWSET_ITEM_ORDERED:
 .. index:: RTEMS_LINKER_RWSET_ITEM_ORDERED
 .. _RTEMS_LINKER_RWSET_ITEM_ORDERED:
 RTEMS_LINKER_RWSET_ITEM_ORDERED - Defines an ordered read-write linker set item
 -------------------------------------------------------------------------------
@ -657,9 +677,10 @@ NOTES:
   \clearpage
 .. _RTEMS_LINKER_RWSET_CONTENT:
 .. index:: RTEMS_LINKER_RWSET_CONTENT
 .. _RTEMS_LINKER_RWSET_CONTENT:
 RTEMS_LINKER_RWSET_CONTENT - Marks a declaration as a read-write linker set content
 -----------------------------------------------------------------------------------
--- a/c-user/message_manager.rst
+++ b/c-user/message_manager.rst
@ -220,10 +220,11 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_message_queue_create:
 .. index:: create a message queue
 .. index:: rtems_message_queue_create
 .. _rtems_message_queue_create:
 MESSAGE_QUEUE_CREATE - Create a queue
 -------------------------------------
@ -307,10 +308,11 @@ NOTES:
   \clearpage
 .. _rtems_message_queue_ident:
 .. index:: get ID of a message queue
 .. index:: rtems_message_queue_ident
 .. _rtems_message_queue_ident:
 MESSAGE_QUEUE_IDENT - Get ID of a queue
 ---------------------------------------
@ -360,10 +362,11 @@ NOTES:
   \clearpage
 .. _rtems_message_queue_delete:
 .. index:: delete a message queue
 .. index:: rtems_message_queue_delete
 .. _rtems_message_queue_delete:
 MESSAGE_QUEUE_DELETE - Delete a queue
 -------------------------------------
@ -418,10 +421,11 @@ NOTES:
   \clearpage
 .. _rtems_message_queue_send:
 .. index:: send message to a queue
 .. index:: rtems_message_queue_send
 .. _rtems_message_queue_send:
 MESSAGE_QUEUE_SEND - Put message at rear of a queue
 ---------------------------------------------------
@ -475,10 +479,11 @@ NOTES:
   \clearpage
 .. _rtems_message_queue_urgent:
 .. index:: put message at front of queue
 .. index:: rtems_message_queue_urgent
 .. _rtems_message_queue_urgent:
 MESSAGE_QUEUE_URGENT - Put message at front of a queue
 ------------------------------------------------------
@ -532,10 +537,11 @@ NOTES:
   \clearpage
 .. _rtems_message_queue_broadcast:
 .. index:: broadcast message to a queue
 .. index:: rtems_message_queue_broadcast
 .. _rtems_message_queue_broadcast:
 MESSAGE_QUEUE_BROADCAST - Broadcast N messages to a queue
 ---------------------------------------------------------
@ -592,10 +598,11 @@ NOTES:
   \clearpage
 .. _rtems_message_queue_receive:
 .. index:: receive message from a queue
 .. index:: rtems_message_queue_receive
 .. _rtems_message_queue_receive:
 MESSAGE_QUEUE_RECEIVE - Receive message from a queue
 ----------------------------------------------------
@ -679,10 +686,11 @@ NOTES:
   \clearpage
 .. _rtems_message_queue_get_number_pending:
 .. index:: get number of pending messages
 .. index:: rtems_message_queue_get_number_pending
 .. _rtems_message_queue_get_number_pending:
 MESSAGE_QUEUE_GET_NUMBER_PENDING - Get number of messages pending on a queue
 ----------------------------------------------------------------------------
@ -718,10 +726,11 @@ NOTES:
   \clearpage
 .. _rtems_message_queue_flush:
 .. index:: flush messages on a queue
 .. index:: rtems_message_queue_flush
 .. _rtems_message_queue_flush:
 MESSAGE_QUEUE_FLUSH - Flush all messages on a queue
 ---------------------------------------------------
--- a/c-user/multiprocessing.rst
+++ b/c-user/multiprocessing.rst
@ -481,10 +481,11 @@ usage, and status codes.
   \clearpage
 .. _rtems_multiprocessing_announce:
 .. index:: announce arrival of package
 .. index:: rtems_multiprocessing_announce
 .. _rtems_multiprocessing_announce:
 MULTIPROCESSING_ANNOUNCE - Announce the arrival of a packet
 -----------------------------------------------------------
--- a/c-user/object_services.rst
+++ b/c-user/object_services.rst
@ -180,10 +180,11 @@ Directives
   \clearpage
 .. _rtems_build_name:
 .. index:: build object name
 .. index:: rtems_build_name
 .. _rtems_build_name:
 BUILD_NAME - Build object name from characters
 ----------------------------------------------
@ -212,11 +213,12 @@ NOTES:
   \clearpage
 .. _rtems_object_get_classic_name:
 .. index:: get name from id
 .. index:: obtain name from id
 .. index:: rtems_object_get_classic_name
 .. _rtems_object_get_classic_name:
 OBJECT_GET_CLASSIC_NAME - Lookup name from id
 ---------------------------------------------
@ -250,11 +252,12 @@ NOTES:
   \clearpage
 .. _rtems_object_get_name:
 .. index:: get object name as string
 .. index:: obtain object name as string
 .. index:: rtems_object_get_name
 .. _rtems_object_get_name:
 OBJECT_GET_NAME - Obtain object name as string
 ----------------------------------------------
@ -283,10 +286,11 @@ NOTES:
   \clearpage
 .. _rtems_object_set_name:
 .. index:: set object name
 .. index:: rtems_object_set_name
 .. _rtems_object_set_name:
 OBJECT_SET_NAME - Set object name
 ---------------------------------
@ -330,10 +334,11 @@ NOTES:
   \clearpage
 .. _rtems_object_id_get_api:
 .. index:: obtain API from id
 .. index:: rtems_object_id_get_api
 .. _rtems_object_id_get_api:
 OBJECT_ID_GET_API - Obtain API from Id
 --------------------------------------
@ -359,10 +364,11 @@ NOTES:
   \clearpage
 .. _rtems_object_id_get_class:
 .. index:: obtain class from object id
 .. index:: rtems_object_id_get_class
 .. _rtems_object_id_get_class:
 OBJECT_ID_GET_CLASS - Obtain Class from Id
 ------------------------------------------
@ -388,10 +394,11 @@ NOTES:
   \clearpage
 .. _rtems_object_id_get_node:
 .. index:: obtain node from object id
 .. index:: rtems_object_id_get_node
 .. _rtems_object_id_get_node:
 OBJECT_ID_GET_NODE - Obtain Node from Id
 ----------------------------------------
@ -417,10 +424,11 @@ NOTES:
   \clearpage
 .. _rtems_object_id_get_index:
 .. index:: obtain index from object id
 .. index:: rtems_object_id_get_index
 .. _rtems_object_id_get_index:
 OBJECT_ID_GET_INDEX - Obtain Index from Id
 ------------------------------------------
@ -446,10 +454,11 @@ NOTES:
   \clearpage
 .. _rtems_build_id:
 .. index:: build object id from components
 .. index:: rtems_build_id
 .. _rtems_build_id:
 BUILD_ID - Build Object Id From Components
 ------------------------------------------
@ -480,10 +489,11 @@ NOTES:
   \clearpage
 .. _rtems_object_id_api_minimum:
 .. index:: obtain minimum API value
 .. index:: rtems_object_id_api_minimum
 .. _rtems_object_id_api_minimum:
 OBJECT_ID_API_MINIMUM - Obtain Minimum API Value
 ------------------------------------------------
@ -505,10 +515,11 @@ NOTES:
   \clearpage
 .. _rtems_object_id_api_maximum:
 .. index:: obtain maximum API value
 .. index:: rtems_object_id_api_maximum
 .. _rtems_object_id_api_maximum:
 OBJECT_ID_API_MAXIMUM - Obtain Maximum API Value
 ------------------------------------------------
@ -530,10 +541,11 @@ NOTES:
   \clearpage
 .. _rtems_object_api_minimum_class:
 .. index:: obtain minimum class value
 .. index:: rtems_object_api_minimum_class
 .. _rtems_object_api_minimum_class:
 OBJECT_API_MINIMUM_CLASS - Obtain Minimum Class Value
 -----------------------------------------------------
@ -561,10 +573,11 @@ NOTES:
   \clearpage
 .. _rtems_object_api_maximum_class:
 .. index:: obtain maximum class value
 .. index:: rtems_object_api_maximum_class
 .. _rtems_object_api_maximum_class:
 OBJECT_API_MAXIMUM_CLASS - Obtain Maximum Class Value
 -----------------------------------------------------
@ -592,10 +605,11 @@ NOTES:
   \clearpage
 .. _rtems_object_id_api_minimum_class:
 .. index:: obtain minimum class value for an API
 .. index:: rtems_object_id_api_minimum_class
 .. _rtems_object_id_api_minimum_class:
 OBJECT_ID_API_MINIMUM_CLASS - Obtain Minimum Class Value for an API
 -------------------------------------------------------------------
@ -623,10 +637,11 @@ NOTES:
   \clearpage
 .. _rtems_object_id_api_maximum_class:
 .. index:: obtain maximum class value for an API
 .. index:: rtems_object_id_api_maximum_class
 .. _rtems_object_id_api_maximum_class:
 OBJECT_ID_API_MAXIMUM_CLASS - Obtain Maximum Class Value for an API
 -------------------------------------------------------------------
@ -654,10 +669,11 @@ NOTES:
   \clearpage
 .. _rtems_object_get_api_name:
 .. index:: obtain API name
 .. index:: rtems_object_get_api_name
 .. _rtems_object_get_api_name:
 OBJECT_GET_API_NAME - Obtain API Name
 -------------------------------------
@ -686,10 +702,11 @@ NOTES:
   \clearpage
 .. _rtems_object_get_api_class_name:
 .. index:: obtain class name
 .. index:: rtems_object_get_api_class_name
 .. _rtems_object_get_api_class_name:
 OBJECT_GET_API_CLASS_NAME - Obtain Class Name
 ---------------------------------------------
@ -722,10 +739,11 @@ NOTES:
   \clearpage
 .. _rtems_object_get_class_information:
 .. index:: obtain class information
 .. index:: rtems_object_get_class_information
 .. _rtems_object_get_class_information:
 OBJECT_GET_CLASS_INFORMATION - Obtain Class Information
 -------------------------------------------------------
--- a/c-user/partition_manager.rst
+++ b/c-user/partition_manager.rst
@ -135,10 +135,11 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_partition_create:
 .. index:: create a partition
 .. index:: rtems_partition_create
 .. _rtems_partition_create:
 PARTITION_CREATE - Create a partition
 -------------------------------------
@ -229,11 +230,12 @@ NOTES:
   \clearpage
 .. _rtems_partition_ident:
 .. index:: get ID of a partition
 .. index:: obtain ID of a partition
 .. index:: rtems_partition_ident
 .. _rtems_partition_ident:
 PARTITION_IDENT - Get ID of a partition
 ---------------------------------------
@ -283,10 +285,11 @@ NOTES:
   \clearpage
 .. _rtems_partition_delete:
 .. index:: delete a partition
 .. index:: rtems_partition_delete
 .. _rtems_partition_delete:
 PARTITION_DELETE - Delete a partition
 -------------------------------------
@ -332,11 +335,12 @@ NOTES:
   \clearpage
 .. _rtems_partition_get_buffer:
 .. index:: get buffer from partition
 .. index:: obtain buffer from partition
 .. index:: rtems_partition_get_buffer
 .. _rtems_partition_get_buffer:
 PARTITION_GET_BUFFER - Get buffer from a partition
 --------------------------------------------------
@ -380,10 +384,11 @@ NOTES:
   \clearpage
 .. _rtems_partition_return_buffer:
 .. index:: return buffer to partitition
 .. index:: rtems_partition_return_buffer
 .. _rtems_partition_return_buffer:
 PARTITION_RETURN_BUFFER - Return buffer to a partition
 ------------------------------------------------------
--- a/c-user/rate_monotonic_manager.rst
+++ b/c-user/rate_monotonic_manager.rst
@ -634,10 +634,11 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_rate_monotonic_create:
 .. index:: create a period
 .. index:: rtems_rate_monotonic_create
 .. _rtems_rate_monotonic_create:
 RATE_MONOTONIC_CREATE - Create a rate monotonic period
 ------------------------------------------------------
@ -674,11 +675,12 @@ NOTES:
   \clearpage
 .. _rtems_rate_monotonic_ident:
 .. index:: get ID of a period
 .. index:: obtain ID of a period
 .. index:: rtems_rate_monotonic_ident
 .. _rtems_rate_monotonic_ident:
 RATE_MONOTONIC_IDENT - Get ID of a period
 -----------------------------------------
@ -713,10 +715,11 @@ NOTES:
   \clearpage
 .. _rtems_rate_monotonic_cancel:
 .. index:: cancel a period
 .. index:: rtems_rate_monotonic_cancel
 .. _rtems_rate_monotonic_cancel:
 RATE_MONOTONIC_CANCEL - Cancel a period
 ---------------------------------------
@ -754,10 +757,11 @@ NOTES:
   \clearpage
 .. _rtems_rate_monotonic_delete:
 .. index:: rtems_rate_monotonic_delete
 .. index:: delete a period
 .. _rtems_rate_monotonic_delete:
 RATE_MONOTONIC_DELETE - Delete a rate monotonic period
 ------------------------------------------------------
@ -793,12 +797,13 @@ NOTES:
   \clearpage
 .. _rtems_rate_monotonic_period:
 .. index:: conclude current period
 .. index:: start current period
 .. index:: period initiation
 .. index:: rtems_rate_monotonic_period
 .. _rtems_rate_monotonic_period:
 RATE_MONOTONIC_PERIOD - Conclude current/Start next period
 ----------------------------------------------------------
@ -847,11 +852,12 @@ NOTES:
   \clearpage
 .. _rtems_rate_monotonic_get_status:
 .. index:: get status of period
 .. index:: obtain status of period
 .. index:: rtems_rate_monotonic_get_status
 .. _rtems_rate_monotonic_get_status:
 RATE_MONOTONIC_GET_STATUS - Obtain status from a period
 -------------------------------------------------------
@ -898,12 +904,13 @@ DIRECTIVE STATUS CODES:
    time values will be set to 0.  Otherwise, both time values will contain
    time information since the last invocation of the
    ``rtems_rate_monotonic_period`` directive.  More specifically, the
-    since_last_period value contains the elapsed time which has occurred
+    since_last_period value contains the elapsed time which has occurred since
-    since the last invocation of the ``rtems_rate_monotonic_period`` directive
+    the last invocation of the ``rtems_rate_monotonic_period`` directive and
-    and the ``executed_since_last_period`` contains how much processor
+    the ``executed_since_last_period`` contains how much processor time the
-    time the owning task has consumed since the invocation of the
+    owning task has consumed since the invocation of the
    ``rtems_rate_monotonic_period`` directive. In addition, the
-    postponed_jobs_count value contains the count of jobs which are not released yet.
+    ``postponed_jobs_count value`` contains the count of jobs which are not
    released yet.
 NOTES:
    This directive will not cause the running task to be preempted.
@ -912,11 +919,12 @@ NOTES:
   \clearpage
 .. _rtems_rate_monotonic_get_statistics:
 .. index:: get statistics of period
 .. index:: obtain statistics of period
 .. index:: rtems_rate_monotonic_get_statistics
 .. _rtems_rate_monotonic_get_statistics:
 RATE_MONOTONIC_GET_STATISTICS - Obtain statistics from a period
 ---------------------------------------------------------------
@ -981,10 +989,11 @@ NOTES:
   \clearpage
 .. _rtems_rate_monotonic_reset_statistics:
 .. index:: reset statistics of period
 .. index:: rtems_rate_monotonic_reset_statistics
 .. _rtems_rate_monotonic_reset_statistics:
 RATE_MONOTONIC_RESET_STATISTICS - Reset statistics for a period
 ---------------------------------------------------------------
@ -1015,10 +1024,11 @@ NOTES:
   \clearpage
 .. _rtems_rate_monotonic_reset_all_statistics:
 .. index:: reset statistics of all periods
 .. index:: rtems_rate_monotonic_reset_all_statistics
 .. _rtems_rate_monotonic_reset_all_statistics:
 RATE_MONOTONIC_RESET_ALL_STATISTICS - Reset statistics for all periods
 ----------------------------------------------------------------------
@ -1041,11 +1051,12 @@ NOTES:
   \clearpage
 .. _rtems_rate_monotonic_report_statistics:
 .. index:: print period statistics report
 .. index:: period statistics report
 .. index:: rtems_rate_monotonic_report_statistics
 .. _rtems_rate_monotonic_report_statistics:
 RATE_MONOTONIC_REPORT_STATISTICS - Print period statistics report
 -----------------------------------------------------------------
--- a/c-user/region_manager.rst
+++ b/c-user/region_manager.rst
@ -224,9 +224,10 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_region_create:
 .. index:: create a region
 .. _rtems_region_create:
 REGION_CREATE - Create a region
 -------------------------------
@ -300,11 +301,12 @@ NOTES:
   \clearpage
 .. _rtems_region_ident:
 .. index:: get ID of a region
 .. index:: obtain ID of a region
 .. index:: rtems_region_ident
 .. _rtems_region_ident:
 REGION_IDENT - Get ID of a region
 ---------------------------------
@ -342,10 +344,11 @@ NOTES:
   \clearpage
 .. _rtems_region_delete:
 .. index:: delete a region
 .. index:: rtems_region_delete
 .. _rtems_region_delete:
 REGION_DELETE - Delete a region
 -------------------------------
@ -383,11 +386,12 @@ NOTES:
   \clearpage
 .. _rtems_region_extend:
 .. index:: add memory to a region
 .. index:: region, add memory
 .. index:: rtems_region_extend
 .. _rtems_region_extend:
 REGION_EXTEND - Add memory to a region
 --------------------------------------
@ -436,10 +440,11 @@ NOTES:
   \clearpage
 .. _rtems_region_get_segment:
 .. index:: get segment from region
 .. index:: rtems_region_get_segment
 .. _rtems_region_get_segment:
 REGION_GET_SEGMENT - Get segment from a region
 ----------------------------------------------
@ -522,10 +527,11 @@ NOTES:
   \clearpage
 .. _rtems_region_return_segment:
 .. index:: return segment to region
 .. index:: rtems_region_return_segment
 .. _rtems_region_return_segment:
 REGION_RETURN_SEGMENT - Return segment to a region
 --------------------------------------------------
@ -571,10 +577,11 @@ NOTES:
   \clearpage
 .. _rtems_region_get_segment_size:
 .. index:: get size of segment
 .. index:: rtems_region_get_segment_size
 .. _rtems_region_get_segment_size:
 REGION_GET_SEGMENT_SIZE - Obtain size of a segment
 --------------------------------------------------
@ -613,10 +620,11 @@ NOTES:
   \clearpage
 .. _rtems_region_resize_segment:
 .. index:: resize segment
 .. index:: rtems_region_resize_segment
 .. _rtems_region_resize_segment:
 REGION_RESIZE_SEGMENT - Change size of a segment
 ------------------------------------------------
--- a/c-user/semaphore_manager.rst
+++ b/c-user/semaphore_manager.rst
@ -324,10 +324,11 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_semaphore_create:
 .. index:: create a semaphore
 .. index:: rtems_semaphore_create
 .. _rtems_semaphore_create:
 SEMAPHORE_CREATE - Create a semaphore
 -------------------------------------
@ -436,11 +437,12 @@ NOTES:
   \clearpage
 .. _rtems_semaphore_ident:
 .. index:: get ID of a semaphore
 .. index:: obtain ID of a semaphore
 .. index:: rtems_semaphore_ident
 .. _rtems_semaphore_ident:
 SEMAPHORE_IDENT - Get ID of a semaphore
 ---------------------------------------
@ -488,10 +490,11 @@ NOTES:
   \clearpage
 .. _rtems_semaphore_delete:
 .. index:: delete a semaphore
 .. index:: rtems_semaphore_delete
 .. _rtems_semaphore_delete:
 SEMAPHORE_DELETE - Delete a semaphore
 -------------------------------------
@ -544,11 +547,12 @@ NOTES:
   \clearpage
 .. _rtems_semaphore_obtain:
 .. index:: obtain a semaphore
 .. index:: lock a semaphore
 .. index:: rtems_semaphore_obtain
 .. _rtems_semaphore_obtain:
 SEMAPHORE_OBTAIN - Acquire a semaphore
 --------------------------------------
@ -643,11 +647,12 @@ NOTES:
   \clearpage
 .. _rtems_semaphore_release:
 .. index:: release a semaphore
 .. index:: unlock a semaphore
 .. index:: rtems_semaphore_release
 .. _rtems_semaphore_release:
 SEMAPHORE_RELEASE - Release a semaphore
 ---------------------------------------
@ -704,11 +709,12 @@ NOTES:
   \clearpage
 .. _rtems_semaphore_flush:
 .. index:: flush a semaphore
 .. index:: unblock all tasks waiting on a semaphore
 .. index:: rtems_semaphore_flush
 .. _rtems_semaphore_flush:
 SEMAPHORE_FLUSH - Unblock all tasks waiting on a semaphore
 ----------------------------------------------------------
@ -760,10 +766,11 @@ NOTES:
   \clearpage
 .. _rtems_semaphore_set_priority:
 .. index:: set priority by scheduler for a semaphore
 .. index:: rtems_semaphore_set_priority
 .. _rtems_semaphore_set_priority:
 SEMAPHORE_SET_PRIORITY - Set priority by scheduler for a semaphore
 ------------------------------------------------------------------
--- a/c-user/signal_manager.rst
+++ b/c-user/signal_manager.rst
@ -211,11 +211,12 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_signal_catch:
 .. index:: establish an ASR
 .. index:: install an ASR
 .. index:: rtems_signal_catch
 .. _rtems_signal_catch:
 SIGNAL_CATCH - Establish an ASR
 -------------------------------
@ -272,10 +273,11 @@ NOTES:
   \clearpage
 .. _rtems_signal_send:
 .. index:: send signal set
 .. index:: rtems_signal_send
 .. _rtems_signal_send:
 SIGNAL_SEND - Send signal set to a task
 ---------------------------------------
--- a/c-user/symmetric_multiprocessing_services.rst
+++ b/c-user/symmetric_multiprocessing_services.rst
@ -327,9 +327,9 @@ thread.  During a context switch from the executing thread to the heir thread,
 the value of each task variable is saved to the thread control block of the
 executing thread and restored from the thread control block of the heir thread.
 This is inherently broken if more than one executing thread exists.
-Alternatives to task variables are POSIX keys and :ref:`TLS <TLS>`.  All use
+Alternatives to task variables are POSIX keys and :term:`TLS`.  All use cases
-cases of task variables in the RTEMS code base were replaced with alternatives.
+of task variables in the RTEMS code base were replaced with alternatives.  The
-The task variable API has been removed in RTEMS 5.1.
+task variable API has been removed in RTEMS 5.1.
 Highest Priority Thread Never Walks Alone
 -----------------------------------------
--- a/c-user/task_manager.rst
+++ b/c-user/task_manager.rst
@ -598,10 +598,11 @@ related constants, usage, and status codes.
   \clearpage
 .. _rtems_task_create:
 .. index:: create a task
 .. index:: rtems_task_create
 .. _rtems_task_create:
 TASK_CREATE - Create a task
 ---------------------------
@ -743,10 +744,11 @@ NOTES:
   \clearpage
 .. _rtems_task_ident:
 .. index:: get ID of a task
 .. index:: rtems_task_ident
 .. _rtems_task_ident:
 TASK_IDENT - Get ID of a task
 -----------------------------
@ -797,10 +799,11 @@ NOTES:
   \clearpage
 .. _rtems_task_self:
 .. index:: obtain ID of caller
 .. index:: rtems_task_self
 .. _rtems_task_self:
 TASK_SELF - Obtain ID of caller
 -------------------------------
@ -823,10 +826,11 @@ NOTES:
   \clearpage
 .. _rtems_task_start:
 .. index:: starting a task
 .. index:: rtems_task_start
 .. _rtems_task_start:
 TASK_START - Start a task
 -------------------------
@ -877,10 +881,11 @@ NOTES:
   \clearpage
 .. _rtems_task_restart:
 .. index:: restarting a task
 .. index:: rtems_task_restart
 .. _rtems_task_restart:
 TASK_RESTART - Restart a task
 -----------------------------
@ -939,10 +944,11 @@ NOTES:
   \clearpage
 .. _rtems_task_delete:
 .. index:: deleting a task
 .. index:: rtems_task_delete
 .. _rtems_task_delete:
 TASK_DELETE - Delete a task
 ---------------------------
@ -995,10 +1001,11 @@ NOTES:
   \clearpage
 .. _rtems_task_suspend:
 .. index:: suspending a task
 .. index:: rtems_task_suspend
 .. _rtems_task_suspend:
 TASK_SUSPEND - Suspend a task
 -----------------------------
@ -1042,10 +1049,11 @@ NOTES:
   \clearpage
 .. _rtems_task_resume:
 .. index:: resuming a task
 .. index:: rtems_task_resume
 .. _rtems_task_resume:
 TASK_RESUME - Resume a task
 ---------------------------
@ -1087,10 +1095,11 @@ NOTES:
   \clearpage
 .. _rtems_task_is_suspended:
 .. index:: is task suspended
 .. index:: rtems_task_is_suspended
 .. _rtems_task_is_suspended:
 TASK_IS_SUSPENDED - Determine if a task is Suspended
 ----------------------------------------------------
@ -1125,13 +1134,14 @@ NOTES:
   \clearpage
 .. _rtems_task_set_priority:
 .. index:: rtems_task_set_priority
 .. index:: current task priority
 .. index:: set task priority
 .. index:: get task priority
 .. index:: obtain task priority
 .. _rtems_task_set_priority:
 TASK_SET_PRIORITY - Set task priority
 -------------------------------------
@ -1189,12 +1199,13 @@ NOTES:
   \clearpage
 .. _rtems_task_get_priority:
 .. index:: rtems_task_get_priority
 .. index:: current task priority
 .. index:: get task priority
 .. index:: obtain task priority
 .. _rtems_task_get_priority:
 TASK_GET_PRIORITY - Get task priority
 -------------------------------------
@ -1238,7 +1249,6 @@ NOTES:
   \clearpage
 .. _rtems_task_mode:
 .. index:: current task mode
 .. index:: set task mode
 .. index:: get task mode
@ -1247,6 +1257,8 @@ NOTES:
 .. index:: obtain task mode
 .. index:: rtems_task_mode
 .. _rtems_task_mode:
 TASK_MODE - Change the current task mode
 ----------------------------------------
@ -1317,11 +1329,12 @@ NOTES:
   \clearpage
 .. _rtems_task_wake_after:
 .. index:: delay a task for an interval
 .. index:: wake up after an interval
 .. index:: rtems_task_wake_after
 .. _rtems_task_wake_after:
 TASK_WAKE_AFTER - Wake up after interval
 ----------------------------------------
@ -1360,11 +1373,12 @@ NOTES:
   \clearpage
 .. _rtems_task_wake_when:
 .. index:: delay a task until a wall time
 .. index:: wake up at a wall time
 .. index:: rtems_task_wake_when
 .. _rtems_task_wake_when:
 TASK_WAKE_WHEN - Wake up when specified
 ---------------------------------------
@ -1616,10 +1630,11 @@ NOTES:
   \clearpage
 .. _rtems_task_iterate:
 .. index:: iterate over all threads
 .. index:: rtems_task_iterate
 .. _rtems_task_iterate:
 TASK_ITERATE - Iterate Over Tasks
 ---------------------------------
@ -1658,9 +1673,10 @@ Deprecated and Removed Directives
   \clearpage
 .. _rtems_iterate_over_all_threads:
 .. index:: rtems_iterate_over_all_threads
 .. _rtems_iterate_over_all_threads:
 ITERATE_OVER_ALL_THREADS - Iterate Over Tasks
 ---------------------------------------------
@ -1697,10 +1713,11 @@ NOTES:
   \clearpage
 .. _rtems_task_get_note:
 .. index:: get task notepad entry
 .. index:: rtems_task_get_note
 .. _rtems_task_get_note:
 TASK_GET_NOTE - Get task notepad entry
 --------------------------------------
@ -1750,10 +1767,11 @@ NOTES:
   \clearpage
 .. _rtems_task_set_note:
 .. index:: set task notepad entry
 .. index:: rtems_task_set_note
 .. _rtems_task_set_note:
 TASK_SET_NOTE - Set task notepad entry
 --------------------------------------
@ -1802,12 +1820,13 @@ NOTES:
   \clearpage
 .. _rtems_task_variable_add:
 .. index:: per-task variable
 .. index:: task private variable
 .. index:: task private data
 .. index:: rtems_task_variable_add
 .. _rtems_task_variable_add:
 TASK_VARIABLE_ADD - Associate per task variable
 -----------------------------------------------
@ -1865,11 +1884,12 @@ NOTES:
   \clearpage
 .. _rtems_task_variable_get:
 .. index:: get per-task variable
 .. index:: obtain per-task variable
 .. index:: rtems_task_variable_get
 .. _rtems_task_variable_get:
 TASK_VARIABLE_GET - Obtain value of a per task variable
 -------------------------------------------------------
@ -1922,12 +1942,13 @@ NOTES:
   \clearpage
 .. _rtems_task_variable_delete:
 .. index:: per-task variable
 .. index:: task private variable
 .. index:: task private data
 .. index:: rtems_task_variable_delete
 .. _rtems_task_variable_delete:
 TASK_VARIABLE_DELETE - Remove per task variable
 -----------------------------------------------
--- a/c-user/timer_manager.rst
+++ b/c-user/timer_manager.rst
@ -194,10 +194,11 @@ related constants, usage, and status codes.
 .. raw:: latex
   \clearpage
 .. _rtems_timer_create:
 .. index:: create a timer
 .. index:: rtems_timer_create
 .. _rtems_timer_create:
 TIMER_CREATE - Create a timer
 -----------------------------
@ -240,10 +241,11 @@ NOTES:
   \clearpage
 .. _rtems_timer_ident:
 .. index:: obtain the ID of a timer
 .. index:: rtems_timer_ident
 .. _rtems_timer_ident:
 TIMER_IDENT - Get ID of a timer
 -------------------------------
@ -280,10 +282,11 @@ NOTES:
   \clearpage
 .. _rtems_timer_cancel:
 .. index:: cancel a timer
 .. index:: rtems_timer_cancel
 .. _rtems_timer_cancel:
 TIMER_CANCEL - Cancel a timer
 -----------------------------
@ -315,10 +318,11 @@ NOTES:
   \clearpage
 .. _rtems_timer_delete:
 .. index:: delete a timer
 .. index:: rtems_timer_delete
 .. _rtems_timer_delete:
 TIMER_DELETE - Delete a timer
 -----------------------------
@ -354,10 +358,11 @@ NOTES:
   \clearpage
 .. _rtems_timer_fire_after:
 .. index:: fire a timer after an interval
 .. index:: rtems_timer_fire_after
 .. _rtems_timer_fire_after:
 TIMER_FIRE_AFTER - Fire timer after interval
 --------------------------------------------
@ -398,10 +403,11 @@ NOTES:
   \clearpage
 .. _rtems_timer_fire_when:
 .. index:: fire a timer at wall time
 .. index:: rtems_timer_fire_when
 .. _rtems_timer_fire_when:
 TIMER_FIRE_WHEN - Fire timer when specified
 -------------------------------------------
@ -446,10 +452,11 @@ NOTES:
   \clearpage
 .. _rtems_timer_initiate_server:
 .. index:: initiate the Timer Server
 .. index:: rtems_timer_initiate_server
 .. _rtems_timer_initiate_server:
 TIMER_INITIATE_SERVER - Initiate server for task-based timers
 -------------------------------------------------------------
@ -491,10 +498,11 @@ NOTES:
   \clearpage
 .. _rtems_timer_server_fire_after:
 .. index:: fire task-based a timer after an interval
 .. index:: rtems_timer_server_fire_after
 .. _rtems_timer_server_fire_after:
 TIMER_SERVER_FIRE_AFTER - Fire task-based timer after interval
 --------------------------------------------------------------
@ -539,10 +547,11 @@ NOTES:
   \clearpage
 .. _rtems_timer_server_fire_when:
 .. index:: fire a task-based timer at wall time
 .. index:: rtems_timer_server_fire_when
 .. _rtems_timer_server_fire_when:
 TIMER_SERVER_FIRE_WHEN - Fire task-based timer when specified
 -------------------------------------------------------------
@ -591,10 +600,11 @@ NOTES:
   \clearpage
 .. _rtems_timer_reset:
 .. index:: reset a timer
 .. index:: rtems_timer_reset
 .. _rtems_timer_reset:
 TIMER_RESET - Reset an interval timer
 -------------------------------------
--- a/c-user/timespec_helpers.rst
+++ b/c-user/timespec_helpers.rst
@ -125,10 +125,11 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_timespec_set:
 .. index:: set struct timespec instance
 .. index:: rtems_timespec_set
 .. _rtems_timespec_set:
 TIMESPEC_SET - Set struct timespec Instance
 -------------------------------------------
@ -156,9 +157,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_zero:
 .. index:: rtems_timespec_zero
 .. _rtems_timespec_zero:
 TIMESPEC_ZERO - Zero struct timespec Instance
 ---------------------------------------------
@ -183,9 +185,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_is_valid:
 .. index:: rtems_timespec_is_valid
 .. _rtems_timespec_is_valid:
 TIMESPEC_IS_VALID - Check validity of a struct timespec instance
 ----------------------------------------------------------------
@ -212,9 +215,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_add_to:
 .. index:: rtems_timespec_add_to
 .. _rtems_timespec_add_to:
 TIMESPEC_ADD_TO - Add Two struct timespec Instances
 ---------------------------------------------------
@ -241,9 +245,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_subtract:
 .. index:: rtems_timespec_subtract
 .. _rtems_timespec_subtract:
 TIMESPEC_SUBTRACT - Subtract Two struct timespec Instances
 ----------------------------------------------------------
@ -275,9 +280,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_divide:
 .. index:: rtems_timespec_divide
 .. _rtems_timespec_divide:
 TIMESPEC_DIVIDE - Divide Two struct timespec Instances
 ------------------------------------------------------
@ -315,9 +321,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_divide_by_integer:
 .. index:: rtems_timespec_divide_by_integer
 .. _rtems_timespec_divide_by_integer:
 TIMESPEC_DIVIDE_BY_INTEGER - Divide a struct timespec Instance by an Integer
 ----------------------------------------------------------------------------
@ -346,9 +353,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_less_than:
 .. index:: rtems_timespec_less_than
 .. _rtems_timespec_less_than:
 TIMESPEC_LESS_THAN - Less than operator
 ---------------------------------------
@ -376,9 +384,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_greater_than:
 .. index:: rtems_timespec_greater_than
 .. _rtems_timespec_greater_than:
 TIMESPEC_GREATER_THAN - Greater than operator
 ---------------------------------------------
@ -404,9 +413,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_equal_to:
 .. index:: rtems_timespec_equal_to
 .. _rtems_timespec_equal_to:
 TIMESPEC_EQUAL_TO - Check equality of timespecs
 -----------------------------------------------
@ -432,9 +442,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_get_seconds:
 .. index:: rtems_timespec_get_seconds
 .. _rtems_timespec_get_seconds:
 TIMESPEC_GET_SECONDS - Get Seconds Portion of struct timespec Instance
 ----------------------------------------------------------------------
@ -460,9 +471,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_get_nanoseconds:
 .. index:: rtems_timespec_get_nanoseconds
 .. _rtems_timespec_get_nanoseconds:
 TIMESPEC_GET_NANOSECONDS - Get Nanoseconds Portion of the struct timespec Instance
 ----------------------------------------------------------------------------------
@ -488,9 +500,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_to_ticks:
 .. index:: rtems_timespec_to_ticks
 .. _rtems_timespec_to_ticks:
 TIMESPEC_TO_TICKS - Convert struct timespec Instance to Ticks
 -------------------------------------------------------------
@ -515,9 +528,10 @@ NOTES:
   \clearpage
 .. _rtems_timespec_from_ticks:
 .. index:: rtems_timespec_from_ticks
 .. _rtems_timespec_from_ticks:
 TIMESPEC_FROM_TICKS - Convert Ticks to struct timespec Representation
 ---------------------------------------------------------------------
--- a/c-user/user_extensions.rst
+++ b/c-user/user_extensions.rst
@ -4,9 +4,10 @@
 .. COMMENT: On-Line Applications Research Corporation (OAR).
 .. COMMENT: All rights reserved.
 .. _User Extensions Manager:
 .. index:: user extensions
 .. _User Extensions Manager:
 User Extensions Manager
 ***********************
@ -424,10 +425,11 @@ sequence, related constants, usage, and status codes.
   \clearpage
 .. _rtems_extension_create:
 .. index:: create an extension set
 .. index:: rtems_extension_create
 .. _rtems_extension_create:
 EXTENSION_CREATE - Create a extension set
 -----------------------------------------
@ -472,11 +474,12 @@ NOTES:
   \clearpage
 .. _rtems_extension_ident:
 .. index:: get ID of an extension set
 .. index:: obtain ID of an extension set
 .. index:: rtems_extension_ident
 .. _rtems_extension_ident:
 EXTENSION_IDENT - Get ID of a extension set
 -------------------------------------------
@ -513,10 +516,11 @@ NOTES:
   \clearpage
 .. _rtems_extension_delete:
 .. index:: delete an extension set
 .. index:: rtems_extension_delete
 .. _rtems_extension_delete:
 EXTENSION_DELETE - Delete a extension set
 -----------------------------------------
--- a/user/additional/index.rst
+++ b/user/additional/index.rst
@ -1,34 +0,0 @@
 .. comment SPDX-License-Identifier: CC-BY-SA-4.0
 Additional Information
 **********************
 Information and details that do not belong in other sections go here.
 Important Terms
 ===============
 Waf
 ---
 Waf build system.  For more information see http://www.waf.io/
 Test Suite
 ----------
 RTEMS test suite located in the ``testsuites/`` directory.
 Command List
 ============
 List of all available commands in RTEMS
 Program List
 ============
 List of all available programs in RTEMS
--- a/user/installation/prefixes-sandboxing.rst
+++ b/user/installation/prefixes-sandboxing.rst
@ -3,8 +3,8 @@
 .. comment: Copyright (c) 2016 Chris Johns <chrisj@rtems.org>
 .. comment: All rights reserved.
 .. _prefixes:
 .. index:: Prefixes
 .. _prefixes:
 Prefixes
 ========
--- a/user/start/index.rst
+++ b/user/start/index.rst
@ -3,6 +3,8 @@
 .. comment: Copyright (c) 2016 Chris Johns <chrisj@rtems.org>
 .. comment: All rights reserved.
 .. index:: Quick Start
 Quick Start
 ***********
@ -18,9 +20,9 @@ to complete successfully. :ref:`host-computer` details what is needed for the
 supported host operating systems. If Windows is being used it is recommended
 following the procedure in :ref:`microsoft-windows` first.
-Their are many ways and locations a suitable environment can be set up. A
+There are many ways and locations a suitable environment can be set up. A
 common factor that defines the final location of tools and projects is the
-place you have suitable storage. :ref:`prefixes` and :ref:`project-sandboxing`
+place you have suitable storage. :ref:`Prefixes` and :ref:`project-sandboxing`
 provide detailed examples of possible locations and set ups .
 This procedure installs a developer set up using the RTEMS Git repositories on
--- a/user/tools/index.rst
+++ b/user/tools/index.rst
@ -19,6 +19,5 @@ developers.
   linker
   symbols
   exeinfo
   trace-linker
   bsp-builder
   tester
--- a/user/tools/simulation.rst
+++ b/user/tools/simulation.rst
@ -1,13 +0,0 @@
 .. comment SPDX-License-Identifier: CC-BY-SA-4.0
 Simulation
 ==========
 .. index:: Simulation Tools, rtems-run
 XXX: simulation
 rtems-run
 ---------
 XXX: rtems-run
--- a/user/tools/tester.rst
+++ b/user/tools/tester.rst
@ -3,34 +3,34 @@
 .. comment: Copyright (c) 2017 Chris Johns <chrisj@rtems.org>
 .. comment: All rights reserved.
-RTEMS Tester
+.. _rtems-tester-command:
 ============
-.. index:: Tools, rtems-tester
+RTEMS Tester and Run Commands
 =============================
-The RTEMS Tester is a test framework. It includes a command line interface to
+.. index:: Tools, rtems-test, rtems-run
-run tests on supported targets. The framework provides back-end support for
+
-common simulators and debuggers. The board support package (BSP) configurations
+The RTEMS Tester is a test tool that provides a command line interface to run
-for RTEMS are provided and can be used to run all the tests provided with
+test executable on supported targets. The tool provides back-end support for
-RTEMS. The framework is not specific to RTEMS and can be configured to run any
+common simulators, debuggers and boot loaders. Board support package (BSP)
-suitable application.
+configurations for RTEMS are provided and can be used to run all the tests in
 the RTEMS test suite. The tool and it's framework is not specific to RTEMS and
 can be configured to run any suitable application.
 RTEMS is an embedded operating system and is cross-compiled on a range of host
 machines. The executables run on the target hardware and this can vary widely
 from open source simulators, commercial simulators, debuggers with simulators,
-to debuggers with hardware specific pods and devices. Testing RTEMS requires
+debuggers with hardware specific pods and devices to targe boot
-the cross-compiled test executable is transferred to the target hardware,
+loaders. Testing RTEMS requires the cross-compiled test executable is
-executed and the output returned to the host where it is analyzed to determine
+transferred to the target hardware, executed and the output captured and
-the test result. The RTEMS Tester provides a framework to do this.
+returned to the test host where it is analyzed to determine the test
 result.
-Running all the RTEMS tests on your target is very important. It provides you
+Running the RTEMS tests on your target is very important. It provides you with
-with a traceable record showing that your RTEMS version and its tools are
+a traceable record showing that your RTEMS version and its tools are working at
-working at the level the RTEMS development team expect when releasing
+the level the RTEMS development team expect when releasing RTEMS. Being able to
-RTEMS. Being able to easily run the tests and verify the results is critical in
+easily run the tests and verify the results is critical in maintaining a high
-maintaining a high standard.
+standard.
 This document is for users of the RTEMS Tester as well as those wanting to
 develop, extend and investigate the RTEMS Tester.
 Available BSP testers
 ---------------------
@ -42,9 +42,11 @@ You can list the available BSP testers with:
    $ rtems-test --list-bsps
    arm920
    beagleboardxm
    beagleboneblack
    jmr3904-run
    jmr3904
    mcf5235
    pc
    psim-run
    psim
    realview_pbx_a9_qemu
@ -54,6 +56,7 @@ You can list the available BSP testers with:
    xilinx_zynq_a9_qemu_smp
    xilinx_zynq_zc706
    xilinx_zynq_zc706_qemu
    xilinx_zynq_zedboard
 .. note:: The list is growing all the time and if your BSP is not supported we
          encourage you to add it and submit the configuration back to the
@ -70,7 +73,7 @@ Building RTEMS Tests
 --------------------
 Build the RTEMS Kernel (See :ref:`rtems-kernel`) by cloning the repository,
-running the ``bootstrap`` procecure, building and finally installing the
+running the ``bootstrap`` procedure, building and finally installing the
 kernel. Be sure to enable tests by using ``--enable-tests`` option with
 configure after running ``bootstrap``.
@ -80,15 +83,20 @@ configure after running ``bootstrap``.
                        --enable-tests --enable-rtemsbsp=erc32
    $ make
-Add the -j option to the make command with the number of cores to run the
+Add the `-j` option to the make command with the number of cores to run a
-build parallel where it can.
+parallel build.
 Building all the tests takes time and it uses more disk so be patient. When
-finished all the tests will be built and ready to run. Before running all the
+finished all the tests will have been built. Some BSPs may require a post-build
-tests it is a good idea to run the ``hello`` test. The ``hello`` test is an
+process to be run on the RTEMS ELF executable to create an image suitable for
-RTEMS version of the classic "Hello World" example and running it shows you
+execution. This can be built into the configuration script and the tester will
-have a working tool chain and build of RTEMS ready to run the tests. Using the
+perform a pre-test command to covert the executable to a suitable format for
-run command:
+your target.
 Before running all the tests it is a good idea to run the ``hello`` test. The
 ``hello`` test is an RTEMS version of the classic "Hello World" example and
 running it shows you have a working tool chain and build of RTEMS ready to run
 the tests. Using the run with the ERC32 BSP the command is:
 .. code-block:: shell
@ -186,8 +194,6 @@ BSP build tree:
    Average test time: 0:00:27.963000
    Testing time     : 0:06:03.519012
 * The RTEMS Tester's test command. In this example we are using an absolute
  path.
 * The ``--log`` option sends the output to a log file. By default only failed