<div class="gmail_quote">On Fri, Jul 8, 2011 at 12:30 AM, John McCall <span dir="ltr"><<a href="mailto:rjmccall@apple.com">rjmccall@apple.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div class="im">On Jul 7, 2011, at 9:10 PM, Chandler Carruth wrote:<br>
> The only other term I've thought about is 'replacement' as that's what the standard uses in most cases. However, for diagnostics and thinking about how the preprocessor works, I actually find 'expansion' much more helpful. However, if others like the C standard's 'replacement' terminology, I'd be down with that. =]<br>

<br>
</div>I like 'expansion'.  Specifically, I like "expanded from macro here", or something like that.  I wouldn't try to call out specific cases of where the text came from;  there's a lot of value in having a consistent message for these, because users can recognize the shape of a macro-expansion note at a glance without having to actually read it.</blockquote>
<div><br></div><div>John and I chatted on IRC about various wordings for these notes. He was particularly concerned about keeping them short and concise, which I agree with, and hopefully the macro name itself won't negatively impact that too much. Based on your suggestion my two candidate wordings would be:</div>
<div><br></div><div>"note: expanded from macro 'foo':"</div><div><br></div><div>and</div><div><br></div><div>"note: expanded from macro 'foo' defined here:"</div><div><br></div><div>The latter is a bit wordy, but helps give context to the snippet that follows, and has good structural similarity to the template message:</div>
<div>"note: in instantiation of template class 'foo' requested here:"</div><div><br></div><div>One concern with just removing "defined" is the ambiguity of "here" referring to either where the expansion occurs or the definition. Without the "here", the snippet would hopefully associate with the "macro 'foo'", but it's still a touch vague...</div>
<div><br></div><div>More thoughts on wording welcome!</div></div>