From 0f613361b7f8faeb8db9c337b41397f565d74550 Mon Sep 17 00:00:00 2001
From: Joel Sherrill <joel.sherrill@OARcorp.com>
Date: Wed, 15 Jul 1998 19:28:29 +0000
Subject: Added comments.

---
 c/src/lib/libbsp/powerpc/dmv177/console/console.c  | 42 ++++++++++++++++++++--
 .../lib/libbsp/powerpc/dmv177/console/z85c30cfg.c  | 18 +++++++---
 2 files changed, 54 insertions(+), 6 deletions(-)

(limited to 'c')

diff --git a/c/src/lib/libbsp/powerpc/dmv177/console/console.c b/c/src/lib/libbsp/powerpc/dmv177/console/console.c
index 15e64145f0..1ca2282720 100644
--- a/c/src/lib/libbsp/powerpc/dmv177/console/console.c
+++ b/c/src/lib/libbsp/powerpc/dmv177/console/console.c
@@ -43,13 +43,14 @@ extern console_data  Console_Port_Data[];
 extern unsigned long  Console_Port_Count;
 extern rtems_device_minor_number  Console_Port_Minor;
  
-/* PAGE
+/*PAGE
  *
  *  console_open
  *
  *  open a port as a termios console.
  *
  */
+
 rtems_device_driver console_open(
   rtems_device_major_number major,
   rtems_device_minor_number minor,
@@ -115,6 +116,13 @@ rtems_device_driver console_open(
   return status;
 }
  
+/*PAGE
+ *
+ *  console_reserve_resources
+ *
+ *  This routine uses the termios driver to reserve resources.
+ */
+
 void console_reserve_resources(
   rtems_configuration_table *configuration
 )
@@ -123,6 +131,13 @@ void console_reserve_resources(
 }
 
 
+/*PAGE
+ *
+ *  console_close
+ *
+ *  This routine closes a port that has been opened as console.
+ */
+
 rtems_device_driver console_close(
   rtems_device_major_number major,
   rtems_device_minor_number minor,
@@ -140,6 +155,13 @@ rtems_device_driver console_close(
   return rtems_termios_close (arg);
 }
  
+/*PAGE
+ *
+ *  console_read
+ *
+ *  This routine uses the termios driver to read a character.
+ */
+
 rtems_device_driver console_read(
   rtems_device_major_number major,
   rtems_device_minor_number minor,
@@ -149,6 +171,13 @@ rtems_device_driver console_read(
   return rtems_termios_read (arg);
 }
  
+/*PAGE
+ *
+ *  console_write
+ *
+ *  this routine uses the termios driver to write a character.
+ */
+
 rtems_device_driver console_write(
   rtems_device_major_number major,
   rtems_device_minor_number minor,
@@ -158,6 +187,13 @@ rtems_device_driver console_write(
   return rtems_termios_write (arg);
 }
  
+/*PAGE
+ *
+ *  console_control
+ *
+ *  this routine uses the termios driver to process io
+ */
+
 rtems_device_driver console_control(
   rtems_device_major_number major,
   rtems_device_minor_number minor,
@@ -167,7 +203,7 @@ rtems_device_driver console_control(
   return rtems_termios_ioctl (arg);
 }
 
-/* PAGE
+/*PAGE
  *
  *  console_initialize
  *
@@ -250,3 +286,5 @@ rtems_device_driver console_initialize(
   return RTEMS_SUCCESSFUL;
 }
 
+
+
diff --git a/c/src/lib/libbsp/powerpc/dmv177/console/z85c30cfg.c b/c/src/lib/libbsp/powerpc/dmv177/console/z85c30cfg.c
index 46988e5ad0..fd27765850 100644
--- a/c/src/lib/libbsp/powerpc/dmv177/console/z85c30cfg.c
+++ b/c/src/lib/libbsp/powerpc/dmv177/console/z85c30cfg.c
@@ -16,7 +16,8 @@
 #include <rtems.h>
 #include <bsp.h>
 
-/* 
+/*PAGE
+ * 
  *  Read_z85c30_register
  */
 
@@ -36,7 +37,8 @@ unsigned8 Read_z85c30_register(
 
 }
 
-/*
+/*PAGE
+ *
  *  Write_z85c30_register
  */
 
@@ -56,7 +58,8 @@ void  Write_z85c30_register(
   *port = ucData;
 }
 
-/* 
+/*PAGE
+ * 
  *  Read_z85c30_data
  */
 
@@ -70,7 +73,8 @@ unsigned8 Read_z85c30_data(
   return *port;
 }
 
-/*
+/*PAGE
+ *
  *  Write_z85c30_data
  */
 
@@ -84,3 +88,9 @@ void  Write_z85c30_data(
   port = (unsigned8 *)ulDataPort;
   *port = ucData;
 }
+
+
+
+
+
+
-- 
cgit v1.2.3