www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 12536] New: Implove the documentation about preprocessing the files has "Ddoc" file header

reply d-bugmail puremagic.com writes:
https://d.puremagic.com/issues/show_bug.cgi?id=12536

           Summary: Implove the documentation about preprocessing the
                    files has "Ddoc" file header
           Product: D
           Version: D2
          Platform: All
               URL: http://dlang.org/ddoc.html
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: websites
        AssignedTo: nobody puremagic.com
        ReportedBy: jiki red.email.ne.jp
        Depends on: 12535


--- Comment #0 from jiki red.email.ne.jp 2014-04-07 00:55:12 PDT ---
When I was scanning many d module files, some are in strange format -- of the
whole ddoc.
Though I have never known that, a "Ddoc" file header makes the compiler
preprocess and the generated file is not an object but an HTML document.

I wonder if it is in use and is well known...

Anyways, the descriptions about such preprocesses should be _gathered_ in one
place.
I have filed Issue 12535 for the same purpose.

It might get better Editor/IDE supports, too. ;)

-- 
Configure issuemail: https://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
Apr 07 2014
parent d-bugmail puremagic.com writes:
https://d.puremagic.com/issues/show_bug.cgi?id=12536



--- Comment #1 from jiki red.email.ne.jp 2014-04-07 03:59:28 PDT ---
Sorry, I should have mentioned that the above _is_ descrived in the document
page about DDOC(see the URL of this issue), nearly at the bottom of the page.

I am afraid that we could scarsly remind it even if it matters.

-- 
Configure issuemail: https://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
Apr 07 2014