#68 code comment misunderstood when alone in topic

[Jean Rajotte]

When a code section is the only comment in a topic, it
gets "cleaned up" into plain text:

. I tracked it
down to the sub CleanComment() in parser.pm, where you
conclude that ($leftSide == IS_UNIFORM) if the comment
looked like this:

;;; func: bob
;;; > my sample
real code...

This misbehaviour doesn't happen if the comment is like
this:

;;; func: bob
;;; (start code)
;;; my sample
;;; (end code)
real code...

I guess because it's not deemed to be "uniform" on the
left.

A work-around is to always add text, eg:
;;; func: bob
;;; > my sample
;;; my extra text
real code...

Thanks.

notes that don't quite pertain to this defect :)
(1) This matters to us because we use these code
sections as our prototypes because it's mighty hard to
parse Scheme prototypes

(2) FYI: In my copy, I changed GetSummaryFromBody() in
parser.pm to tolerate a code section beforehand. Thus
our code sections are rendered as a prototype, but we
still get a summary.

if ($body =~

/^(?:<h>[^<]<\/h>|[^<]<\/code>)?</h>

(.*?)(<\/p>|.!\?)/x)

(3) I wish I could read Perl better :)