PLSQLDoc and strict comments

[dcurley]

Hi,

I'm having trouble getting strict comments to work in a package. Between the spec and the body, the only place they seem to be recognized is immediately preceding a program unit.

/** comments are ignored after the create package & create package body statements.

Also, I can't seem to use /** %param. The synopsis becomes the param text, but it is also picked up correctly in the program unit section:

Program units
priv %param dtp The date you want to return

priv
FUNCTION priv(dtp IN DATE) RETURN DATE
Parameters
dtp The date you want to return

Any suggestions?

Thanks,
Dave

 

[Marco Kalter]

Strict comments works fine for me. Can you send me a complete example where this fails?

This first comment line is indeed always interpreted as the description of the element. Right now you will have to add such a line. We'll fix this.

 

[dcurley]

I've been playing around and I think my earlier problems were my getting confused around the effect of a period in the comment before a program element and having a mix of /** and -- comments. I've created a new package that I've been testing with and think I have it worked out.

Sorry to have bothered you with this one,
Dave