Edit history: 2004-06-16, Version 1 by Christophe Rhodes
Status: For CLiki consideration
- Problem Description:
- The glossary entry for compiler macro function is inconsistent with the entries in the main body of the standard: the glossary states that returning #H(nil) from the compiler macro function indicates that the original form should not be expanded, whereas #H(define-compiler-macro) states that this is achieved by returning the original form (from the #H(&whole) argument).
- Proposal (DEFINE-COMPILER-MACRO-DECLINE:ORIGINAL-FORM-ONLY):
- Specify that the glossary entry was in error, and that to decline expansion the original form should be returned from the compiler macro function. Specify that a return value of #H(nil) indicates that the form should be expanded by the compiler, if it expands the compiler macro at all, to #H(nil).
- Test case:
- The glossary entry was clearly in error, and could potentially cause confusion.
- Current practice:
- SBCL 0.8.11 (and earlier versions), CMUCL 18e and CLISP 2.33 behave as in proposal DEFINE-COMPILER-MACRO-DECLINE:ORIGINAL-FORM-ONLY.
- Cost to Implementors:
- Cost to Users:
- Cost of Non-Adoption:
- Continued confusion over the required semantics of a compiler macro function.
- Enhanced ability to write compiler macros portably.
- Returning the original form to decline is clearly superior to returning #H(nil), as it avoids any possible confusion over #H(nil) as expansion.