www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 9497] New: ddoc: add support for handling undefined macros

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

           Summary: ddoc: add support for handling undefined macros
           Product: D
           Version: D2
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: DMD
        AssignedTo: nobody puremagic.com
        ReportedBy: andrei erdani.com


--- Comment #0 from Andrei Alexandrescu <andrei erdani.com> 2013-02-10 14:16:54
PST ---
Currently an undefined ddoc macro expands to the empty string. This makes typos
in macros and ill-configured builds difficult to debug. 

Handling undefined macros should be done with a predefined macro
DDOC_UNDEFINED_MACRO. If macro XYZ is used as e.g. $(XYZ arg1,arg2) without
being defined, it is replaced with $(DDOC_UNDEFINED_MACRO XYZ,arg1,arg2). If in
turn DDOC_UNDEFINED_MACRO is undefined, the expansion is the empty string (thus
ensuring backward compatibility).

This allows users to define useful behaviors, such as:

a) replace with a comment:

DDOC_UNDEFINED_MACRO=$(DDOC_COMMENT $(DOLLAR)($1 $+))
b) keep verbatim

DDOC_UNDEFINED_MACRO=$(DOLLAR)($1 $+)
c) keep only the argument text

DDOC_UNDEFINED_MACRO=$+
d) replace with a greppable text such that subsequent tools can find all
occurrences:

DDOC_UNDEFINED_MACRO=ERROR_UNDEFINED_MACRO: "$1"

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
Feb 10 2013
next sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=9497


Andrei Alexandrescu <andrei erdani.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Keywords|                            |preapproved


--- Comment #1 from Andrei Alexandrescu <andrei erdani.com> 2013-02-10 14:18:23
PST ---
https://github.com/D-Programming-Language/dmd/pull/1653

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
Feb 10 2013
prev sibling parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=9497


Andrej Mitrovic <andrej.mitrovich gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Keywords|                            |pull
                 CC|                            |andrej.mitrovich gmail.com
           Severity|normal                      |enhancement


-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
Feb 11 2013