plsqldoc: Cannot handle EZconnect names

[Niek]

plsqldoc cannot handle EZconnect names for database correctly:

\\localhost\orcl

it is complaining that it cannot find the directory \localhost\orcl.

Creating that directory manually will not solve the problem when using multiple databases.

 

[Marco Kalter]

There are several options that control the names of the generated directories and files. If this includes the database name, the retulting file and directory names are invalid. As a workaround you would have to remove the database from the naming options.

We'll try to fix this in a patch release.

 

[Marco Kalter]

You can download a pre-release here . In this version the slashes by underscores to generate a correct directory or file name.

 

[Niek]

Thanks Marco!

I did try this out and this is working great - it seems there are more changes within this pre-release. Some things are working differently now. It seems that line prefixes are not working - even '--' is not ignored anymore.

For example try generating doc for the following package spec with the previous version and the pre-release version and see the differences (for example the synopsis is not joining lines correctly with the pre-release version, probably related to the line-prefix)

CREATE OR REPLACE PACKAGE BODY test
/**
Package spec text

  This is test comment which will span multiple lines and plsqldoc will
  normally merge those lines together for the synopsis. This is test
  comment which will span multiple lines and plsqldoc will normally merge
  those lines together for the synopsis.

  This is test comment which will span multiple lines and plsqldoc will
  normally merge those lines together for the synopsis.

  %History
--! History info1 ending with comma,
--! History info2 ending with semicolon;
--! History info3 ending with colon:
--! History info4 ending with point.
--! History info5 ending with nothing
*/
IS
  /**
  This is test comment which will span multiple lines and plsqldoc will
  normally merge those lines together for the synopsis. This is test
  comment which will span multiple lines and plsqldoc will normally merge
  those lines together for the synopsis.

  This is test comment which will span multiple lines and plsqldoc will
  normally merge those lines together for the synopsis.

  %param arg1 Argument number 3
  %param arg2 Argument number 2

--! Comment line1 after param ending with comma,
--! Comment line2 after param ending with semicolon;
--! Comment line3 after param ending with colon:
--! Comment line4 after param ending with point.
--! Comment line5 after param ending with nothing
  */
  PROCEDURE test_1 IS BEGIN NULL; END;

END test;

Any news on my other requests?

 

[Marco Kalter]

We'll check it out.