<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Jun 17, 2015 at 7:20 AM, Edward Diener <span dir="ltr"><<a href="mailto:eldlistmailingz@tropicsoft.com" target="_blank">eldlistmailingz@tropicsoft.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 6/16/2015 11:43 PM, Nikola Smiljanic wrote:<br>
</span><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
On Wed, Jun 17, 2015 at 11:22 AM, Edward Diener<br>
<<a href="mailto:eldlistmailingz@tropicsoft.com" target="_blank">eldlistmailingz@tropicsoft.com</a><br></span><span class="">
<mailto:<a href="mailto:eldlistmailingz@tropicsoft.com" target="_blank">eldlistmailingz@tropicsoft.com</a>>> wrote:<br>
<br>
    I would suggest that clang actually spend some time telling<br>
    programmers how to use their product.<br>
<br>
<br>
If only the compiler could document itself :)<br>
<br>
On a more serious note, patches in this area are more than welcome. It<br>
took me some time to realize this, but people working on clang are<br>
mostly employed by companies that want them to work on whatever's<br>
important to them. This means that those people know exactly how to use<br>
the compiler. If you're buying a product based on clang then you can<br>
request the company that's selling it to provide documentation. But for<br>
you, me and everyone else using the open source compiler it means that<br>
anything we see missing we'll have to do ourselves or just wait until<br>
someone gets to it, if they do. I'm sure you'll find out the list of<br>
possible values for -std switch, why not contribute a patch documenting<br>
them once you do?<br>
</span></blockquote>
<br>
I am not a clang contributor. I do use clang when testing Boost libraries and I am appreciative of the clang support I get here.<span class=""><br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
On a personal note, I find your tone unacceptable if you expect a<br>
productive discussion.<br>
</blockquote>
<br></span>
My "humor" was borne out of frustration. I need to know not only about the latest clang, but previous versions, because Boost supports many versions of many compilers in most of its libraries. I understand that clang developers work on the compiler itself and that documentation gets overlooked. But no matter how good the compiler is, if an end-user has a hard time using it because documentation is poor or entirely lacking in some areas, how much good will the product be to end-users ?</blockquote><div><br>As an aside - a good chunk of the developers on the LLVM project are employed to do so and the product works for their needs (Google, Apple, etc). So there are pretty solid existence proofs that it's "good enough" for many end-users in its current (very poorly documented) state & it's at least for myself, it's hard to justify time invested in documenting command line options (this doesn't come up often/at all from Google's internal users so far as I recall) compared to more impactful feature development.<br><br>Not many developers on LLVM that I'm aware of are actively seeking/working on wide external adoption in the broader community. Closest would be things like the FreeBSD adoption of Clang, which I imagine would necessitate some improved documentation for their users.<br> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="im HOEnZb"><br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I understand your frustration as I've been there<br>
many times but you have to understand that people in this community are<br>
doing their best and are aware of shortcomings, which is why patches are<br>
more than welcome.<br>
</blockquote>
<br>
<br></span><div class="HOEnZb"><div class="h5">
_______________________________________________<br>
cfe-dev mailing list<br>
<a href="mailto:cfe-dev@cs.uiuc.edu" target="_blank">cfe-dev@cs.uiuc.edu</a><br>
<a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev" rel="noreferrer" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev</a><br>
</div></div></blockquote></div><br></div></div>