Documentation generator for Forms 6i

Question

Does a tool exists to document the code on triggers and procedures in Forms 6i files? For every single form , a program unit called p_documents is created, with no code to write the documentation in comments .. something like this ..
Procedure p_documents is
begin
null;
/* sequence DATe Block/proced/lov item trigger description
1 03-17-08 b1 date1 when-validate-item the date can't be older than sysdate
2 03-25-02 b2 address key-next-item .... ......
3 p_new_data(prog. uni.) -- --- the value of :b2.days is set in null
end;
And then, i copy the respective lines on the program unit/trigger changed ..
procedure p_new_data is
begin
/* sequence DATe Block/proced/lov item trigger description
3 p_new_data(prog. uni.) -- --- the value of :b2.days is set in null
if :b1. date1 ...
end;
Everytime somebody changes the code in a form we just add another line to the program unit p_documents and we have to update the comments on the trigger/program unit. It takes a lot of time. Can anyone suggest any better ideas, solutions, tools?
Thanks :D
Edited by: user12422762 on 22-abr-2010 11:54
Edited by: user12422762 on 22-abr-2010 11:57

Answer 1

If you simply want to copy your comments code you could create a routine with the Open API for this which copies your comments of your source code
http://www.oracle.com/webapps/online-help/forms/10g/topics/f1_help/openapi/f50abopena.html
(in 6i you'll have to write C code; in 10g you could write this using JDAPI in Java).
If I get you right there is a program unit called p_documents which only consists of the program unit headers and their comments?
If so you could loop over your program units etc., take the comments from there and dynamically create your p_document procedure. After a change is made to a procedure just start your OpenAPI Program for your fmb and generate the p_document procedure using the information of the other program units (as you are using subversion you could do this in a PRE-COMMIT client hook script if you are using TortoiseSVN 1.6+ so you can't forget this).
Why you want to do this? Do you want to have a documentation for your forms procedures available in one place? If so: you might give FoReDoclet a shot: http://foredoclet.sourceforge.net/
cheers