From 3bee7f4314c89ed1998b6cd1fe0a8f6bf0254fdf Mon Sep 17 00:00:00 2001
From: Joel Sherrill <joel.sherrill@OARcorp.com>
Date: Wed, 10 May 2000 13:41:26 +0000
Subject: Made examples include checking of return status.

---
 doc/user/example.texi | 32 ++++++++++++++++++++++++--------
 doc/user/rtmon.t      | 20 ++++++++++++++++----
 2 files changed, 40 insertions(+), 12 deletions(-)

diff --git a/doc/user/example.texi b/doc/user/example.texi
index 1b16e367b8..60862e6a6e 100644
--- a/doc/user/example.texi
+++ b/doc/user/example.texi
@@ -29,14 +29,30 @@ rtems_task init_task(
   rtems_task_argument ignored
 )
 @{
-  rtems_id tid;
-
-  /* example assumes SUCCESSFUL return value */
-
-  (void) rtems_task_create( USER_APP_NAME, 1, RTEMS_MINIMUM_STACK_SIZE,
-                        RTEMS_NO_PREEMPT, RTEMS_FLOATING_POINT, &tid );
-  (void) rtems_task_start( tid, user_application, 0 );
-  (void) rtems_task_delete( SELF );
+  rtems_id          tid;
+  rtems_status_code status;
+  rtems_name        name;
+
+  name = rtems_build_name( 'A', 'P', 'P', '1' )
+
+  status = rtems_task_create(
+     name, 1, RTEMS_MINIMUM_STACK_SIZE,
+     RTEMS_NO_PREEMPT, RTEMS_FLOATING_POINT, &tid
+  );
+  if ( status != RTEMS_STATUS_SUCCESSFUL ) {
+    printf( "rtems_task_create failed with status of %d.\n", status );
+    exit( 1 );
+  }
+
+  status = rtems_task_start( tid, user_application, 0 );
+  if ( status != RTEMS_STATUS_SUCCESSFUL ) {
+    printf( "rtems_task_start failed with status of %d.\n", status );
+    exit( 1 );
+  }
+  
+  status = rtems_task_delete( SELF );    /* should not return */
+  printf( "rtems_task_delete returned with status of %d.\n", status );
+  exit( 1 );
 @}
 
 
diff --git a/doc/user/rtmon.t b/doc/user/rtmon.t
index bcfd8a6053..73b28cb97c 100644
--- a/doc/user/rtmon.t
+++ b/doc/user/rtmon.t
@@ -723,10 +723,15 @@ rtems_task Periodic_task()
 
   name = rtems_build_name( 'P', 'E', 'R', 'D' );
 
-  (void) rate_monotonic_create( name, &period );
+  status = rate_monotonic_create( name, &period );
+  if ( status != RTEMS_STATUS_SUCCESSFUL ) {
+    printf( "rtems_monotonic_create failed with status of %d.\n", rc );
+    exit( 1 );
+  }
+
 
   while ( 1 ) @{
-    if ( rate_monotonic_period( period, 100 ) == TIMEOUT )
+    if ( rate_monotonic_period( period, 100 ) == RTEMS_TIMEOUT )
       break;
 
     /* Perform some periodic actions */
@@ -734,8 +739,15 @@ rtems_task Periodic_task()
 
   /* missed period so delete period and SELF */
 
-  (void) rate_monotonic_delete( period );
-  (void) task_delete( SELF );
+  status = rate_monotonic_delete( period );
+  if ( status != RTEMS_STATUS_SUCCESSFUL ) {
+    printf( "rate_monotonic_delete failed with status of %d.\n", status );
+    exit( 1 );
+  }
+
+  status = rtems_task_delete( SELF );    /* should not return */
+  printf( "rtems_task_delete returned with status of %d.\n", status );
+  exit( 1 );
 @}
 @end example
 
-- 
cgit v1.2.3