S A N K H Y A

Copyright (c) 2002 Sankhya Technologies Private Limited.
All rights reserved.

SANKHYA Varadhi: Development Notes for using SANKHYA Varadhi for Cygwin
=======================================================================

   SANKHYA Varadhi has been ported to Cygwin x86 native on Windows NT/2000.
   Applications can be developed using SANKHYA Varadhi for Cygwin x86 native
   target on Windows NT/2000 using g++ 2.95.2 and above.

   The development tools provided with SANKHYA Varadhi on Windows NT/2000
   are native Win32 executables.

Pre-requisites

   Cygwin environment should be setup before using SANKHYA Varadhi. Path 
   to 'g++' should be added to PATH variable before using SANKHYA Varadhi for
   creating Varadhi platforms and developing applications. 

   a. Cygwin x86 native target

      Host               : x86 PC
      Host OS            : Windows NT/2000
      Target             : x86
      Target Environment : Cygwin on NT
      Tools              : Cygwin on NT, and GNU g++ 2.95.2 and above

      Note:

         The SANKHYA Varadhi IDL compiler, idlc, shipped with SANKHYA
         Varadhi 1.1B version on Windows NT/2000 requires "cl", the Microsoft
         VC++ compiler for preprocessing. A patch release of 'idlc' that
         uses Cygwin's preprocessor is available. Contact support@sankhya.com
         for the patch.

Using Varadhi for Cygwin:

   Refer to the main samples README in %VARADHI%\samples directory to setup
   Varadhi Target Platform, to build and execute the demos. The steps mentioned
   in the README file are same for Cygwin except (3) "Create a Varadhi Target
   Platform" and (6) "Build the demo program". The steps for creating a Varadhi
   Target Platform for Cygwin native development on Windows, and to build
   demo programs are given below.


   1. Create a Varadhi Target Platform for Cygwin.
 
      Varadhi can be customized for a particular target configuration using
      vconf. SANKHYA Varadhi configuration files are provided under
      %VARADHI%\etc\config directory to create various Varadhi Target
      Platforms.

      For example, to create a default platform for Cygwin on Windows,
      that supports C++ Exception, use the following.

      1.a    Change directory to your workspace.

             In Windows Command Prompt

                C:\> cd %WORK_DIR%

      1.b    Invoke vconf with two config files, one providing configuration
             options for the ORB and another one that specifies the target
             platform.

             In Windows Command Prompt

                %WORK_DIR%\> vconf defaults cygwin-gcc

             The configuration that is built with 'defaults' configuration
             file enables C++ Exception support.  

   2.  Build the demo program

       For Cygwin, a makefile is provided for building the demo application
       using g++ on Windows host.

       To build the demo program for Cygwin on Windows NT/2000, change
       directory to a particular demo directory and type "make".

       For example,

       In Windows Command Prompt

          %WORK_DIR%\> cd adder
          %WORK_DIR%\adder\> make

Limitations:

     * Due to a name clash between except.h and Cygwin header file for 
       'minor', compilation error will occur if sys/sysmacros.h gets
       included before Varadhi header file corba.h. This occurs in
       the following demos.

           - hostserver
           - any
           - chat

       The workaround is to include the stub/skeleton header file before
       including any other system header files.