diff options
Diffstat (limited to 'TAO/docs/compiler.html')
| -rw-r--r-- | TAO/docs/compiler.html | 51 |
1 files changed, 23 insertions, 28 deletions
diff --git a/TAO/docs/compiler.html b/TAO/docs/compiler.html index 3c67ac8d5cd..581cbdc303e 100644 --- a/TAO/docs/compiler.html +++ b/TAO/docs/compiler.html @@ -38,20 +38,20 @@ these files:) <P> <UL> <LI> <B><EM>Client stubs</EM></B>, <EM>i.e.</EM>, <tt>*C.h</tt>, - <tt>*C.inl</tt>, and <tt>*C.cpp</tt>. Pure client applications + <tt>*C.i</tt>, and <tt>*C.cpp</tt>. Pure client applications only need to <code>#include</code> and link with these files. - <LI> <B><EM>Server skeletons</EM></B>, <EM>i.e.</EM>, <tt>*S.h</tt>, <tt>*S.inl</tt>, and + <LI> <B><EM>Server skeletons</EM></B>, <EM>i.e.</EM>, <tt>*S.h</tt>, <tt>*S.i</tt>, and <tt>*S.cpp</tt>. Servers need to <code>#include</code> and link with these files. - <LI> <B><EM>Server skeleton templates</EM></B>, <EM>i.e.</EM>, <tt>*S_T.h</tt>, <tt>S_T.inl</tt>, + <LI> <B><EM>Server skeleton templates</EM></B>, <EM>i.e.</EM>, <tt>*S_T.h</tt>, <tt>S_T.i</tt>, and <tt>*S_T.cpp</tt>. Some C++ compilers do not like template and non-template code in the same files, so TAO's IDL compiler generates these files separately. </UL> -TAO's IDL compiler creates separate <TT>*.inl</TT> and <TT>*S_T.*</TT> +TAO's IDL compiler creates separate <TT>*.i</TT> and <TT>*S_T.*</TT> files to improve the performance of the generated code. For example, -the <TT>*.inl</TT> files enable you to compile with inlining enabled or +the <TT>*.i</TT> files enable you to compile with inlining enabled or not, which is useful for trading-off compile-time and run-time performance. Fortunately, you only need to <CODE>#include</CODE> the client stubs declared in the <tt>*C.h</tt> file and the skeletons in @@ -327,9 +327,9 @@ also receives other options that are specific to it. <p> <td><tt>post_include=</tt><i>include_path</i></td> <td>The compiler will generate code to include <i>include_path</i> at the - bottom of the each header file. For example, ace/post.h, which pops - compiler options for the Borland C++ Builder and MSVC++ compilers, is - included in this manner in all IDL-generated files in the TAO libraries + bottom of the each header file. For example, ace/post.h, which pops + compiler options for the Borland C++ Builder and MSVC++ compilers, is + included in this manner in all IDL-generated files in the TAO libraries and CORBA services.</td> </tr> @@ -490,7 +490,7 @@ also receives other options that are specific to it. <p> <tr><a name="ci"> <td><tt>-ci</tt></td> - <td>Client inline file name ending. Default is "C.inl".</td> + <td>Client inline file name ending. Default is "C.i".</td> <td> </td> </tr> @@ -511,26 +511,26 @@ also receives other options that are specific to it. <p> <tr><a name="si"> <td><tt>-si</tt></td> - <td>Server inline skeleton file name ending. Default is "S.inl".</td> + <td>Server inline skeleton file name ending. Default is "S.i".</td> <td> </td> </tr> <tr><a name="st"> <td><tt>-st</tt></td> - <td>Server's template inline file name ending. Default is "S_T.inl".</td> + <td>Server's template inline file name ending. Default is "S_T.i".</td> <td> </td> </tr> <tr><a name="t"> <td><tt>-t</tt></td> - <td>Temporary directory to be used by the IDL compiler. + <td>Temporary directory to be used by the IDL compiler. </td> <td>Unix: use environment variable TEMPDIR if defined, else use /tmp/. - Windows 95/98/Me: use environment variable TMP or TEMP if defined + Windows 95/98/Me: use environment variable TMP or TEMP if defined and directory exists, else use current directory. Windows NT/2000/XP: - use environment variable TMP or TEMP if defined, else use the + use environment variable TMP or TEMP if defined, else use the Windows directory. </td> </tr> @@ -577,10 +577,10 @@ also receives other options that are specific to it. <p> will use native C++ exceptions. If the value of the flag is 1, tao_idl will generate code that will use the <CODE>CORBA::Environment</CODE> variable for passing exceptions. If the value of the flag is 2, the C++ 'throw' keyword will be used - in place of ACE_THROW_SPEC, ACE_THROW, and ACE_RETHROW (ACE_THROW_RETURN and - TAO_INTERCEPTOR_THROW will still be used). The default depends on how TAO_IDL - has been built. If TAO_IDL is built with native exceptions enabled, the IDL - compiler will not generate the emulated exception macros. If IDL compiler is + in place of ACE_THROW_SPEC, ACE_THROW, and ACE_RETRHOW (ACE_THROW_RETURN and + TAO_INTERCEPTOR_THROW will still be used). The default depends on how TAO_IDL + has been built. If TAO_IDL is built with native exceptions enabled, the IDL + compiler will not generate the emulated exception macros. If IDL compiler is built with native exceptions disabled, macros would be generated by default. </td> <td> </td> </tr> @@ -625,7 +625,7 @@ also receives other options that are specific to it. <p> <td>Generate type code and Any operator bodies in *A.cpp</td> <td>Decouples client and server decisions to compile and link - TypeCode- and Any-related code, which is generated in + TypeCode- and Any-related code, which is generated in *C.cpp by default.</td> </tr> @@ -734,16 +734,11 @@ also receives other options that are specific to it. <p> <td> </td> </tr> - <tr><a name="Sm"> - <td><tt>-Sm</tt></td> + <tr><a name="Sv"> + <td><tt>-Sv</tt></td> - <td>Suppress C++ code generation from CCM 'implied' IDL.</td> - <td>This code generation is achieved by default using a 'preprocessing' visitor - that modified the AST and is launched just before the code generating - visitors. There is a new tool in CIAO that converts the entire IDL file - into one containing explicit declarations of the implied IDL types. - For such a file, we don't want the preprocessing visitor to bve launched, - so this command line option will suppress it.</td> + <td>Suppress valuetype support.</td> + <td> </td> </tr> </table> <P> |