[rtems-docs commit] c-user: Document linker set content

[Sebastian Huber]

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

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Wed Feb 15 15:07:14 2017 +0100

c-user: Document linker set content

Close #2770.

---

 c-user/linker_sets.rst | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/c-user/linker_sets.rst b/c-user/linker_sets.rst
index 83ba403..9405c75 100644
--- a/c-user/linker_sets.rst
+++ b/c-user/linker_sets.rst
@@ -49,6 +49,8 @@ The following macros are provided to create, populate and use linker sets.
 
 - RTEMS_LINKER_ROSET_ITEM_ORDERED_ - Defines an ordered read-only linker set item
 
+- RTEMS_LINKER_ROSET_CONTENT_ - Marks a declaration as a read-only linker set content
+
 - RTEMS_LINKER_RWSET_DECLARE_ - Declares a read-write linker set
 
 - RTEMS_LINKER_RWSET_ - Defines a read-write linker set
@@ -61,6 +63,8 @@ The following macros are provided to create, populate and use linker sets.
 
 - RTEMS_LINKER_RWSET_ITEM_ORDERED_ - Defines an ordered read-write linker set item
 
+- RTEMS_LINKER_RWSET_CONTENT_ - Marks a declaration as a read-write linker set content
+
 Background
 ==========
 
@@ -454,6 +458,28 @@ NOTES:
 
    \clearpage
 
+.. _RTEMS_LINKER_ROSET_CONTENT:
+
+RTEMS_LINKER_ROSET_CONTENT - Marks a declaration as a read-only linker set content
+----------------------------------------------------------------------------------
+.. index:: RTEMS_LINKER_ROSET_CONTENT
+
+CALLING SEQUENCE:
+    .. code-block:: c
+
+        RTEMS_LINKER_ROSET_CONTENT( set, decl );
+
+DESCRIPTION:
+    This macro marks a declaration as a read-only linker set content.  The
+    linker set is identified by ``set``.  The ``set`` parameter itself must be
+    a valid C designator on which no macro expansion is performed.  It uniquely
+    identifies the linker set. The ``decl`` parameter must be an arbitrary
+    variable declaration.
+
+.. raw:: latex
+
+   \clearpage
+
 .. _RTEMS_LINKER_RWSET_DECLARE:
 
 RTEMS_LINKER_RWSET_DECLARE - Declares a read-write linker set
@@ -626,3 +652,25 @@ NOTES:
         /* Example item */
         static const xyz_item some_item = { 123 };
         XYZ_ITEM( some_item, XYZ_ORDER_FIRST );
+
+.. raw:: latex
+
+   \clearpage
+
+.. _RTEMS_LINKER_RWSET_CONTENT:
+
+RTEMS_LINKER_RWSET_CONTENT - Marks a declaration as a read-write linker set content
+-----------------------------------------------------------------------------------
+.. index:: RTEMS_LINKER_RWSET_CONTENT
+
+CALLING SEQUENCE:
+    .. code-block:: c
+
+        RTEMS_LINKER_RWSET_CONTENT( set, decl );
+
+DESCRIPTION:
+    This macro marks a declaration as a read-write linker set content.  The
+    linker set is identified by ``set``.  The ``set`` parameter itself must be
+    a valid C designator on which no macro expansion is performed.  It uniquely
+    identifies the linker set. The ``decl`` parameter must be an arbitrary
+    variable declaration.