There isn't a single example of how to actually use a macro on the ddoc instructions pages (http://www.digitalmars.com/d/ddoc.html ; http://www.digitalmars.com/d/1.0/ddoc.html) Theres some verbose description of how macros can have arguments blah blah blah, but it should be followed by an example like: """ For example, to use the predefined bold formatting macro, B: /** A function of some sort. * * After calling this, you $(B absolutely must) remember to brush your teeth. */ """ ... at least after reading the description a few times I $(I think) that's how DDoc macros are supposted to be used.
Take a look at the Phobos source. IIRC it has many examples
Thanks. I know it does. The point of filing the bug report is to make life easier for future users so they don't have to go digging through the phobos source just to find out how to make some text bold.
I hear you. I was proposing a work around, not a solution.
https://github.com/D-Programming-Language/dlang.org/pull/565
Commits pushed to master at https://github.com/D-Programming-Language/dlang.org https://github.com/D-Programming-Language/dlang.org/commit/810afe594a0c35e681cba31d4b9fa40dfe27452b Fix Issue 1574 - Add a simple example of macro substitution. https://github.com/D-Programming-Language/dlang.org/commit/b558bb26c84794c0633b7a4497184c0cdf14be4f Merge pull request #565 from AndrejMitrovic/Fix1574 Issue 1574 - Add a simple example of macro substitution.