Issue 2420 - string mixins are not considered in ddoc
Summary: string mixins are not considered in ddoc
Status: NEW
Alias: None
Product: D
Classification: Unclassified
Component: dmd (show other issues)
Version: D2
Hardware: All All
: P4 enhancement
Assignee: No Owner
URL:
Keywords: ddoc
: 3829 16463 (view as issue list)
Depends on:
Blocks:
 
Reported: 2008-10-15 13:10 UTC by FeepingCreature
Modified: 2022-12-17 10:42 UTC (History)
6 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this issue.
Description FeepingCreature 2008-10-15 13:10:40 UTC 
Consider the following code:

module test108;

// this works and shows up
/// Test 1
void test1() { }

// doesn't show up
mixin("/// Test 2");
void test2() { }

// doesn't show up either
mixin("/// Test 3
void test3() { }");

If this were fixed, documentation could be moved to an external text file and handled via CTFE and import.
Comment 1 BCS 2008-10-15 16:46:16 UTC 
Vote++ 

I have s pile-o-code that would benefit from this as I am generating functions an would like to be able to generate docs as well. 

(OT but it would be nice if decent also autocompleted for mixin() code)
Comment 2 Leandro Lucarella 2008-12-08 08:45:55 UTC 
This bug is very close to bug 648.
Comment 3 Brad Roberts 2010-02-18 21:28:20 UTC 
*** Issue 3829 has been marked as a duplicate of this issue. ***
Comment 4 Andrej Mitrovic 2016-09-04 17:22:47 UTC 
*** Issue 16463 has been marked as a duplicate of this issue. ***
Comment 5 RazvanN 2019-09-09 15:07:25 UTC 
As far as I know, ddoc generation is done right after parsing. This means that by the time the doc is generated the mixin has not been expanded yet.
Comment 6 FeepingCreature 2019-09-10 13:34:15 UTC 
It's weird... if I look at Ddoc for a string mixin of aliases in a struct, I see the alias symbols (by name), but not any comments the mixin puts on them.