Handle (multiple) "--" comments
Status: Alpha
Brought to you by:
altumano
a) Pldoc doesn't find the comment when I put it like this:
--
--
Comment of the procedure
--
procedure apple(a
varchar2);
b) It finds it if it is like this:
-- comment of the
proc
-- (second line)
procedure apple(a
varchar2);
It might be because using -- in more than one
lines after each other might not be considered as a multiline
comment. However, it is used widely this way so it should be
supported.
Logged In: YES
user_id=86901
Should handle (multiple) "--" comments:
Handle -- comments after parameters
(problem: is it comment after return or before the next
procedure ?)
Logged In: NO
Comments after parameters like
procedure a(
a number, --
Param comment a
b number -- Param comment b
)
are not
necessary to be handled by pldoc.It is true that this form of comment is
used quite often but it wouldn't be easy to handle and far not as important
as multiline -- comments of procedures and functions. It would be a nice to
have but I suggest leaving it out for the time being.
Logged In: YES
user_id=121951
Workaround is as follows:
in Parser.jj
search for "if (commentAll =="...
and replace if-block with
// only use multiple texts
if (commentAll == null) {
commentAll = commentParser.getText();
} else {
commentAll += commentParser.getText();
}
although now it gets too much text...