From 76101939c40e7c350d48efe65d8ad29589738635 Mon Sep 17 00:00:00 2001
From: Joel Sherrill <joel.sherrill@OARcorp.com>
Date: Thu, 13 Nov 2008 15:10:36 +0000
Subject: 2008-11-13	Joel Sherrill <joel.sherrill@OARcorp.com>

	PR 1336/cpukit
	* user/chains.t, user/dirstat.texi: Add rtems_chain_prepend_unprotected
	and rtems_chain_append_unprotected.
---
 doc/ChangeLog         |  6 ++++
 doc/user/chains.t     | 78 +++++++++++++++++++++++++++++++++++++++++++++++----
 doc/user/dirstat.texi |  2 +-
 3 files changed, 80 insertions(+), 6 deletions(-)

(limited to 'doc')

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 8b85ec0a3d..2d5944db39 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2008-11-13	Joel Sherrill <joel.sherrill@OARcorp.com>
+
+	PR 1336/cpukit
+	* user/chains.t, user/dirstat.texi: Add rtems_chain_prepend_unprotected
+	and rtems_chain_append_unprotected.
+
 2008-11-07	Joel Sherrill <joel.sherrill@OARcorp.com>
 
 	* user/concepts.t: Use 32 bit version centered.
diff --git a/doc/user/chains.t b/doc/user/chains.t
index baa12234c0..33c1311207 100755
--- a/doc/user/chains.t
+++ b/doc/user/chains.t
@@ -32,11 +32,13 @@ provided by RTEMS is:
 @item @code{@value{DIRPREFIX}chain_has_only_one_node} - Does the node have one node ?
 @item @code{@value{DIRPREFIX}chain_is_head} - Is the node the head ?
 @item @code{@value{DIRPREFIX}chain_is_tail} - Is the node the tail ?
-@item @code{@value{DIRPREFIX}chain_extract} - Extract the node from the chain ?
-@item @code{@value{DIRPREFIX}chain_get} - Return the first node on the chain ?
-@item @code{@value{DIRPREFIX}chain_insert} - Insert the node into the chain ?
-@item @code{@value{DIRPREFIX}chain_append} - Append the node to chain ?
-@item @code{@value{DIRPREFIX}chain_prepend} - Prepend the node to the end of the chain ?
+@item @code{@value{DIRPREFIX}chain_extract} - Extract the node from the chain
+@item @code{@value{DIRPREFIX}chain_get} - Return the first node on the chain
+@item @code{@value{DIRPREFIX}chain_insert} - Insert the node into the chain
+@item @code{@value{DIRPREFIX}chain_append} - Append the node to chain
+@item @code{@value{DIRPREFIX}chain_append_unprotected} - Append the node to chain (unprotected)
+@item @code{@value{DIRPREFIX}chain_prepend} - Prepend the node to the end of the chain
+@item @code{@value{DIRPREFIX}chain_prepend_unprotected} - Prepend the node to chain (unprotected)
 @end itemize
 
 @section Background
@@ -647,6 +649,39 @@ This routine appends a node to the end of a chain.
 Interrupts are disabled during the append to ensure the atomicity of
 the operation.
 
+@c
+@c
+@c
+@page
+@subsection Append a Node (unprotected)
+
+@cindex chain append a node unprotected
+
+@subheading CALLING SEQUENCE:
+
+@ifset is-C
+@findex @value{DIRPREFIX}chain_append_unprotected
+@example
+void @value{DIRPREFIX}chain_append_unprotected(
+  @value{DIRPREFIX}chain_control *the_chain,
+  @value{DIRPREFIX}chain_node    *the_node
+);
+@end example
+@end ifset
+
+@subheading RETURNS
+
+Returns nothing.
+
+@subheading DESCRIPTION:
+
+This routine appends a node to the end of a chain.
+
+@subheading NOTES:
+
+Interrupts are NOT disabled during the append to ensure the atomicity of
+the operation.
+
 @c
 @c
 @c
@@ -679,3 +714,36 @@ This routine prepends a node to the front of the chain.
 
 Interrupts are disabled during the prepend to ensure the atomicity of
 the operation.
+
+@c
+@c
+@c
+@page
+@subsection Prepend a Node (unprotected)
+
+@cindex prepend node
+
+@subheading CALLING SEQUENCE:
+
+@ifset is-C
+@findex @value{DIRPREFIX}chain_prepend_unprotected
+@example
+void @value{DIRPREFIX}chain_prepend_unprotected(
+  @value{DIRPREFIX}chain_control *the_chain,
+  @value{DIRPREFIX}chain_node    *the_node
+);
+@end example
+@end ifset
+
+@subheading RETURNS
+
+Returns nothing.
+
+@subheading DESCRIPTION:
+
+This routine prepends a node to the front of the chain.
+
+@subheading NOTES:
+
+Interrupts are NOT disabled during the prepend to ensure the atomicity of
+the operation.
diff --git a/doc/user/dirstat.texi b/doc/user/dirstat.texi
index 727bc8d355..5994733bf3 100644
--- a/doc/user/dirstat.texi
+++ b/doc/user/dirstat.texi
@@ -7,7 +7,7 @@
 @c
 
 @ifinfo
-@node Directive Status Codes, Example Application, Chains Prepend a Node, Top
+@node Directive Status Codes, Example Application, Chains Prepend a Node (unprotected), Top
 @end ifinfo
 @chapter Directive Status Codes
 @table @b
-- 
cgit v1.2.3