2009-11-09 Joel Sherrill <joel.sherrill@oarcorp.com>

	* sp32/Makefile.am, sp33/Makefile.am, sp37/Makefile.am,
	sp38/Makefile.am, sp39/Makefile.am, sp43/Makefile.am,
	sp44/Makefile.am, spfatal01/Makefile.am, spfatal02/Makefile.am,
	spfatal03/Makefile.am, spfatal04/Makefile.am, spfatal05/Makefile.am,
	spfatal06/Makefile.am, spfatal07/Makefile.am, spfatal08/Makefile.am,
	spfatal09/Makefile.am, spobjgetnext/Makefile.am,
	spprintk/Makefile.am, spsize/Makefile.am, spwatchdog/Makefile.am,
	spwkspace/Makefile.am: Add documentation files for multiple tests.
	* sp32/sp32.doc, sp33/sp33.doc, sp37/sp37.doc, sp38/sp38.doc,
	sp39/sp39.doc, sp43/sp43.doc, sp44/sp44.doc, spfatal01/spfatal01.doc,
	spfatal02/spfatal02.doc, spfatal03/spfatal03.doc,
	spfatal04/spfatal04.doc, spfatal05/spfatal05.doc,
	spfatal06/spfatal06.doc, spfatal07/spfatal07.doc,
	spfatal08/spfatal08.doc, spfatal09/spfatal09.doc,
	spobjgetnext/spobjgetnext.doc, spprintk/spprintk.doc,
	spsize/spsize.doc, spwatchdog/spwatchdog.doc,
	spwkspace/spwkspace.doc: New files.

43 files changed, 595 insertions, 0 deletions

diff --git a/testsuites/sptests/ChangeLog b/testsuites/sptests/ChangeLog
index fdcf389f44..099a35bf33 100644
--- a/testsuites/sptests/ChangeLog
+++ b/testsuites/sptests/ChangeLog
@@ -1,3 +1,23 @@
+2009-11-09	Joel Sherrill <joel.sherrill@oarcorp.com>
+
+	* sp32/Makefile.am, sp33/Makefile.am, sp37/Makefile.am,
+	sp38/Makefile.am, sp39/Makefile.am, sp43/Makefile.am,
+	sp44/Makefile.am, spfatal01/Makefile.am, spfatal02/Makefile.am,
+	spfatal03/Makefile.am, spfatal04/Makefile.am, spfatal05/Makefile.am,
+	spfatal06/Makefile.am, spfatal07/Makefile.am, spfatal08/Makefile.am,
+	spfatal09/Makefile.am, spobjgetnext/Makefile.am,
+	spprintk/Makefile.am, spsize/Makefile.am, spwatchdog/Makefile.am,
+	spwkspace/Makefile.am: Add documentation files for multiple tests.
+	* sp32/sp32.doc, sp33/sp33.doc, sp37/sp37.doc, sp38/sp38.doc,
+	sp39/sp39.doc, sp43/sp43.doc, sp44/sp44.doc, spfatal01/spfatal01.doc,
+	spfatal02/spfatal02.doc, spfatal03/spfatal03.doc,
+	spfatal04/spfatal04.doc, spfatal05/spfatal05.doc,
+	spfatal06/spfatal06.doc, spfatal07/spfatal07.doc,
+	spfatal08/spfatal08.doc, spfatal09/spfatal09.doc,
+	spobjgetnext/spobjgetnext.doc, spprintk/spprintk.doc,
+	spsize/spsize.doc, spwatchdog/spwatchdog.doc,
+	spwkspace/spwkspace.doc: New files.
+
 2009-10-30	Ralf Corsépius <ralf.corsepius@rtems.org>
 
 	* sp14/asr.c: Remove PRIxrtems_signal_set (moved to tmacros.h).
diff --git a/testsuites/sptests/sp32/Makefile.am b/testsuites/sptests/sp32/Makefile.am
index bda909fd47..8490944782 100644
--- a/testsuites/sptests/sp32/Makefile.am
+++ b/testsuites/sptests/sp32/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = sp32
 sp32_SOURCES = init.c
 
 dist_rtems_tests_DATA = sp32.scn
+dist_rtems_tests_DATA += sp32.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/sp32/sp32.doc b/testsuites/sptests/sp32/sp32.doc
new file mode 100644
index 0000000000..1d731a2591
--- /dev/null
+++ b/testsuites/sptests/sp32/sp32.doc
@@ -0,0 +1,25 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  sp32
+
+directives:
+
+  rtems_rate_monotonic_create
+  rtems_rate_monotonic_period
+  rtems_rate_monotonic_delete
+
+concepts:
+
++ Ensure that periods operate as defined with a set of tasks of varying
+  periods.
diff --git a/testsuites/sptests/sp33/Makefile.am b/testsuites/sptests/sp33/Makefile.am
index f2ea9c23e4..834ed61dc3 100644
--- a/testsuites/sptests/sp33/Makefile.am
+++ b/testsuites/sptests/sp33/Makefile.am
@@ -9,6 +9,7 @@ sp33_SOURCES = init.c
 
 scndir = $(rtems_testsdir)
 dist_scn_DATA = sp33.scn
+dist_scn_DATA += sp33.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/sp33/sp33.doc b/testsuites/sptests/sp33/sp33.doc
new file mode 100644
index 0000000000..81306676ed
--- /dev/null
+++ b/testsuites/sptests/sp33/sp33.doc
@@ -0,0 +1,32 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  sp33
+
+directives:
+
+  status = rtems_barrier_wait
+  status = rtems_barrier_delete
+  status = rtems_barrier_ident
+  status = rtems_barrier_wait
+  status = rtems_barrier_release
+
+concepts:
+
++ Ensure that all barrier directives detect and properly handle 
+  parameter error conditions.
+
++ Ensure that manually released barriers operate as defined.
+
++ Ensure that automatically released barriers operate as defined.
+
diff --git a/testsuites/sptests/sp37/Makefile.am b/testsuites/sptests/sp37/Makefile.am
index 9180e7d7d7..ff74f2f3f8 100644
--- a/testsuites/sptests/sp37/Makefile.am
+++ b/testsuites/sptests/sp37/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = sp37
 sp37_SOURCES = init.c system.h
 
 dist_rtems_tests_DATA = sp37.scn
+dist_rtems_tests_DATA += sp37.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/sp37/sp37.doc b/testsuites/sptests/sp37/sp37.doc
new file mode 100644
index 0000000000..5ac0e1a281
--- /dev/null
+++ b/testsuites/sptests/sp37/sp37.doc
@@ -0,0 +1,34 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  sp37
+
+directives:
+
+  rtems_clock_tick
+  rtems_interrupt_disable (inline/body)
+  rtems_interrupt_enable (inline/body)
+  rtems_interrupt_flash (inline/body)
+  RTEMS_INTERRUPT_LEVEL
+  rtems_interrupt_level_attribute
+
+concepts:
+
++ Ensure that rtems_clock_tick operates properly when invoked from a task
+  rather than an ISR.
+
++ Ensure that the interrupt disable, enable, and flash directives operate
+  as expected.
+
++ Ensure that the methods accessing the interrupt level attribute operate
+  as expected.
diff --git a/testsuites/sptests/sp38/Makefile.am b/testsuites/sptests/sp38/Makefile.am
index b8e5c7bf75..e3a86cf170 100644
--- a/testsuites/sptests/sp38/Makefile.am
+++ b/testsuites/sptests/sp38/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = sp38
 sp38_SOURCES = init.c system.h
 
 dist_rtems_tests_DATA = sp38.scn
+dist_rtems_tests_DATA += sp38.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/sp38/sp38.doc b/testsuites/sptests/sp38/sp38.doc
new file mode 100644
index 0000000000..0ddcad90bf
--- /dev/null
+++ b/testsuites/sptests/sp38/sp38.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  sp38
+
+directives:
+
+  rtems_signal_catch
+  rtems_signal_send
+
+concepts:
+
++ Ensure that sending a Classic API signal from an ISR operates properly.
diff --git a/testsuites/sptests/sp39/Makefile.am b/testsuites/sptests/sp39/Makefile.am
index 1e348d3da5..cb0a297ba3 100644
--- a/testsuites/sptests/sp39/Makefile.am
+++ b/testsuites/sptests/sp39/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = sp39
 sp39_SOURCES = init.c system.h
 
 dist_rtems_tests_DATA = sp39.scn
+dist_rtems_tests_DATA += sp39.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/sp39/sp39.doc b/testsuites/sptests/sp39/sp39.doc
new file mode 100644
index 0000000000..01605b888f
--- /dev/null
+++ b/testsuites/sptests/sp39/sp39.doc
@@ -0,0 +1,25 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  sp39
+
+directives:
+
+  rtems_event_receive
+  rtems_event_send
+
+concepts:
+
++ Ensure that the interrupt critical section for sending an event from an
+  ISR while the receiving task is in the process of blocking with and withing
+  timeout is handled properly.
diff --git a/testsuites/sptests/sp43/Makefile.am b/testsuites/sptests/sp43/Makefile.am
index 1ac8036ad7..b364e6037a 100644
--- a/testsuites/sptests/sp43/Makefile.am
+++ b/testsuites/sptests/sp43/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = sp43
 sp43_SOURCES = init.c
 
 dist_rtems_tests_DATA = sp43.scn
+dist_rtems_tests_DATA += sp43.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/sp43/sp43.doc b/testsuites/sptests/sp43/sp43.doc
new file mode 100644
index 0000000000..c9703c0270
--- /dev/null
+++ b/testsuites/sptests/sp43/sp43.doc
@@ -0,0 +1,54 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  sp43
+
+directives:
+
+  rtems_build_id
+  rtems_build_name
+  rtems_get_version_string
+  rtems_object_get_api_name
+  rtems_object_get_classic_name
+  rtems_object_get_class_information
+  rtems_object_get_name
+  rtems_object_api_minimum_class
+  rtems_object_api_maximum_class
+  rtems_object_id_api_maximum
+  rtems_object_id_api_minimum
+  rtems_object_id_get_api
+  rtems_object_id_get_class
+  rtems_object_id_get_index
+  rtems_object_id_get_node
+  rtems_object_set_name
+  rtems_object_id_api_minimum
+  rtems_object_id_api_maximum
+  SCORE _Thread_Get
+  SCORE _Thread_Get
+  SCORE _Objects_Get
+
+
+concepts:
+
++ Ensure that the various object id and name services operate as expected.
+
++ Ensure that the various object id and name services detect and report
+  all errors.
+
++ Ensure that attempting to use a thread id from an API that is not installed
+  is detected and treated as an error.
+
++ Ensure that attempting to use an object id that is in the valid range but
+  does not reflect an object that has been created is detected and treated
+  as an error.
+
diff --git a/testsuites/sptests/sp44/Makefile.am b/testsuites/sptests/sp44/Makefile.am
index b497ac8320..6c774ae262 100644
--- a/testsuites/sptests/sp44/Makefile.am
+++ b/testsuites/sptests/sp44/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = sp44
 sp44_SOURCES = init.c
 
 dist_rtems_tests_DATA = sp44.scn
+dist_rtems_tests_DATA += sp44.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/sp44/sp44.doc b/testsuites/sptests/sp44/sp44.doc
new file mode 100644
index 0000000000..1e4e9a15d6
--- /dev/null
+++ b/testsuites/sptests/sp44/sp44.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  sp44
+
+directives:
+
+  rtems_task_mode
+
+concepts:
+
++ PR1212 - Verifies that timeslicing is not blocked if the task mode
+  is changed to timeslicing in the middle of its executing.
diff --git a/testsuites/sptests/spfatal01/Makefile.am b/testsuites/sptests/spfatal01/Makefile.am
index 4480c07f84..23d22bd4ea 100644
--- a/testsuites/sptests/spfatal01/Makefile.am
+++ b/testsuites/sptests/spfatal01/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spfatal01
 spfatal01_SOURCES = ../spfatal_support/init.c ../spfatal_support/system.h testcase.h
 
 dist_rtems_tests_DATA = spfatal01.scn
+dist_rtems_tests_DATA += spfatal01.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spfatal01/spfatal01.doc b/testsuites/sptests/spfatal01/spfatal01.doc
new file mode 100644
index 0000000000..eae9163b9f
--- /dev/null
+++ b/testsuites/sptests/spfatal01/spfatal01.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spfatal01
+
+directives:
+
+  rtems_task_create for a user initialization task
+
+concepts:
+
++ Ensure that when rtems_task_create returns an error when creating a Classic
+  API user initialization task is properly treated as a fatal error.
diff --git a/testsuites/sptests/spfatal02/Makefile.am b/testsuites/sptests/spfatal02/Makefile.am
index 11e63162b4..9fe3edba3f 100644
--- a/testsuites/sptests/spfatal02/Makefile.am
+++ b/testsuites/sptests/spfatal02/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spfatal02
 spfatal02_SOURCES = ../spfatal_support/init.c ../spfatal_support/system.h testcase.h
 
 dist_rtems_tests_DATA = spfatal02.scn
+dist_rtems_tests_DATA += spfatal02.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spfatal02/spfatal02.doc b/testsuites/sptests/spfatal02/spfatal02.doc
new file mode 100644
index 0000000000..a6d991d502
--- /dev/null
+++ b/testsuites/sptests/spfatal02/spfatal02.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spfatal02
+
+directives:
+
+  rtems_task_start for a user initialization task
+
+concepts:
+
++ Ensure that when rtems_task_start returns an error when creating a Classic
+  API user initialization task is properly treated as a fatal error.
diff --git a/testsuites/sptests/spfatal03/Makefile.am b/testsuites/sptests/spfatal03/Makefile.am
index d7c3ad2894..b8534069c9 100644
--- a/testsuites/sptests/spfatal03/Makefile.am
+++ b/testsuites/sptests/spfatal03/Makefile.am
@@ -6,7 +6,9 @@ MANAGERS = all
 
 rtems_tests_PROGRAMS = spfatal03
 spfatal03_SOURCES = ../spfatal_support/init.c ../spfatal_support/system.h testcase.h
+
 dist_rtems_tests_DATA = spfatal03.scn
+dist_rtems_tests_DATA += spfatal03.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spfatal03/spfatal03.doc b/testsuites/sptests/spfatal03/spfatal03.doc
new file mode 100644
index 0000000000..121f69c3f3
--- /dev/null
+++ b/testsuites/sptests/spfatal03/spfatal03.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spfatal03
+
+directives:
+
+  rtems_semaphore_obtain
+
+concepts:
+
++ Ensure that the error condition of obtaining a semaphore in a dispatching
+  disabled critical section is properly treated as a fatal error.
diff --git a/testsuites/sptests/spfatal04/Makefile.am b/testsuites/sptests/spfatal04/Makefile.am
index dbf56dcd8e..f0efe2c6cd 100644
--- a/testsuites/sptests/spfatal04/Makefile.am
+++ b/testsuites/sptests/spfatal04/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spfatal04
 spfatal04_SOURCES = ../spfatal_support/init.c ../spfatal_support/system.h testcase.h
 
 dist_rtems_tests_DATA = spfatal04.scn
+dist_rtems_tests_DATA += spfatal04.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spfatal04/spfatal04.doc b/testsuites/sptests/spfatal04/spfatal04.doc
new file mode 100644
index 0000000000..f7131344e9
--- /dev/null
+++ b/testsuites/sptests/spfatal04/spfatal04.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spfatal04
+
+directives:
+
+  rtems_fatal_error_occurred
+
+concepts:
+
++ Ensure that when the user directly invokes the rtems_fatal_error_occurred
+  service that it is properly treated as a fatal error.
diff --git a/testsuites/sptests/spfatal05/Makefile.am b/testsuites/sptests/spfatal05/Makefile.am
index bdfe18851c..64de26cdcb 100644
--- a/testsuites/sptests/spfatal05/Makefile.am
+++ b/testsuites/sptests/spfatal05/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spfatal05
 spfatal05_SOURCES = ../spfatal_support/init.c ../spfatal_support/system.h testcase.h
 
 dist_rtems_tests_DATA = spfatal05.scn
+dist_rtems_tests_DATA += spfatal05.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spfatal05/spfatal05.doc b/testsuites/sptests/spfatal05/spfatal05.doc
new file mode 100644
index 0000000000..0abdd8b82f
--- /dev/null
+++ b/testsuites/sptests/spfatal05/spfatal05.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spfatal05
+
+directives:
+
+  None specifically
+
+concepts:
+
++ Ensure that the error condition when a Classic API task returns from
+  its task body is properly treated as a fatal error.
diff --git a/testsuites/sptests/spfatal06/Makefile.am b/testsuites/sptests/spfatal06/Makefile.am
index 9c8793fe31..807ffdff5d 100644
--- a/testsuites/sptests/spfatal06/Makefile.am
+++ b/testsuites/sptests/spfatal06/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spfatal06
 spfatal06_SOURCES = ../spfatal_support/init.c ../spfatal_support/system.h testcase.h
 
 dist_rtems_tests_DATA = spfatal06.scn
+dist_rtems_tests_DATA += spfatal06.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spfatal06/spfatal06.doc b/testsuites/sptests/spfatal06/spfatal06.doc
new file mode 100644
index 0000000000..c97dad1aae
--- /dev/null
+++ b/testsuites/sptests/spfatal06/spfatal06.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spfatal06
+
+directives:
+
+  None specifically
+
+concepts:
+
++ Ensure that the error condition when the BSP specific stack allocator
+  hook is incorrectly configured is properly treated as a fatal error.
diff --git a/testsuites/sptests/spfatal07/Makefile.am b/testsuites/sptests/spfatal07/Makefile.am
index c9999edc88..1221969e80 100644
--- a/testsuites/sptests/spfatal07/Makefile.am
+++ b/testsuites/sptests/spfatal07/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spfatal07
 spfatal07_SOURCES = ../spfatal_support/init.c ../spfatal_support/system.h testcase.h
 
 dist_rtems_tests_DATA = spfatal07.scn
+dist_rtems_tests_DATA += spfatal07.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spfatal07/spfatal07.doc b/testsuites/sptests/spfatal07/spfatal07.doc
new file mode 100644
index 0000000000..0305a08067
--- /dev/null
+++ b/testsuites/sptests/spfatal07/spfatal07.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spfatal07
+
+directives:
+
+  None specifically
+
+concepts:
+
++ Ensure that the error condition when the interrupt stack size configured
+  is too small is properly treated as a fatal error.
diff --git a/testsuites/sptests/spfatal08/Makefile.am b/testsuites/sptests/spfatal08/Makefile.am
index 816ce72db7..11b73f144a 100644
--- a/testsuites/sptests/spfatal08/Makefile.am
+++ b/testsuites/sptests/spfatal08/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spfatal08
 spfatal08_SOURCES = ../spfatal_support/init.c ../spfatal_support/system.h testcase.h
 
 dist_rtems_tests_DATA = spfatal08.scn
+dist_rtems_tests_DATA += spfatal08.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spfatal08/spfatal08.doc b/testsuites/sptests/spfatal08/spfatal08.doc
new file mode 100644
index 0000000000..121f5cbd22
--- /dev/null
+++ b/testsuites/sptests/spfatal08/spfatal08.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spfatal08
+
+directives:
+
+  None specifically
+
+concepts:
+
++ Ensure that the error condition when the workspace provided is too small
+  is properly treated as a fatal error.
diff --git a/testsuites/sptests/spfatal09/Makefile.am b/testsuites/sptests/spfatal09/Makefile.am
index 1bacf8c239..f42a5783f7 100644
--- a/testsuites/sptests/spfatal09/Makefile.am
+++ b/testsuites/sptests/spfatal09/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spfatal09
 spfatal09_SOURCES = ../spfatal_support/init.c ../spfatal_support/system.h testcase.h
 
 dist_rtems_tests_DATA = spfatal09.scn
+dist_rtems_tests_DATA += spfatal09.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spfatal09/spfatal09.doc b/testsuites/sptests/spfatal09/spfatal09.doc
new file mode 100644
index 0000000000..9f7be40af0
--- /dev/null
+++ b/testsuites/sptests/spfatal09/spfatal09.doc
@@ -0,0 +1,23 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spfatal09
+
+directives:
+
+  None specifically.
+
+concepts:
+
++ Ensure that configuring with an invalid workspace base address is
+  properly handled as a fatal error.
diff --git a/testsuites/sptests/spobjgetnext/Makefile.am b/testsuites/sptests/spobjgetnext/Makefile.am
index a0d67ef310..86cf4a9b5c 100644
--- a/testsuites/sptests/spobjgetnext/Makefile.am
+++ b/testsuites/sptests/spobjgetnext/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spobjgetnext
 spobjgetnext_SOURCES = init.c system.h
 
 dist_rtems_tests_DATA = spobjgetnext.scn
+dist_rtems_tests_DATA += spobjgetnext.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spobjgetnext/spobjgetnext.doc b/testsuites/sptests/spobjgetnext/spobjgetnext.doc
new file mode 100644
index 0000000000..f59cff44f9
--- /dev/null
+++ b/testsuites/sptests/spobjgetnext/spobjgetnext.doc
@@ -0,0 +1,24 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spobjgetnext
+
+directives:
+
+  SCORE _Objects_Get_next
+
+concepts:
+
++ Ensure that _Objects_Get_next handles error conditions properly.
+
++ Ensure the _Objects_Get_next behaves as expected.
diff --git a/testsuites/sptests/spprintk/Makefile.am b/testsuites/sptests/spprintk/Makefile.am
index 1d6ac2b1d0..be3b1da219 100644
--- a/testsuites/sptests/spprintk/Makefile.am
+++ b/testsuites/sptests/spprintk/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spprintk
 spprintk_SOURCES = init.c
 
 dist_rtems_tests_DATA = spprintk.scn
+dist_rtems_tests_DATA += spprintk.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spprintk/spprintk.doc b/testsuites/sptests/spprintk/spprintk.doc
new file mode 100644
index 0000000000..84020d6d14
--- /dev/null
+++ b/testsuites/sptests/spprintk/spprintk.doc
@@ -0,0 +1,22 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spprintk
+
+directives:
+
+  printk
+
+concepts:
+
++ Ensure that printk() is fully exercised and operates as expected.
diff --git a/testsuites/sptests/spsize/Makefile.am b/testsuites/sptests/spsize/Makefile.am
index 919a4d83d6..92f73c8040 100644
--- a/testsuites/sptests/spsize/Makefile.am
+++ b/testsuites/sptests/spsize/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spsize
 spsize_SOURCES = init.c getint.c size.c system.h
 
 dist_rtems_tests_DATA = spsize.scn
+dist_rtems_tests_DATA += spsize.scn
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spsize/spsize.doc b/testsuites/sptests/spsize/spsize.doc
new file mode 100644
index 0000000000..f54c96f345
--- /dev/null
+++ b/testsuites/sptests/spsize/spsize.doc
@@ -0,0 +1,24 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spsize
+
+directives:
+
+  None specifically. 
+
+concepts:
+
++ Report the size of the data required by RTEMS.
+
++ Report the size of the various object control structures allocated by RTEMS.
diff --git a/testsuites/sptests/spwatchdog/Makefile.am b/testsuites/sptests/spwatchdog/Makefile.am
index 82be2b6060..583af9777f 100644
--- a/testsuites/sptests/spwatchdog/Makefile.am
+++ b/testsuites/sptests/spwatchdog/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spwatchdog
 spwatchdog_SOURCES = init.c task1.c system.h prtime.c delay.c
 
 dist_rtems_tests_DATA = spwatchdog.scn
+dist_rtems_tests_DATA += spwatchdog.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spwatchdog/spwatchdog.doc b/testsuites/sptests/spwatchdog/spwatchdog.doc
new file mode 100644
index 0000000000..4f75e66d64
--- /dev/null
+++ b/testsuites/sptests/spwatchdog/spwatchdog.doc
@@ -0,0 +1,26 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spwatchdog
+
+directives:
+
+  SCORE _Watchdog_Report
+  SCORE _Watchdog_Report_chain
+  various timer, delay, and clock services
+
+concepts:
+
++ Ensure that the SCORE Watchdog routines operate properly.
+
++ Ensure that the SCORE Watchdog reporting routines operate properly.
diff --git a/testsuites/sptests/spwkspace/Makefile.am b/testsuites/sptests/spwkspace/Makefile.am
index cf8bfdc94c..4bb97c2c3b 100644
--- a/testsuites/sptests/spwkspace/Makefile.am
+++ b/testsuites/sptests/spwkspace/Makefile.am
@@ -8,6 +8,7 @@ rtems_tests_PROGRAMS = spwkspace
 spwkspace_SOURCES = init.c
 
 dist_rtems_tests_DATA = spwkspace.scn
+dist_rtems_tests_DATA += spwkspace.doc
 
 include $(RTEMS_ROOT)/make/custom/@RTEMS_BSP@.cfg
 include $(top_srcdir)/../automake/compile.am
diff --git a/testsuites/sptests/spwkspace/spwkspace.doc b/testsuites/sptests/spwkspace/spwkspace.doc
new file mode 100644
index 0000000000..dbfeee2345
--- /dev/null
+++ b/testsuites/sptests/spwkspace/spwkspace.doc
@@ -0,0 +1,34 @@
+#
+#  $Id$
+#
+#  COPYRIGHT (c) 1989-2009.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.rtems.com/license/LICENSE.
+#
+
+This file describes the directives and concepts tested by this test set.
+
+test set name:  spwkspace
+
+directives:
+
+  rtems_workspace_get_information
+  rtems_workspace_allocate
+  rtems_workspace_free
+
+concepts:
+
++ Ensure that the application can obtain information on the RTEMS workspace.
+
++ Ensure that the application can allocate memory from the workspace.
+
++ Ensure that error conditions in the workspace allocate memory directive
+  are properly handled.
+
++ Ensure that error conditions in the workspace free memory directive
+  are properly handled.
+
++ Ensure that the application can free memory back to the workspace.