Thread overview
[Issue 13211] Expand macros in comments within code sections
Jul 27, 2014
Alix Pexton
Jul 19, 2017
Vladimir Panteleev
Dec 17, 2022
Iain Buclaw
July 27, 2014
https://issues.dlang.org/show_bug.cgi?id=13211

Alix Pexton <alix.pexton@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Hardware|x86_64                      |All
                 OS|Windows                     |All

--- Comment #1 from Alix Pexton <alix.pexton@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.

--
September 11, 2014
https://issues.dlang.org/show_bug.cgi?id=13211

hsteoh@quickfur.ath.cx changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |hsteoh@quickfur.ath.cx

--- Comment #2 from hsteoh@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.

--
June 09, 2015
https://issues.dlang.org/show_bug.cgi?id=13211

Andrei Alexandrescu <andrei@erdani.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
            Version|unspecified                 |D2

--
July 19, 2017
https://issues.dlang.org/show_bug.cgi?id=13211

Vladimir Panteleev <dlang-bugzilla@thecybershadow.net> 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 <dlang-bugzilla@thecybershadow.net> ---
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.

--
December 17, 2022
https://issues.dlang.org/show_bug.cgi?id=13211

Iain Buclaw <ibuclaw@gdcproject.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Priority|P1                          |P3

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

--- Comment #4 from dlangBugzillaToGithub <robert.schadek@posteo.de> ---
THIS ISSUE HAS BEEN MOVED TO GITHUB

https://github.com/dlang/dmd/issues/17672

DO NOT COMMENT HERE ANYMORE, NOBODY WILL SEE IT, THIS ISSUE HAS BEEN MOVED TO GITHUB

--