summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--TAO/ChangeLog-98c13
-rw-r--r--TAO/INSTALL95
-rw-r--r--TAO/Makefile9
-rw-r--r--TAO/TAO-INSTALL.html17
4 files changed, 129 insertions, 5 deletions
diff --git a/TAO/ChangeLog-98c b/TAO/ChangeLog-98c
index 7dc59eb989e..4dc68c5676e 100644
--- a/TAO/ChangeLog-98c
+++ b/TAO/ChangeLog-98c
@@ -1,3 +1,16 @@
+Tue Jan 13 15:55:32 1998 Chris Cleeland <cleeland@cs.wustl.edu>
+
+ * Makefile (INSTALL): Added a rule to build the INSTALL file from
+ TAO-INSTALL.html. Also added both TAO-INSTALL.html and INSTALL to
+ the list of files included in the release. TAO-INSTALL.html had
+ not been included at all.
+
+ * TAO-INSTALL.html: Updated some of the text in the Unix portion
+ to be explicit regarding the need for GNU Make.
+
+ * INSTALL: Added this file, which is the output of 'lynx -dump
+ TAO-INSTALL.html'.
+
Mon Jan 12 20:04:32 1998 Sumedh Mungee <sumedh@cs.wustl.edu>
* server.cpp: Added comments
diff --git a/TAO/INSTALL b/TAO/INSTALL
new file mode 100644
index 00000000000..649909c5961
--- /dev/null
+++ b/TAO/INSTALL
@@ -0,0 +1,95 @@
+
+ _________________________________________________________________
+
+ Building and Installing TAO
+
+ TAO has been ported and tested Windows NT, Solaris, VxWorks, and
+ Linux. I expect that major portions of the release will port easily to
+ other platforms that ACE has been ported to. If you can help port TAO
+ to other platforms we'd appreciate it.
+
+ TAO can be obtained [1]electronically via the WWW and ftp. Besides
+ getting the [2]TAO release you will need [3]ACE. You will likely need
+ the most recent [4]beta version of ACE because TAO tends to track
+ changes to ACE rather closely.
+
+ A quick build note for users who have used ACE with other ORBs:
+ linking TAO with a version of ACE that must also be linked against
+ another ORB vendor's library, e.g., liborbix.so, will produce
+ undefined and most likely unpredictable and erroneous results.
+
+ _________________________________________________________________
+
+ On UNIX platforms
+
+ 1. Set ACE_ROOT environment variable as outlined in the [5]ACE
+ installation notes.
+ 2. Build and install ACE under $ACE_ROOT.
+ + Change directory to $ACE_ROOT/ace and execute [6]make.
+ 3. Set TAO_ROOT environment variable to $ACE_ROOT/TAO.
+ 4. Build and install the TAO release under $TAO_ROOT.
+ + Change directory to $TAO_ROOT/tao and execute [7]make.
+ 5. Change directory to $TAO_ROOT/tests and execute [8]make.
+ 6. Follow instructions on executing the various examples under
+ $TAO_ROOT/tests.
+
+ _A Note On Make_
+
+ Since TAO is built atop ACE, TAO re-uses ACE's Makefile structure as
+ well. Thus, just like ACE requires GNU Make, so too does TAO. More
+ exactly, versions of make which are known to _not_ work include those
+ from Solaris 4.x and 5.x, HP-UX, the latest BSD, etc.
+
+ GNU Make can be obtained from various places in source form.
+ _________________________________________________________________
+
+ On Windows NT
+
+ Before compiling TAO_IDL on NT, you may need to set the environment
+ variable CPP_PATH to where CL.exe is installed on your machine. By
+ default, we set this variable to to "C:/Program
+ Files/DevStudio/VC/bin". Your location may vary, however. Notice that
+ if you forget to set this variable, you must rebuild TAO_IDL after
+ setting it.
+
+ Visual C++ 5.0
+
+ It works best if TAO is placed in ACE_wrappers so TAO ends up in
+ ACE_wrappers\TAO because the Visual C++ 5.0 Project files are set up
+ to work in this configuration. If you move it, then make sure you
+ change the project file to look for the include and library files in
+ the correct place.
+
+ 1. Make sure ACE is built (For Visual C++ 5.0, use ace.dsw or
+ ace-vc50.dsw, whichever is in your copy of ACE).
+
+ 2. Load the workspace tao\TAO.dsw and build the TAO library.
+
+ 3. To build the Cubit test, load the workspace
+ tests\Cubit\TAO\test.dsw and build both client and server.
+
+ Visual C++ 4.x
+
+ 1. In Tools|Options, go to the Directories page and make sure that
+ include files paths includes ACE_wrappers\ and the root directory
+ of TAO (which can be ACE_wrappers\TAO if installed there). The
+ library files paths should include ACE_wrappers\ace.
+ 2. Load the project file tao\TAO.mdp and build the TAO library.
+ 3. To build the Cubit test, load the project file
+ tests\Cubit\TAO\test.mdp and build both client and server.
+
+ _________________________________________________________________
+
+ Back to the [9]TAO home page.
+
+References
+
+ 1. file://localhost/.automount/tango/root/export2/project/doc/chris/ACE_wrappers/TAO/TAO-obtain.html
+ 2. http://siesta.cs.wustl.edu/~schmidt/TAO-obtain.html
+ 3. http://siesta.cs.wustl.edu/~schmidt/ACE-obtain.html
+ 4. http://www.cs.wustl.edu/~schmidt/ACE_wrappers/ACE.tar.gz
+ 5. file://localhost/.automount/tango/root/export2/project/doc/chris/ACE_wrappers/ACE-INSTALL.html
+ 6. file://localhost/.automount/tango/root/export2/project/doc/chris/ACE_wrappers/TAO/TAO-INSTALL.html#makenotes
+ 7. file://localhost/.automount/tango/root/export2/project/doc/chris/ACE_wrappers/TAO/TAO-INSTALL.html#makenotes
+ 8. file://localhost/.automount/tango/root/export2/project/doc/chris/ACE_wrappers/TAO/TAO-INSTALL.html#makenotes
+ 9. http://www.cs.wustl.edu/~schmidt/TAO.html
diff --git a/TAO/Makefile b/TAO/Makefile
index 05970883f13..b17aaf387af 100644
--- a/TAO/Makefile
+++ b/TAO/Makefile
@@ -44,6 +44,8 @@ clone:
done
RELEASE_FILES = TAO/ChangeLog \
+ TAO/INSTALL \
+ TAO/TAO-INSTALL.html \
TAO/COPYING \
TAO/COPYING.sun \
TAO/docs \
@@ -57,6 +59,9 @@ RELEASE_FILES = TAO/ChangeLog \
TAO/tests \
TAO/VERSION
+INSTALL: TAO-INSTALL.html
+ lynx -dump $^ > $@
+
#### If creating the "official" TAO release:
#### 1) Check that the workspace is up-to-date, and bail out if not.
#### 2) Update the timestamp in the VERSION file.
@@ -103,12 +108,12 @@ endif
FILTER = -name CVS -prune -o ! -name '.\#*' ! -name '\#*' ! -name '*~' -print
-cleanrelease:
+cleanrelease: INSTALL
@$(TIMESTAMP) (make realclean; cd ..; \
find $(RELEASE_FILES) $(FILTER) | cpio -o -H tar | gzip -9 > TAO.tar.gz; \
chmod a+r TAO.tar.gz; )
-release:
+release: INSTALL
@$(TIMESTAMP) (cd ..; \
find $(RELEASE_FILES) $(FILTER) | cpio -o -H tar | gzip -9 > TAO.tar.gz; \
chmod a+r TAO.tar.gz; )
diff --git a/TAO/TAO-INSTALL.html b/TAO/TAO-INSTALL.html
index 6c92bda8c29..e1cb22273f2 100644
--- a/TAO/TAO-INSTALL.html
+++ b/TAO/TAO-INSTALL.html
@@ -39,7 +39,7 @@ undefined and most likely unpredictable and erroneous results. <P>
<UL>
<li>Change directory to <code>$ACE_ROOT/ace</code> and execute
- <code>make</code>.</li> <P>
+ <code><a href="#makenotes">make</a></code>.</li> <P>
</UL>
<li>Set <code>TAO_ROOT</code> environment variable to
@@ -49,17 +49,28 @@ undefined and most likely unpredictable and erroneous results. <P>
<UL>
<li>Change directory to <code>$TAO_ROOT/tao</code> and
- execute <code>make</code>.</li> <P>
+ execute <code><a href="#makenotes">make</a></code>.</li> <P>
</UL>
<li>Change directory to <code>$TAO_ROOT/tests</code> and
- execute <code>make</code>.</li> <P>
+ execute <code><a href="#makenotes">make</a></code>.</li> <P>
<li>Follow instructions on executing the various examples under
<code>$TAO_ROOT/tests</code>.<P>
</ol>
+ <h4><strong><a name="makenotes">A Note On Make</a></strong></h4>
+ <p>
+ Since TAO is built atop ACE, TAO re-uses ACE's Makefile
+ structure as well. Thus, just like ACE requires GNU Make, so
+ too does TAO. More exactly, versions of <code>make</code> which
+ are known to <em>not</em> work include those from Solaris 4.x
+ and 5.x, HP-UX, the latest BSD, etc.
+ <p>
+ GNU Make can be obtained from various places in source form.
+
+
<HR><P>
<H3>On Windows NT</H3>