plsqldoc bug?

[YikeSS]

The following source:
CREATE OR REPLACE TYPE test IS OBJECT (
-- test object type
-- %param field1 Test field1
-- %param field2 Test field2
-- %param type Test type
-- %param field3 Test field3
field1 VARCHAR2(10),
field2 NUMBER(2),
type VARCHAR2(60),
field3 VARCHAR2(30)
)

Generates this result:

Attributes
field1
field2
VARCHAR2
field3

field1
field1 VARCHAR2(10)

field2
field2 NUMBER(2)

VARCHAR2
type VARCHAR2(60)

field3
field3 VARCHAR2(30)

Any idea?

Thanx.

 

[Marco Kalter]

The %param tag can be used for functions and procedures. If you want to document attributes of a type, you should specify this:

CREATE OR REPLACE TYPE test IS OBJECT (
-- Comment for test object type

-- Comment for field1
field1 VARCHAR2(10),

-- Comment for field2
field2 NUMBER(2),

-- Comment for field3
field3 VARCHAR2(30)
)

 

[YikeSS]

Ok. Thanks!