There is a problem with @var/constant/type tags. They are working only in one scenario - if they are grouped together by tag name.
For example:
/**
* @type g_table_type A test table type
* @type g_table_type2 A test table type
*/
will work, but this won't work as expected:
/**
* @type g_table_type A test table type
*/
type g_table_type is table of pls_integer index by varchar2(30);
/**
* @type g_table_type2 A test table type
*/
type g_table_type2 is table of pls_integer index by varchar2(30);
Same situation is with variables and constants. Variables and constants are not so critical, but type definitions may be quite large, so logically, header comment should be above the type it refers to.
There is a problem with @var/constant/type tags. They are working only in one scenario - if they are grouped together by tag name.
For example:
will work, but this won't work as expected:
Same situation is with variables and constants. Variables and constants are not so critical, but type definitions may be quite large, so logically, header comment should be above the type it refers to.