TAO/TAO_IDL/docs/historical/CHANGES

   1 CHANGES WHICH AFFECT BE WRITERS
   2 -=============================-
   3
   4 INTRODUCTION
   5
   6 This file describes changes that affect BE writers. It contains IMPORTANT
   7 INFORMATION for BE writers who wish to migrate a BE written to operate with
   8 release 1.2 to operate with release 1.3. It is likely that not following
   9 these instructions will result in a compilable but malfunctioning compiler.
  10
  11 AST INHERITANCE CHANGES
  12
  13 The AST has been reorganized so that AST_Union and AST_Exception now
  14 inherit from AST_Structure. This means that constructors of BE classes
  15 which inherit from AST_Union or AST_Exception now need to explicitly call
  16 an initializer for AST_Structure in their init section.
  17
  18 We repeat below the information given in the file WRITING_A_BE, in the
  19 section entitled "WRITING A BE".
  20
  21 AST_EXCEPTION
  22
  23 The signature for constructors of classes inheriting from AST_Exception
  24 should now be:
  25
  26         BE_Exception::BE_Exception(UTL_ScopedName *n,
  27                                    UTL_StrList *p)
  28                     : AST_Decl(AST_Decl::NT_except, n, p),
  29                       AST_Structure(AST_Decl::NT_except, n, p),
  30                       UTL_Scope(AST_Decl::NT_except)
  31
  32 AST_UNION
  33
  34 The signature for constructors of classes inheriting from AST_Union should
  35 now be:
  36
  37         BE_Union::BE_Union(AST_ConcreteType *dt,
  38                            UTL_ScopedName *n,
  39                            UTL_StrList *p)
  40                 : AST_Union(dt, n, p),
  41                   AST_Structure(AST_Decl::NT_union, n, p),
  42                   AST_Decl(AST_Decl::NT_union, n, p),
  43                   UTL_Scope(AST_Decl::NT_union)
  44
  45 IDL_BOOL TYPE
  46
  47 To increase portability and reduce dependency of the sources on POSIX
  48 compliance in targets of ports, IDL now provides its own boolean type which
  49 is named idl_bool. It provides two truth values, I_TRUE and I_FALSE.
  50
  51 UTL_SCOPEDNAME TYPE
  52
  53 The UTL_ScopedName type is now a list of Identifier nodes; in previous
  54 releases it used to be a list of String nodes. If your BE constructs scoped
  55 names this change will prevent recompilation until you modify your
  56 constructor calls to invoke constructors for Identifier instead of for
  57 String. The signature of the constructor is:
  58
  59         Identifier::Identifier(char *, long x=1, long y=0, long z=I_FALSE)
  60
  61 The additional arguments which can be defaulted to the values indicated are
  62 included for future use.
  63
  64 COPYRIGHT
  65
  66 Copyright 1992, 1993, 1994 Sun Microsystems, Inc.  Printed in the United
  67 States of America.  All Rights Reserved.
  68
  69 This product is protected by copyright and distributed under the following
  70 license restricting its use.
  71
  72 The Interface Definition Language Compiler Front End (CFE) is made
  73 available for your use provided that you include this license and copyright
  74 notice on all media and documentation and the software program in which
  75 this product is incorporated in whole or part. You may copy and extend
  76 functionality (but may not remove functionality) of the Interface
  77 Definition Language CFE without charge, but you are not authorized to
  78 license or distribute it to anyone else except as part of a product or
  79 program developed by you or with the express written consent of Sun
  80 Microsystems, Inc. ("Sun").
  81
  82 The names of Sun Microsystems, Inc. and any of its subsidiaries or
  83 affiliates may not be used in advertising or publicity pertaining to
  84 distribution of Interface Definition Language CFE as permitted herein.
  85
  86 This license is effective until terminated by Sun for failure to comply
  87 with this license.  Upon termination, you shall destroy or return all code
  88 and documentation for the Interface Definition Language CFE.
  89
  90 INTERFACE DEFINITION LANGUAGE CFE IS PROVIDED AS IS WITH NO WARRANTIES OF
  91 ANY KIND INCLUDING THE WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS
  92 FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR ARISING FROM A COURSE OF
  93 DEALING, USAGE OR TRADE PRACTICE.
  94
  95 INTERFACE DEFINITION LANGUAGE CFE IS PROVIDED WITH NO SUPPORT AND WITHOUT
  96 ANY OBLIGATION ON THE PART OF Sun OR ANY OF ITS SUBSIDIARIES OR AFFILIATES
  97 TO ASSIST IN ITS USE, CORRECTION, MODIFICATION OR ENHANCEMENT.
  98
  99 SUN OR ANY OF ITS SUBSIDIARIES OR AFFILIATES SHALL HAVE NO LIABILITY WITH
 100 RESPECT TO THE INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY
 101 INTERFACE DEFINITION LANGUAGE CFE OR ANY PART THEREOF.
 102
 103 IN NO EVENT WILL SUN OR ANY OF ITS SUBSIDIARIES OR AFFILIATES BE LIABLE FOR
 104 ANY LOST REVENUE OR PROFITS OR OTHER SPECIAL, INDIRECT AND CONSEQUENTIAL
 105 DAMAGES, EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 106
 107 Use, duplication, or disclosure by the government is subject to
 108 restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in
 109 Technical Data and Computer Software clause at DFARS 252.227-7013 and FAR
 110 52.227-19.
 111
 112 Sun, Sun Microsystems and the Sun logo are trademarks or registered
 113 trademarks of Sun Microsystems, Inc.
 114
 115 SunSoft, Inc.
 116 2550 Garcia Avenue
 117 Mountain View, California  94043
 118
 119 NOTE:
 120
 121 SunOS, SunSoft, Sun, Solaris, Sun Microsystems or the Sun logo are
 122 trademarks or registered trademarks of Sun Microsystems, Inc.