Menu

#7 Handle (multiple) "--" comments

open
None
5
2002-12-08
2002-11-28
No

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.

Discussion

  • Albert Tumanov

    Albert Tumanov - 2002-12-08
    • assigned_to: nobody --> altumano
    • summary: Empty start line comment is not found --> Handle (multiple) "--" comments
     
  • Albert Tumanov

    Albert Tumanov - 2002-12-08

    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 ?)

     
  • Nobody/Anonymous

    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.

     
  • Erik Pischel

    Erik Pischel - 2003-01-23

    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...

     

Log in to post a comment.

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.