Having trouble generating documentation from plsqldoc

bazaru

Member
Can anyone out there point me to perhaps why my documentation is not generating properly using plsqldoc?

I have just started using it and started out with a dummy procedure as follows in which I copied the comments verbatim from the plsqldoc user's guide just to make sure that I was not doing anything wrong:

CREATE OR REPLACE PROCEDURE testit(p_empno in number default 0, p_nowait in number default 0)
AS
-- Lock the emp record.
-- #param p_empno The number of the emp record.
-- #param p_nowait Indicates whether or not the procedure should wait
-- for other locks to be released.
ncount NUMBER;
BEGIN
SELECT COUNT(*) INTO ncount FROM dual;
EXCEPTION
WHEN OTHERS THEN
NULL;
END testit;

This generates the following output:

Procedure testit

PROCEDURE testit(p_empno IN NUMBER DEFAULT 0
,p_nowait IN NUMBER DEFAULT 0)

Lock the emp record.

Parameters
p_empno
p_nowait

You will notice that the text for the parameters is not generated and if I add any other tags to the comments, then they are not generated as well.

Thank you in advance for your help.
 
Back
Top