summaryrefslogtreecommitdiff
path: root/TAO/tests/IDL_Inherited_Operation/README
diff options
context:
space:
mode:
Diffstat (limited to 'TAO/tests/IDL_Inherited_Operation/README')
-rw-r--r--TAO/tests/IDL_Inherited_Operation/README41
1 files changed, 41 insertions, 0 deletions
diff --git a/TAO/tests/IDL_Inherited_Operation/README b/TAO/tests/IDL_Inherited_Operation/README
new file mode 100644
index 00000000000..2bde20e4f2a
--- /dev/null
+++ b/TAO/tests/IDL_Inherited_Operation/README
@@ -0,0 +1,41 @@
+/**
+
+@page IDL Inherited Operation Test README File
+
+ This test checks that an IDL compiler bug, fixed by
+
+ Fri Mar 20 16:04:58 UTC 2009 Jeff Parsons <j.parsons@vanderbilt.edu>
+
+ never gets re-introduced. The IDL declarations that caused the
+ original bug are:
+
+ - A base interface, with an operation, is declared inside 2
+ nested modules.
+ - The nested modules are closed.
+ - The nested modules are reopened, and forward declaration of
+ the base interface appears inside.
+ - The nested modules are closed.
+ - The outer module is reopened, and a derived interface
+ declaration appears inside, using the partially scoped
+ name of the base interface.
+
+ This type of IDL caused the base interface operation to be missing
+ from the operation table in generated code for the derived
+ interface. Client calls to this operation on a derived object
+ would result in a BAD_OPERATION exception.
+
+ The test is here instead of in the IDL_Test directory because
+ the bug can be detected only at runtime, by a remote call.
+ IDL_Test is designed to catch only:
+
+ - Error messages incorrectly caused by legal IDL
+ - Errors from incompilable generated code
+ - Incorrect repository IDs, fetched by a local stub call
+
+ To run the test use the run_test.pl script:
+
+$ ./run_test.pl
+
+ the script returns 0 if the test was successful.
+
+*/