summaryrefslogtreecommitdiff
path: root/CIAO/tools/IDL3_to_IDL2/README
diff options
context:
space:
mode:
Diffstat (limited to 'CIAO/tools/IDL3_to_IDL2/README')
-rw-r--r--CIAO/tools/IDL3_to_IDL2/README128
1 files changed, 0 insertions, 128 deletions
diff --git a/CIAO/tools/IDL3_to_IDL2/README b/CIAO/tools/IDL3_to_IDL2/README
deleted file mode 100644
index 3f3672c2115..00000000000
--- a/CIAO/tools/IDL3_to_IDL2/README
+++ /dev/null
@@ -1,128 +0,0 @@
-
- IDL3 To IDL2 Converter
-
-A pluggable back end used with the IDL compiler parser
-and command line processor, this tool converts CCM-related
-IDL constructs into their corresponding IDL2 equivalents,
-in a new IDL file. For more information about CIAO and the CIAO
-CIDL compiler, please see
-
-$CIAO_ROOT/docs/releasenotes/index.html
-
-COMPILING:
-
-Use the provided .mpc file to generate a project or makefile to
-compile the pluggable back end library and the executable.
-Make sure the TAO IDL compiler front end is already built.
-
-EXECUTABLE NAME:
-
-tao_idl3_to_idl2
-
-COMMAND LINE OPTIONS:
-
-All the usual front-end command line options that apply to the IDL compiler
-(such as path includes) work with this tool as well, since the IDL compiler
-front end is simply reused. The options -? or -h will display a usage
-message, including both front end and back end options. For a complete
-list of IDL compiler command line options and a description of each, see
-TAO/docs/compiler.html.
-
-BACKEND OPTIONS:
-
--o <path> Also works the same as with the IDL compiler, setting the
-output directory, overriding the default, which is the directory of
-execution.
-
-CAVEAT:
-
-When using the TAO IDL compiler on files that are generated by this tool,
-use the command line option -Sm on the IDL compiler, which will disable
-the internal generation of equivalent IDL nodes in the AST. You'll notice
-from the example below that the only ones that remain are eventtypes.
-The -Sm option will prevent the IDL compiler from trying to create the
-corresponding xxxConsumer interface, which now already exists explicitly
-in IDL.
-
-EXAMPLE CONVERSION:
-
-
-// test.idl
-
-#include <Components.idl>
-
-interface Foo {};
-
-eventtype Ev {};
-
-component Bar
-{
- uses multiple Foo needs_foo;
- publishes Ev ev_pub;
-};
-
-home BarHome manages Bar
-{
-};
-
-
-Typing
-
-tao_idl3_to_idl2 -I<CIAO_ROOT>/ciao -I<TAO_ROOT> test.idl
-
-will generate
-
-
-
-// test_IDL2.idl
-
-#include "Components.idl"
-
-interface Foo {};
-
-eventtype Ev {};
-
-interface EvConsumer : Components::EventConsumerBase
-{
- void push_Ev (in Ev the_Ev);
-};
-
-interface Bar : Components::CCMObject
-{
- struct needs_fooConnection
- {
- Foo objref;
- Components::Cookie ck;
- };
-
- typedef sequence<needs_fooConnection> needs_fooConnections;
-
- Components::Cookie connect_needs_foo (in Foo connection)
- raises (Components::ExceededConnectionLimit, Components::InvalidConnection);
-
- Foo disconnect_needs_foo (in Components::Cookie ck)
- raises (Components::InvalidConnection);
-
- needs_fooConnections get_connections_needs_foo ();
-
- Components::Cookie subscribe_ev_pub (in EvConsumer consumer)
- raises (Components::ExceededConnectionLimit);
-
- EvConsumer unsubscribe_ev_pub (in Components::Cookie ck)
- raises (Components::InvalidConnection);
-};
-
-interface BarHomeExplicit : Components::CCMHome
-{
-};
-
-interface BarHomeImplicit : Components::KeylessCCMHome
-{
- Bar create ()
- raises (Components::CreateFailure);
-};
-
-interface BarHome : BarHomeExplicit, BarHomeImplicit
-{
-};
-