diff options
-rw-r--r-- | TAO/ChangeLog-98c | 13 | ||||
-rw-r--r-- | TAO/INSTALL | 95 | ||||
-rw-r--r-- | TAO/Makefile | 9 | ||||
-rw-r--r-- | TAO/TAO-INSTALL.html | 17 |
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> |