plsqlDOC beta + block comments

[emrys]

Any chance plsqldoc could be enhanced to support block formatted /* */ comments, by merging sequential /* */ comments. I.e. a lot of our comments look like:

/* blah blah blah balah */
/* lbah blah halb hal blah */
/* oope blah blah blah oop */

and whilst plsqldoc will merge lines like

-- blah blah blah balah
-- lbah blah halb hal blah
-- oope blah blah blah oop

up into one comment, it doesn't do that with the first type. (And if your coders are feeling really generous (and bored!), it would be nice to treat such blocks as preformatted (e.g. implied

tags) if the ending */'s all line up...)

 

[Stew Stryker]

emrys,

I've never figured out why programmers would create their comments like that, though at least one of the guys I work with does. It seems like WAY too much work to set them up like that and I don't know of any pretty-printers that will reformat them properly.

But what's done's done, right? :-/

 

[Marco Kalter]

I have added this to the list of enhancement requests.

 

[emrys]

Stew,

While I personally agree that it's probably more work than it's worth, I've noticed that places that do a lot of group code reviews tend to end up with comments like that because the /* */ 's at each end of the line help the comments stick out clearly when printed out in black and white.

It's swings and roundabouts really.

Marco, Thanks.