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.
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.