Next release schedule
- Thread starter Bergeroy
- Start date
The plsqldoc enhancements are independant of PL/SQL Developer releases. We have a new plsqldoc release planned in 1 or 2 weeks. Which enhancements are you looking forward to?
------------------
Marco Kalter
Allround Automations
------------------
Marco Kalter
Allround Automations
Hi,
Here are the enhancements we're waiting for ?
- Type commenting (see http://www.allroundautomations.com/ubb/Forum3/HTML/000391.html )
- tag (see http://www.allroundautomations.com/ubb/Forum3/HTML/000396.html )
- Cross-reference problems solved (see ttp://www.allroundautomations.com/ubb/Forum3/HTML/000392.html )
[This message has been edited by Bergeroy (edited 23 October 2003).]
Here are the enhancements we're waiting for ?
- Type commenting (see http://www.allroundautomations.com/ubb/Forum3/HTML/000391.html )
- tag (see http://www.allroundautomations.com/ubb/Forum3/HTML/000396.html )
- Cross-reference problems solved (see ttp://www.allroundautomations.com/ubb/Forum3/HTML/000392.html )
[This message has been edited by Bergeroy (edited 23 October 2003).]
Hi,
We just installed the last plsqldoc version (1.1.4) and some problems noticed before seem to be always there:
- tag (see http://www.allroundautomations.com/ubb/Forum3/HTML/000396.html ). There is always a
generated on the line before the one that contains a tag. It seems to me that those
should be generated only inside the tags if needed. As of current, it breaks the paragraphs dispositions when they contains only few words between tags. It should work as javadoc.
- Cross-reference problems (see ttp://www.allroundautomations.com/ubb/Forum3/HTML/000392.html ). I've got several inter-related type definitions and its not showed in the HTML generated pages (the types doesn't appear as hyperlink). Also, the packages that contains variables defined with these types do not appear as hyperlinks.
Is there another soon to be released version of plsqldoc that corrects those problems ?
Thank you
We just installed the last plsqldoc version (1.1.4) and some problems noticed before seem to be always there:
- tag (see http://www.allroundautomations.com/ubb/Forum3/HTML/000396.html ). There is always a
generated on the line before the one that contains a tag. It seems to me that those
should be generated only inside the tags if needed. As of current, it breaks the paragraphs dispositions when they contains only few words between tags. It should work as javadoc.
- Cross-reference problems (see ttp://www.allroundautomations.com/ubb/Forum3/HTML/000392.html ). I've got several inter-related type definitions and its not showed in the HTML generated pages (the types doesn't appear as hyperlink). Also, the packages that contains variables defined with these types do not appear as hyperlinks.
Is there another soon to be released version of plsqldoc that corrects those problems ?
Thank you
I was sure that the bug was fixed, but apparently it's not. We'll fix it again and will release a new patch.
We have not been able to reproduce the cross reference bug.
We have not been able to reproduce the cross reference bug.
Hi,
Here is a simple test case for the cross-reference bug with 1.1.4 version of plsqldoc.
First, create that type:
Then, this one:
My generation options are:
- Search cross-references: global
- Subdirectories: Database and Owner
- Object name prefix: none
- Filename prefixe: none
After generation, the generated HTML for TEST_TYPE_DEF contains no references toward TEST_TYPE_ABC as it should.
I hope you will be able to reproduce this situation at your test site.
Here is a simple test case for the cross-reference bug with 1.1.4 version of plsqldoc.
First, create that type:
Code:
create or replace type
/** Comment for TEST_TYPE_ABC */
TEST_TYPE_ABC as table of varchar2(10);
Code:
create or replace type TEST_TYPE_DEF as object
/** Comment for TEST_TYPE_DEF */
(
/** Comment for TEST_TYPE_DEF.DEF */
DEF TEST_TYPE_ABC
);- Search cross-references: global
- Subdirectories: Database and Owner
- Object name prefix: none
- Filename prefixe: none
After generation, the generated HTML for TEST_TYPE_DEF contains no references toward TEST_TYPE_ABC as it should.
I hope you will be able to reproduce this situation at your test site.
It works just fine for me. I duplicated your settings, created the 2 types, generated documentation for TEST_TYPE_ABC, and then for TEST_TYPE_DEF. The 2nd one contains a link to the first one.
Hi,
On what base does plsqldoc generates the link ?
Does it scan all the previous generated HTML files or does it keep in memory a table of some kind ?
Does the directory names that keep the generated files have some importance ?
In fact, what could cause the problem ?
Thank you
On what base does plsqldoc generates the link ?
Does it scan all the previous generated HTML files or does it keep in memory a table of some kind ?
Does the directory names that keep the generated files have some importance ?
In fact, what could cause the problem ?
Thank you
I'm using the exact same Plug-In version. The link is created based on the contents of the files. Can you zip your documentation directory with this example and send it to me?
I don't think I received that. Can you re-send it?
Sorry for the lack of feedback. I have received the zip file and will look into it shortly.
Sorry for the lack of feedback. The problem is that we have not been able to reproduce the issue. It's a bit of a mystery...
Hi Marco,
With your previous post, do you mean that you took my documentation directory as it is, that you ran plsqldoc over every objects and that you got all those objects cross-referenced ? If it's so, I must ask you again which version of plsqldoc your are using and also what are your configuration options.
Thank you
With your previous post, do you mean that you took my documentation directory as it is, that you ran plsqldoc over every objects and that you got all those objects cross-referenced ? If it's so, I must ask you again which version of plsqldoc your are using and also what are your configuration options.
Thank you
Similar threads
- Discussion
