<div class="gmail_quote">On Mon, Aug 29, 2011 at 6:10 PM, Douglas Gregor <span dir="ltr"><<a href="mailto:dgregor@apple.com">dgregor@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="HOEnZb"><div></div><div class="h5"><br>
On Aug 23, 2011, at 9:45 PM, Richard Trieu wrote:<br>
<br>
> I have been working on a new feature for diagnostic messages.  When a diagnostic contains two template types, give additional notes to show which part of the template is different.  For large templates, this will help users more quickly determine what is wrong with the template.<br>

><br>
> For example:<br>
><br>
> template <typename T1, typename T2> class A {};<br>
> template <typename T1> class B {};<br>
> template <typename T1> class C {};<br>
> template <typename T1> class D {};<br>
><br>
> void foo(A<B<C<D<const int> > >, B<C<D<const double> > > > F) {}<br>
><br>
> void bar() {<br>
>   foo(A<B<C<D<int> > >, B<C<const double> > >());;<br>
> }<br>
><br>
> would give the error:<br>
><br>
> type-diff.cc:26:3: error: no matching function for call to 'foo'<br>
>   foo(A<B<C<D<int> > >, B<C<const double> > >());;<br>
>   ^~~<br>
> type-diff.cc:23:6: note: candidate function not viable: no known conversion from 'A<B<C<D<int> > >, B<C<const double> > >' to<br>
>       'A<B<C<D<const int> > >, B<C<D<const double> > > >' for 1st argument;<br>
> void foo(A<B<C<D<const int> > >, B<C<D<const double> > > > F) {}<br>
>      ^<br>
><br>
> It's hard to see exactly what's different from 'A<B<C<D<int> > >, B<C<const double> > >' and 'A<B<C<D<const int> > >, B<C<D<const double> > > >'<br>

><br>
> With template type diffing, additional notes are emitted to show the difference.  It now becomes:<br>
><br>
> type-diff.cc:26:3: error: no matching function for call to 'foo'<br>
>   foo(A<B<C<D<int> > >, B<C<const double> > >());;<br>
>   ^~~<br>
> type-diff.cc:23:6: note: candidate function not viable: no known conversion from 'A<B<C<D<int> > >, B<C<const double> > >' to<br>
>       'A<B<C<D<const int> > >, B<C<D<const double> > > >' for 1st argument;<br>
> void foo(A<B<C<D<const int> > >, B<C<D<const double> > > > F) {}<br>
>      ^<br>
> type-diff.cc:23:6: note: Type 'C<const double>' is different from type 'C<D< >>'<br>
> type-diff.cc:23:6: note: Type 'D<int>' is different from type 'D<const int>'<br>
><br>
> I have attached a patch with an early prototype of this feature and would appreciate any feedback.  Currently, the extra notes are only displayed for this one note, but should be easy enough to extend to other places.  There's also a test case included to show some other examples of this feature.  Let me know what you think about it.<br>

<br>
</div></div>Interesting. I like the general idea, but I'm very worried that displaying this information via extra notes is going to introduce a significant amount of console spew. Especially when we're dealing with displayed candidate sets, where we already have a large number of notes.<br>

<br>
What we really want is to draw the user's eye to the differences between two similar types. Could we take advantage of the colorized console messages to highlight the differences between two similar types within the message text itself, so it doesn't cost us any more screen real estate?</blockquote>
<div><br></div><div>Several people mentioned this idea... I'm not sure it really works for all use cases though.</div><div><br></div><div>One of the common problems cited is that the template names are so long that they wrap across multiple lines. I think drawing the users eye to the two pieces that are different is going to be hard even with underlining or bolding or other formatting.</div>
<div><br></div><div>The other interesting aspect is that these notes don't add as much screen real estate as many others -- they're essentially guaranteed to not show the code snippet, and to be very short, so they don't line wrap a lot.</div>
<div><br></div><div>Finally, nothing says we have to do one or the other. We could do both, and allow people to enable or disable them. This seems particularly appealing to me, as for non-console users, there are much more intuitive ways to display this information. </div>
</div>