diff options
Diffstat (limited to 'TAO/tests/IDL_Test/README')
-rw-r--r-- | TAO/tests/IDL_Test/README | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/TAO/tests/IDL_Test/README b/TAO/tests/IDL_Test/README new file mode 100644 index 00000000000..9165d90c57e --- /dev/null +++ b/TAO/tests/IDL_Test/README @@ -0,0 +1,54 @@ +// $Id$ + +// ============================================================================ +// +// = LIBRARY +// TAO/tests/IDL_Test +// +// = FILENAME +// README +// +// = AUTHOR +// Jeff Parsons <j.parsons@vanderbilt.edu> +// +// ============================================================================ + +This test is a collection of IDL files that once caused IDL compiler +or C++ compiler errors, plus a dummy main.cpp for the build. There is +no execution check in this test, the only outcome of interest being +the build. The examples in the IDL files come from many sources - some +are made from scratch, some are adapted from other tests, and some are +adapted from examples sent in by ACE and/or TAO users. To all of these +last, many thanks for your help in digging out these bugs! + +Each IDL file contains examples that are related, either by the IDL +type involved or by the context in which the error occurs. As new bugs +are uncovered and fixed, new examples will be added to the suite, to +ensure that the bugs do not recur. + +The -GA option has been added to the IDL compiler command line. This +option generates the implementations of type codes and Any +insertion/extraction operators in a separate file with the +extension *A.cpp. These files have been added to the build, to make +sure that the option functions correctly for all the IDL types +found in this test. If the client or server does not use type codes +or Anys, these files may be left out of the compilation. This +feature is tested in TAO_ROOT/tests/Hello. + +The IDL compiler command line options -GC -GH and -Gd have also been added. +They switch on generation, respectively, of extra code for Asynchronous +Method Invocation (AMI), Asynchronous Method Handling (AMH) and direct +collocation of invocations (bypassing the POA and using a simple C++ +method call). By adding these options we can test for correct code +generation for every IDL interface found in this test. + +To build the test files, type 'make' at the command line. The TAO IDL +compiler will open each IDL file in the directory and generate code +that will then be compiled by the C++ compiler on your platform. + +To run the test, type 'main' at the command line. The generation of +correct IOR prefixes in pragma.idl is checked in the body of main(). +The rest of the .idl files need only to build cleanly. To test the +client/server functionality of the various IDL types and operations, +see the test suite in ACE_wrappers/TAO/tests/Param_Test. + |