Thu Dec 21 18:22:28 2000 Luther J Baker <luther@cs.wustl.edu>

author: luther <luther@ae88bc3d-4319-0410-8dbf-d08b4c9d3795> 2000-12-22 01:18:47 +0000
committer: luther <luther@ae88bc3d-4319-0410-8dbf-d08b4c9d3795> 2000-12-22 01:18:47 +0000
commit: fde10883bbedbac57453e88c4dfe840fd614830e (patch)
tree: 7bde51a3c29a6e846aa46d7e949c3dfa02c78cfd
parent: e0da8204199e3cb3f0c0231efdad8ca2d82bd4a0 (diff)
download: ATCD-fde10883bbedbac57453e88c4dfe840fd614830e.tar.gz
5 files changed, 271 insertions, 0 deletions
diff --git a/PACE/ChangeLog b/PACE/ChangeLog
index 11493ead522..6221abc9ac4 100644
--- a/PACE/ChangeLog
+++ b/PACE/ChangeLog
@@ -1,3 +1,13 @@
+Thu Dec 21 18:22:28 2000  Luther J Baker  <luther@cs.wustl.edu>
+
+	* docs/index.html: 	
+	* docs/legend.html: 	
+	* docs/overview.html:
+	* docs/todo.html: 	
+
+	  Begin moving PACE documentation to main distribution.
+	  Also rewriting much of this.
+
 Thu Dec 21 18:02:23 2000  Luther J Baker  <luther@cs.wustl.edu>
 
 	* pace/docs/todo.txt
diff --git a/PACE/docs/index.html b/PACE/docs/index.html
new file mode 100644
index 00000000000..b10d70f5e25
--- /dev/null
+++ b/PACE/docs/index.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+  <head>
+    <!-- $Id$ -->
+    <title>PACE Index</title>
+  </head>
+
+  <frameset cols="150,*" border="0">
+    <frame src="legend.html" name="left">
+    <frame src="todo.html" name="right">
+  </frameset>
+
+<!-- Created: Thu Dec 21 18:08:30 CST 2000 -->
+<!-- hhmts start -->
+Last modified: Thu Dec 21 19:17:45 CST 2000
+<!-- hhmts end -->
+  </body>
+</html>
diff --git a/PACE/docs/legend.html b/PACE/docs/legend.html
new file mode 100644
index 00000000000..d2d09c5a957
--- /dev/null
+++ b/PACE/docs/legend.html
@@ -0,0 +1,44 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+  <head>
+    <!-- $Id$ -->
+    <title>PACE Legend</title>
+    <base target="right">
+  </head>
+
+  <body bgcolor="#EEEEEE">
+    <h1>PACE</h1>
+
+    <font face="Arial, Helvetica, Verdana" size="2">
+    <ul>
+      <li>splash</li>
+      <li><a href="overview.html">overview</a></li>
+      <li>reference</li>
+      <li>source</li>
+      <li>install</li>
+      <li>download</li>
+    </ul>
+
+    <ul>
+      <li><a href="http://www.cs.wustl.edu/~doc" target="_parent">
+        doc group</a></li>
+      <li><a href="http://www.cs.wustl.edu/~schmidt/ACE.html" target="_parent">
+        ace</a></li>
+      <li><a href="http://www.cs.wustl.edu/~schmidt/TAO.html" target="_parent">
+        tao</a></li>
+    </ul>
+
+    <ul>
+      <li><p><a href="todo.html">todo</a></p></li>
+    </ul>
+
+    <hr>
+    <address><a href="mailto:luther@cs.wustl.edu">Luther J Baker</a></address>
+    </font>
+
+<!-- Created: Thu Dec 21 18:09:56 CST 2000 -->
+<!-- hhmts start -->
+Last modified: Thu Dec 21 19:17:54 CST 2000
+<!-- hhmts end -->
+  </body>
+</html>
diff --git a/PACE/docs/overview.html b/PACE/docs/overview.html
new file mode 100644
index 00000000000..27f29e292d9
--- /dev/null
+++ b/PACE/docs/overview.html
@@ -0,0 +1,156 @@
+<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
+<!-- $Id$ -->
+
+<!-- html -->
+<html>
+
+<!-- head -->
+<head>
+   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+   <title>PACE Overview</title>
+</head>
+
+<!-- body -->
+<body text="#000000" bgcolor="#CCCCCC" link="#0000EF" vlink="#51188E" alink="#FF0000">
+
+<!-- links -->
+<table width="700" align="center">
+<tr><td>
+  <img src="../IMAGES/but_overview.gif" border="0">
+
+  <a href="../DOWN/index.html">
+  <img src="../IMAGES/but_download.gif" border="0"></a>
+
+  <a href="../DOCS/index.html">
+  <img src="../IMAGES/but_documents.gif" border="0"></a>
+
+  <a href="http://www.cs.wustl.edu/~schmidt/ACE.html">
+  <img src="../IMAGES/but_ace.gif" border="0"></a>
+
+  <a href="http://www.cs.wustl.edu/~schmidt/TAO.html">
+  <img src="../IMAGES/but_tao.gif" border="0"></a>
+
+  <a href="http://www.cs.wustl.edu/~schmidt/ACE-copying.html">
+  <img src="../IMAGES/but_copyright.gif" border="0"></a>
+</td></tr>
+
+<!-- line -->
+<tr><td>
+<img src="../IMAGES/line_mid_700.gif">
+</tr></td>
+
+<tr><td>
+<h2>PACE Overview</h2>
+
+      <p>PACE is an OS abstraction layer designed for lightweight and/or verified
+         systems.</p>
+      <p>It offers these benefits:</p>
+      <ul>
+        <li><p>A strict POSIX.1-like, low-level interface.  Its interface is "POSIX
+            compatible"; by that we mean as close to POSIX.1 as it can be, given
+            that PACE is not an operating system.  And, to avoid name conflicts
+            with OS APIs, all low-level PACE function names have the
+            <i><b>pace_</b></i> prefix.</p>
+        </li>
+        <li><p>The low-level interface is a C file, so that it can be used in both
+            C and C++ programs.</p>
+        </li>
+        <li><p>The low-level interface is partitioned into multiple files, one per
+            POSIX.1 section.</p>
+        </li>
+      </ul>
+       
+
+<h2>ACE uses PACE</h2>
+
+      <p>The ADAPTIVE Communication Environment
+         <a href="http://www.cs.wustl.edu/~schmidt/ACE.html">(ACE)</a> is a freely
+         available, open-source, object-oriented
+         <a href="http://www.cs.wustl.edu/~schmidt/courses.html"> (OO)</a> framework
+         that implements many core design patterns for concurrent communication
+         software.</p>
+
+      <p>ACE is currently built on an
+         <a href="http://www.cs.wustl.edu/~schmidt/ACE-overview.html">OS Adaptation
+         Layer</a> that abstracts away specific computer architecture / platform
+         dependencies therfore allowing ACE to be portable across any platform that the
+         adaptation layer supports.</p>
+
+      <p>ACE also forms the foundation upon which
+         <a href="http://www.cs.wustl.edu/~schmidt/TAO.html">TAO</a> is built. The
+         combination of implementing TAO (adding specific functionality to ACE) and
+         the ever shifting sands of vendor-specific operating systems has grown the ACE
+         adapatation layer from a small core of critial functions to over 30,000 lines
+         of interdependent code. The development of TAO tied in with requests from our
+         sponsors as well as suggestions from the development community at large
+         contributed to our decision to re-engineer ACE' adaptation layer. PACE is one
+         part of this effort.</p>
+
+<h2>PACE Objectives</h2>
+
+      <p>Some objectives of this phase of ACE' development (PACE) include:</p>
+
+      <ul>
+      <li><p><b>ACE Developers:</b> Make the low level abstraction layer code more
+             maintainable.<br> <i>(reduce file size and file interdependence - improve
+             code modularity)</i></p></li>
+      <li><p><b>ACE Users:</b> Reduce ACE' footprint.<br>
+             <i>(this is not a one step task by any stretch of the imagination, but we
+             will begin breaking out the code into separate files - allowing developers
+             the opportunity option to compile and link specific object files to their
+             executables instead of the entire ACE adaptation layer library)</i></p></li>
+      <li><p><b>ACE Users:</b> Update the adaptation layer to be POSIX compliant.<br>
+             <i>(see next)</i></p></li>
+      <li><p><b>ACE Users:</b> Split the adaptation layer to support both a <b>C</b>
+             api (PACE) as well as a set of <b>C++</b> wrapper classes (ACE_OS)
+             allowing <i><b>both C &amp; C++</b></i> developers to call directly into the
+             low level api.<br>
+             <i>(encapslate POSIX and system calls in <b>C</b> wrappers and re-write the
+             (ACE_OS) adaptation layer to transparently call into the POSIX emulation api
+             (PACE))</i></p></li>
+      <li><p>ACE Users:</b>ACE will not change its public interface, it will only add low
+             level <b>C</b> operations to its repertoire. As is obvious, software built on
+             this adaptation layer is portable across the various platforms that ACE
+             supports. This provides backward compatilibity for people already using the
+             current <b>C++</b> (ACE_OS) adaptation layer of ACE.</p>
+      </ul>
+
+      <p>This is an open-source project maintained by:
+         <ul>
+           <li><a href="http://www.cs.wustl.edu/~schmidt">Dr. Douglas Schmidt</a> of the 
+               <a href="http://www.cs.uci.edu/">University of California - Irvine</a></li>
+           <li><a href="http://www.cs.wustl.edu/~levine">Dr. David Levine</a> of 
+               <a href="http://www.cs.wustl.edu/">Washington University - St. Louis</a></li>
+           <li>their respective sister <a href="http://www.cs.wustl.edu/~doc">
+               <b><font color="red">D</font></b>istributed
+               <b><font color="red">O</font></b>bject
+               <b><font color="red">C</font></b>omputing</a> research groups.</li>
+         </ul>
+      </p>
+
+      <p>Additional information regarding
+         <a href="http://www.cs.wustl.edu/~schmidt/ACE.html">ACE</a> and
+         <a href="http://www.cs.wustl.edu/~luther/PACE">PACE</a> and
+         <a href="http://www.cs.wustl.edu/~schmidt/TAO.html">TAO</a> is available
+         as well as a <a href="http://www.cs.wustl.edu/~schmidt/TAO-obtain.html">full
+         source distribution</a> of TAO + ACE + PACE.
+
+      <p>If you have any questions, suggestions or contributions regarding PACE, 
+         please <a href="mailto:luther@cs.wustl.edu">write</a> to us or subscribe to the
+         pace-users mailing list (send email to <a href="mailto:majordomo@cs.wustl.edu">
+         majordomo@cs.wustl.edu</a> with <b>"subscribe pace-users"</b> in the <i>body</i>,
+         not the subject line ;-)</p>
+</td></tr>
+
+<!-- line -->
+<tr><td>
+<div align="center"><img src="../IMAGES/line_mid_700.gif"></div>
+</td></tr>
+
+<tr><td>
+<div align="center"><a href="http://www.cs.wustl.edu/~luther/PACE">home</a></div>
+</td></tr>
+</table>
+
+</body>
+</html>
diff --git a/PACE/docs/todo.html b/PACE/docs/todo.html
new file mode 100644
index 00000000000..a4e30667774
--- /dev/null
+++ b/PACE/docs/todo.html
@@ -0,0 +1,43 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+  <head>
+    <!-- $Id$ -->
+    <title>PACE ToDo</title>
+  </head>
+
+  <body bgcolor="#CCCCCC">
+    <h1>PACE ToDo</h1>
+
+    <p><i>January 2000</i></p>
+    <ul>
+      <li><p>Test PACE (port a test suite)</p></li>
+      <li><p>More NT emulation</p></li>
+      <li><p>Complete html documentation of PACE in PACE/docs</p></li>
+    </ul>
+ 
+    <p><i>December 2000</i></p>
+    <ul>
+      <li><p>The following tasks apply to the following plaforms:</p></li>
+      <ul><p>
+        <li>Solaris</li>
+        <li>LynxOS</li>
+        <li>Linux</li>
+        <li>NT</li>
+      </p></ul>
+
+      <li><p>Wrap POSIX calls</p></li>
+      <li><p>Build ACE using PACE</p></li>
+      <li><p>Build TAO using ACE using PACE</p></li>
+      <li><p>Build TAO Services using ACE using PACE</p></li>
+      <li><p>Add TCP Socket support to PACE</p></li>
+
+    </ul>
+
+    <hr>
+    <address><a href="mailto:luther@cs.wustl.edu">Luther J Baker</a></address>
+<!-- Created: Thu Dec 21 18:25:22 CST 2000 -->
+<!-- hhmts start -->
+Last modified: Thu Dec 21 19:18:14 CST 2000
+<!-- hhmts end -->
+  </body>
+</html>
author	luther <luther@ae88bc3d-4319-0410-8dbf-d08b4c9d3795>	2000-12-22 01:18:47 +0000
committer	luther <luther@ae88bc3d-4319-0410-8dbf-d08b4c9d3795>	2000-12-22 01:18:47 +0000
commit	fde10883bbedbac57453e88c4dfe840fd614830e (patch)
tree	7bde51a3c29a6e846aa46d7e949c3dfa02c78cfd
parent	e0da8204199e3cb3f0c0231efdad8ca2d82bd4a0 (diff)
download	ATCD-fde10883bbedbac57453e88c4dfe840fd614830e.tar.gz