Changeset 1565

Show
Ignore:
Timestamp:
07/31/08 19:39:58 (4 months ago)
Author:
Chuck.Esterbrook
Message:

Added more notes on C# code gen.

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • cobra/trunk/Developer/ImplementationNotes.text

    r1563 r1565  
    251251                localName = '_lh_event_[.serialNum]' 
    252252 
     253.writeSharpDef means "write C# definition" and is the main "driver" of spewing out the C# source code. The various properties such as .sharpRef are used, potentially from other places like when a .writeSharpDef implementation invokes _expr.type.sharpRef. 
     254 
     255An implementation of .writeSharpDef will invoke that same method name on its subobjects. 
     256 
     257.sharpRef means "a C# reference to the receiver" which often means a qualified name (Foo.Bar.Baz), possibly even prefixed with "global::", so C# doesn't get confused. 
     258 
     259Other .sharpFoo properties have various purposes and you'll have to poke around to see how they're used. 
     260 
     261If you have to refer to something in the generated code (as opposed to writing out its definition), default to .sharpRef unless you have an explicit reason not to. 
     262 
    253263 
    254264.h2 @ Run phase