gcc/LANGUAGES

   1 Right now there is no documentation for the GCC tree -> rtl interfaces
   2 (or more generally the interfaces for adding new languages).
   3
   4 Such documentation would be of great benefit to the project.  Until such
   5 time as we can formally start documenting the interface this file will
   6 serve as a repository for information on these interface and any incompatable
   7 changes we've made.
   8
   9 2001-02-26:
  10   A DECL_INITIAL of NULL_TREE or error_mark_node in a VAR_DECL is no longer
  11   taken to signify a tentative definition which should not be emitted until
  12   end-of-file.  Frontends which want that behavior should set
  13   DECL_DEFER_OUTPUT before calling rest_of_decl_compilation.
  14
  15 Feb 1, 1998:
  16
  17   GCC used to store structure sizes & offsets to elements as bitsize
  18   quantities.  This causes problems because a structure can only be
  19   (target memsize / 8) bytes long (this may effect arrays too).  This
  20   is particularly problematical on machines with small address spaces.
  21
  22   So:
  23
  24     All trees that represent sizes in bits should have a TREE_TYPE of
  25     bitsizetype (rather than sizetype).
  26
  27     Accordingly, when such values are computed / initialized, care has to
  28     be takes to use / compute the proper type.
  29
  30     When a size in bits is converted into a size in bytes, which is expressed
  31     in trees, care should be taken to change the tree's type again to sizetype.
  32
  33 ?? 1997:
  34
  35   In an effort to decrease cache thrashing and useless loads we've changed the
  36   third argument to the DEFTREECODE macro to be a single char.  This will
  37   affect languages that defined their own tree codes (usually in a .def file).
  38
  39   Old way:
  40
  41     DEFTREECODE (CLASS_METHOD_DECL, "class_method_decl", "d", 0)
  42
  43   New way:
  44
  45     DEFTREECODE (CLASS_METHOD_DECL, "class_method_decl", 'd', 0)