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

          Issue ID: 19298
           Summary: C preprocessor directive is not supported - confusing
                    warning message
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: normal
          Priority: P1
         Component: dmd
          Assignee: nobody@puremagic.com
          Reporter: freeslave93@gmail.com

Having a file

/**
 * ---
# Comment
 * ---
*/

void main()
{

}

Trying to get documentation as
dmd -o- -w -Dddocs main.d

Leads to the warning

(1): Warning: C preprocessor directive #Comment is not supported

I understand that it's supposed to be a valid D code inside DDoc comment, but dmd should at least report the file name where error happened. Also the meaning of the number in parentheses is not obvious.

I found a similar issue https://issues.dlang.org/show_bug.cgi?id=18836 marked as solved but dmd needs improvements on reporting this error: report the file name and position of so-called directive in the code, so users could find the cause of warning.

--