Provided by: orbit2_2.14.19-0.3_amd64 bug

NAME

       orbit-idl-2 - IDL compiler for ORBit2

SYNOPSIS

       orbit-idl-2 [ options ] file...

DESCRIPTION

       orbit-idl-2  converts  object  interface  descriptions  written  in  CORBA  IDL (Interface
       Definition Language) into C code that you can compile and link into your programs.

OPTIONS

       orbit-idl-2 accepts the following options:

       -d ARG
       --debug=ARG
              Set the debug level.  Supported levels are 0 to 4, default is 2.

       --idlwarnlevel=INT
              Set the warning level for compiler warnings.  Supported levels are 0 to 4,  default
              is 2.

       --showcpperrors
              Show errors from cpp(1).

       --small
              Optimize for size instead of speed.

       --oldstyle
              Use the old style IDL compiler (not generally recommended).

       --skeleton-impl
              Generate a skeleton-impl file.

       --nostubs
              Do not create the stubs file.

       --noskels
              Do not create the skels file.

       --nocommon
              Do not create the common file.

       --noheaders
              Do not create the headers file.

       --noidata
              Don't generate Interface type data.

       -i
       --imodule
              Generate only an imodule file (no skels, stubs, etc.).

       --add-imodule
              Generate  an  imodule file (as well as other files generated by default or by other
              options).

       --onlytop
              Inhibit file includes.

       --pidl Treat source as pseudo-IDL.

       -D ARG
       --define=ARG
              Define name for preprocessor.

       -I PATH
       --include=PATH
              Add search path for include files.

       --deps=FILENAME
              Generate dependency information, suitable for inclusion in a Makefile.

       -l ARG
       --lang=ARG
              Specify the output language.  The default is C.  Support for languages other than C
              requires the installation of a backend for that language.

       --backenddir=DIR
              Specify  the directory where a language backend is stored (not necessary if backend
              is stored in the default directory).

       --usage
              Print a very brief usage summary.

       -?
       --help
              Print a slightly more detailed usage summary.

       -v
       --version
              Print version number and serial.

COMPILING

       The IDL file(s) compiled by  orbit-idl-2  define  the  interfaces  to  network-transparent
       objects.   These  files are first passed to cpp(1), the C Preprocessor, then the result is
       parsed, and the C code is generated.

        By default, orbit-idl-2 generates four files, the stubs, skels, common, and header files.
       If your input file is named sample.idl, then the output files will be named, respectively,
       sample-stubs.c, sample-skels.c, sample-common.c, and sample.h.  You  can  optionally  also
       generate  a skeleton-impl file (which would be named sample-skelimpl.c in our example), or
       an imodule file (e.g. sample-imodule.c).  These files require manual editing to be useful,
       and is therefore not generated by default.

       The  generated  C  files  are  formatting ("pretty-printed") using indent(1).  You can use
       another program for this if you prefer, with the --c-output-formatter argument.

SEE ALSO

       orbit2-config(1),   cpp(1),   indent(1),    /usr/share/doc/liborbit2-dev,    http://orbit-
       resource.sourceforge.net, http://www.omg.org.

AUTHOR

       Copyright © 2001, 2002 Dick Porter <dick@acm.org> and Elliot Lee <sopwith@redhat.com>

       This  manual  was  originally written for orbit-idl by Chris Waters <xtifr@debian.org> for
       Debian GNU/Linux.