[Issue 13211] Expand macros in comments within code sections

[d-bugmail--- via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=13211

Iain Buclaw  changed:

   What|Removed |Added

   Priority|P1  |P3

--

[Issue 13211] Expand macros in comments within code sections

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=13211

Vladimir Panteleev  changed:

   What|Removed |Added

   Keywords||ddoc
   See Also||https://issues.dlang.org/sh
   ||ow_bug.cgi?id=12383
   Severity|enhancement |normal

--- Comment #3 from Vladimir Panteleev  ---
Whether or not macros should be expanded in code blocks at all, the current
behaviour is at least inconsistent, so there is certainly a bug here.

--

[Issue 13211] Expand macros in comments within code sections

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=13211

Andrei Alexandrescu and...@erdani.com changed:

   What|Removed |Added

Version|unspecified |D2

--

[Issue 13211] Expand macros in comments within code sections

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=13211

hst...@quickfur.ath.cx changed:

   What|Removed |Added

 CC||hst...@quickfur.ath.cx

--- Comment #2 from hst...@quickfur.ath.cx ---
I agree, we should stop using macros in code sections. If something needs to be
highlighted, it should be done via comments.

--

[Issue 13211] Expand macros in comments within code sections

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=13211

Alix Pexton alix.pex...@gmail.com changed:

   What|Removed |Added

   Hardware|x86_64  |All
 OS|Windows |All

--- Comment #1 from Alix Pexton alix.pex...@gmail.com ---
I think this is related to the case where macros inside string literals in code
sections are not expanded (bug:12383).

Code in a code section that compiles when copy/pasted as-is can have macros
that are not expanded when documentation is generated.

Code in a code section that contains macros that are expanded when
documentation is generated won't compile if just copy/pasted as-is.

I'm starting to think that macros in code sections should be discouraged.

--