Initial revision

1 files changed, 74 insertions, 0 deletions

diff --git a/examples/README b/examples/README
new file mode 100644
index 00000000000..38bb99b7d1d
--- /dev/null
+++ b/examples/README
@@ -0,0 +1,74 @@
+This directory contains a number of examples that illustrate how to
+use the following ACE library components.  If you want to see how
+to program using ACE, this is the best place to start reading code and
+learning the ACE design.
+				
+These examples are roughly divided up according to the class
+categories in ACE.  For more information on ACE class categories,
+please take a look at $WRAPPER_ROOT/ACE-categories.
+
+	. ASX
+		Illustrate various components in the ADAPTIVE Service
+		eXecutive, which is a user-level implementation of
+		System V STREAMS written in C++.
+		
+
+	. CORBA
+		Illustrate how CORBA can be integrated into ACE.
+
+	. Connection
+		Illustrate how the various Acceptor and Connector
+		components can be used.		
+
+	. IPC_SAP
+		Illustrate the C++ wrappers for Sockets, TLI, UNIX and
+		Win32 Named Pipes, and UNIX Stream Pipes.
+
+	. Log_Msg
+		Illustrate some of the features of the logging
+		facility used in ACE to consolidate debugging and
+		error report.
+		
+	. Logger
+		This is a simple version of a Server Logging Daemon
+		that illustrates the "bare-bones" usage of the
+		Reactor.  A more sophisticated set of logging examples
+		are in the $WRAPPER_ROOT/netsvcs/{client,lib,server}
+		directories.
+
+	. Mem_Map
+		Illustrate how the ACE memory-mapped file components
+		work.
+		
+	. Misc
+		Various miscellaneous tests that illustrate how ACE
+		utility components work.
+
+	. Reactor
+		Contains many examples of how to utilize the ACE
+		object-oriented event demultiplexer.
+
+	. Service_Configurator
+		Illustrates the use of the ACE mechanism for
+		dynamically configuring communication services.
+
+	. Shared_Malloc
+		Illustrates the use of ACE wrappers for
+		sophisticated use of the ACE_Malloc shared
+		memory components.
+
+	. Shared_Memory
+		Illustrates the use of simple ACE wrappers for
+		shared memory and memory mapped file.
+
+	. System_V_IPC
+		Illustrates how to use the ACE wrappers for System V 
+		IPC (i.e., semphores, shared memory, and message
+		queues).
+
+	. Threads
+		Illustrates the use of ACE wrappers for threading
+		and synchronization.
+
+		
+