plsqldoc link to procedure in package body/definition

[Stephan Schielke]

Hello!

Im using plsqldoc 1.2.0 with oracle 10g and pl/sql developer 8.0.4.

I need to set a {link} from the package body to the package definition. There are two files.

The p_utilities.imp:
CREATE OR REPLACE PACKAGE BODY p_utilities...

and the p_utilities.def:
CREATE OR REPLACE PACKAGE p_utilities...

In the def are the method headers and in the imp are the bodies of these methods. Only the method headers are documented to avoid a double and error-prone documentation. I would like to set a link from the imp part to the def part with:

{%link p_utilities.methodname}

This link jumps to the method body procedure instead of the documented header procedure.

Is there a way to differentiate between imp and def like:
{%link p_utilities.def.methodname}
{%link p_utilities.imp.methodname}?

with kind regards
Stephan Schielke

By the way:
Will there be a new version of plsqldoc?

 

[Marco Kalter]

Do you have documentation in both the package specification and body? I would expect you either use one or the other for documentation.

 

[Stephan Schielke]

The documentation is only in the def.
But when iam developing im most of the time in the imp files.
I wanted a link to the def files.

Now {%link p_utilities.methodname} works.
I guess it was an usage problem.

---

The nested functions are documented but wont appear in the generated html. Are nested functions supported?

PROCEDURE name_of_method AS
...
/** text text text */
FUNCTION nested_function(...
BEGIN
...
END
BEGIN
...