ABAP Doc for redefined methods

[Former Member]

Hi AiE development Team,

today i recognized that it is not possible to define ABAP Doc comments for redefined methods.

Short questions, why?

I would see it as very usefull, because

- in the super class i can describe the common purpose of the method

- in the sub class i can describe the concrete behaviour

Do you agree?

Cheers

Eugen

[ThFiedler]

Hi Eugen,

why don't you describe the concrete behavior of the redefintion in the method implementation?

Regards,

Thomas.

[Former Member]

Hi Thomas,

my idea behind is, to be able to print the specific behaviours of sub class as well.

specially with regard to your comming ABAP Doc feature, which will allow to print the doc comments within HTML, comments withint the implementation wouldn't be considered, right?

Regards,

Eugen

[ThFiedler]

Hi Eugen,

what about an ABAP Doc section on top of the method implementation statement?

When we offer this we can also include this feature in the generation of HTML documents.

In addition to that it can also solve the issue that currently comments within method implmentations are not allowed in AIE. (I know one member of the community who would say YES, now )

And it is also useable for interface method implementations. Also on the long wishlist of some customers.

Regards,

Thomas.

[Former Member]

Hi Thomas,

well, this will solve the issue but honestly i don't realy like it.

This solution would mean that parts of documentation are placed within the definition part and implementation, so two different palces to find documentation if you are in the code.

And indipendent of the printing purposes, how will you decide which abap doc comments should be displayed with the F2 key within cosnumers of Sub classes, if parts are in the implementation part? (Hope this was understandable 🙂 )

Can't you simply overwrite the abab doc comments if redifintions in sub classes exist?

I know you have much more important functions to support yet, so please see this discussion just as possible proposal.

Also without this i love AiE 😉

Cheers,

Eugen

A short additional comment: During the documentation of my application, i recognized that the abap doc stament in my super class of the abstract method are neither considered by the F2 key nor in the printing funtion. Indepented whether i'm in the super or sub class. (Maybe a bug?)

Actual AiE Version: 2.36 on Kepler

NW: 7.4 SP8

Message was extended by: Eugen