[Issue 3554] Ddoc generates invalid output for documentation comments with non paired parantheses

[d-bugmail at puremagic.com]

http://d.puremagic.com/issues/show_bug.cgi?id=3554



--- Comment #20 from Witold Baryluk <baryluk at smp.if.uj.edu.pl> 2010-12-22 09:25:02 PST ---
(In reply to comment #19)
> Short explanation of the warning:
> 
> Consider this comment:
> /// Return a random number in $(BOLD [0, 10))
> 
> DMD cannot know if you mean:
> /// Return a random number in $(BOLD [0, 10$(RPAREN))
> (right parenthesis is bold)
> 
> or
> /// Return a random number in $(BOLD [0, 10)$(RPAREN)
> (right parenthesis isn't bold)
> 
> So in some cases it could cause wrong output and therefore the warning is
> needed.

Yes and no.

It is not needed in case of our initial reports.

  /// Return a random number in [0, 10)

As "[0,10)"  is not in any macro, there is only one possible interpretation. Or
it is in some implicit macro?

So warning isn't needed in this situations probably. But warning is acceptable
IMHO for now. Thanks.

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------