[rtems-docs commit] c-user: Clarify message queue configuration

[Sebastian Huber]

Module:    rtems-docs
Branch:    master
Commit:    988e7ca06358f95c2eace3157523ac35cf8a111f
Changeset: http://git.rtems.org/rtems-docs/commit/?id=988e7ca06358f95c2eace3157523ac35cf8a111f

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Fri Mar  6 13:52:17 2020 +0100

c-user: Clarify message queue configuration

Update #3836.

---

 c-user/configuring_a_system.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/c-user/configuring_a_system.rst b/c-user/configuring_a_system.rst
index e45af77..1fb8742 100644
--- a/c-user/configuring_a_system.rst
+++ b/c-user/configuring_a_system.rst
@@ -1184,7 +1184,9 @@ DESCRIPTION:
     Message Queues that can be concurrently active.
 
 NOTES:
-    This object class can be configured in unlimited allocation mode.
+    This object class can be configured in unlimited allocation mode.  You have
+    to account for the memory used to store the messages of each message queue,
+    see :ref:`CONFIGURE_MESSAGE_BUFFER_MEMORY`.
 
 .. index:: CONFIGURE_MAXIMUM_BARRIERS
 
@@ -1664,7 +1666,9 @@ DESCRIPTION:
     API Message Queues that can be concurrently active.
 
 NOTES:
-    This object class can be configured in unlimited allocation mode.
+    This object class can be configured in unlimited allocation mode.  You have
+    to account for the memory used to store the messages of each message queue,
+    see :ref:`CONFIGURE_MESSAGE_BUFFER_MEMORY`.
 
 .. index:: CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS
 
@@ -2038,7 +2042,9 @@ Configuring Memory for Classic API Message Buffers
 ==================================================
 
 This section describes the configuration parameters related to specifying the
-amount of memory reserved for Classic API Message Buffers.
+amount of memory reserved for message queue message buffers.  See
+:ref:`CONFIGURE_MAXIMUM_MESSAGE_QUEUES` and
+:ref:`CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES`.
 
 .. index:: CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE
 .. index:: memory for a single message queue's buffers
@@ -2076,8 +2082,7 @@ DESCRIPTION:
     ``size_per`` is the size in bytes of the user message.
 
 NOTES:
-
-    This macro is only used in support of ``CONFIGURE_MESSAGE_BUFFER_MEMORY``.
+    This macro is only used in support of :ref:`CONFIGURE_MESSAGE_BUFFER_MEMORY`.
 
 .. index:: CONFIGURE_MESSAGE_BUFFER_MEMORY
 .. index:: configure message queue buffer memory
@@ -2105,7 +2110,7 @@ DESCRIPTION:
 
 NOTES:
     The following illustrates how the help macro
-    ``CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE`` can be used to assist in
+    :ref:`CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE` can be used to assist in
     calculating the message buffer memory required.  In this example, there are
     two message queues used in this application.  The first message queue has
     maximum of 24 pending messages with the message structure defined by the