proposal: heredoc comments to allow `+/` in comments, eg from urls or documented unittests

Nick Sabalausky (Abscissa) SeeWebsiteToContactMe at semitwist.com
Fri Feb 9 07:04:26 UTC 2018


On 02/08/2018 10:06 PM, Timothee Cour wrote:
> 
> /"EOC
> This is a multi-line
> heredoc comment allowing
> /+ documented unittests containing nesting comments +/

That shouldn't be an issue as long as you're using /++ doc comments and 
not /** ones. If it IS a problem, I'd regard it as a bug.

(If I were in change of the world, /** and /* both would be compiler 
errors, banned from all commits, and non-nesting block comments of all 
types would be prohibited from all langauges upon pain of...well, pain. 
They are spawn of satan and should never exist.)

> and weird urls like https://gcc.gnu.org/onlinedocs/libstdc++/faq.html

*That* is a compelling point: Any embedded langauge (such as URL syntax) 
where +/ is valid. That, and maybe any code examples or discussions 
which, for any reason, intentially involve an unmatched end-of-comment.


More information about the Digitalmars-d mailing list