Book a Demo

Author Topic: BUG?: Class Notes RTE - can it work?  (Read 1942 times)

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8626
  • Karma: +259/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
BUG?: Class Notes RTE - can it work?
« on: November 23, 2006, 05:59:00 am »
In a related topic [size=13]RTE VBA[/size] I discuss some changes to the Visual Basic Code Generation Templates to provide some support for MS Office VBA.

Following that initial success, yet again, I fell foul of EA's UI (Unique Interface).

I've spent a few hours trying to get EA to add some comments for the Notes portion of a Class to the source code.

It would appear that such comments ONLY get generated and synchronised on the FIRST access.  That is, it can only be done ONCE - either on the way in if the file exists or on the way out if the file doesn't.  Commentary preceding an Operation and trailing an Attribute seem to round-trip OK.

This experience is only for the Visual Basic Language setting.  Is this true for all languages?

Has anybody successfully RTE'd Class level Note comments in other languages?

TIA,
Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Eve

  • EA Administrator
  • EA Guru
  • *****
  • Posts: 8110
  • Karma: +119/-20
    • View Profile
Re: BUG?: Class Notes RTE - can it work?
« Reply #1 on: November 23, 2006, 01:28:08 pm »
This is basically just a VB thing.  Because of the way VB syntax and the VB editor works EA generates class notes to a place where it can't really recognise as class notes when parsing.

For almost1 all other languages the comment immediate preceding the class declaration is imported as the class notes.  If you had a comment immediately before the class declaration for VB it should import, but won't be able to see it in the editor.

1 If you're interested the exception is Python where there is the documentation string.