BLIde IDE

Development notes and ideas

Intellisense on extended types and bbdoc

Current BLIde version integrates an automatic intelliprompt for types overloading inherited methods and functions. While this is has been one of the greatest improvements BLIde has gained in the past months (in my honest opinion), it was lacking on something…  Inheritance of documentation.

Next BLIde version will also inherit automatically the bbdoc information of the overloaded method or function, so methods and functions are kept always on its common/all tab when using intelliprompt, and also, the maintenance of the code is easier, as it is (sometimes) automatically documented.

As an example, when I’m writing this:

Type MyClass Extends TList
    Method AddFi
End Type

BLIde brings the intelliprompt window, and if I select Addfirst, BLIde will automatically add this code:

Type MyClass Extends TList
   Rem
      bbdoc:Add an object to the start of the list
   End Rem
   Method AddFirst:TLink( value:Object )

   End Method
End Type

The inheritance of documentation is done from the direct parent class until a overloading super class providing an implementation of the given class is found. Then, documentation is inherited if available. Otherwise, the method or function is considered undocumented and no bbdoc statement is added.
That means that documentation chain can be broken and re-implemented at any point of the genealogical class tree, and BLIde will understand it and handle it accordingly.

Advertisement

August 2, 2009 - Posted by | BLIde design notes

No comments yet.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Connecting to %s

Follow

Get every new post delivered to your Inbox.