<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Jun 12, 2015 at 2:01 AM, Andrew Wilkins <span dir="ltr"><<a href="mailto:axwalk@gmail.com" target="_blank">axwalk@gmail.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="">In <a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__reviews.llvm.org_D10304-23185908&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=BSqEv9KvKMW_Ob8SyngJ70KdZISM_ASROnREeq0cCxk&m=VMjH8bf8DZB_ISW8968gXZRgkAPV5qyeFiRWBld6HUU&s=BYo6hHUDDSMZ831rLJwl1lsfoTRQBwIXOuSVvZIGllk&e=" rel="noreferrer" target="_blank">http://reviews.llvm.org/D10304#185908</a>, @silvas wrote:<br>
<br>
> Clang's man page is the only thing that is generated like this. The rest use Sphinx's manpage output.<br>
<br>
<br>
</span>@chandlerc given the above, do you still want me to create a macro/function? I'm not deeply involved here, so grain of salt, but I think it'd be better to converge on one documentation tool (Sphinx) than to perpetuate use of multiple formats (Sphinx & pod2man, and whatever else there may be). I could look at rewriting the clang.pod file in Sphinx, and then use Sphinx in CMake. Is that a reasonable change?<br></blockquote><div><br></div><div>I would support converting the clang manpage to Sphinx. Dmitri, IIRC Apple generates their shipping clang manpage from the pod documentation; do you know who is the right point of contact so that we can make sure that you guys smoothly transition to generating it with Sphinx?</div><div><br></div><div>-- Sean Silva</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
BTW, there's this: <a href="https://urldefense.proofpoint.com/v2/url?u=https-3A__llvm.org_bugs_show-5Fbug.cgi-3Fid-3D23054&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=BSqEv9KvKMW_Ob8SyngJ70KdZISM_ASROnREeq0cCxk&m=VMjH8bf8DZB_ISW8968gXZRgkAPV5qyeFiRWBld6HUU&s=GHTy3dk3_wrrweFdbmZzAbmeonhk5rNJQOWxhg6MCw4&e=" rel="noreferrer" target="_blank">https://llvm.org/bugs/show_bug.cgi?id=23054</a>, so what's there seems to be broken on OS X at least, though I can't verify that.<br>
<div class="HOEnZb"><div class="h5"><br>
<br>
<a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__reviews.llvm.org_D10304&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=BSqEv9KvKMW_Ob8SyngJ70KdZISM_ASROnREeq0cCxk&m=VMjH8bf8DZB_ISW8968gXZRgkAPV5qyeFiRWBld6HUU&s=6hf9MofTt7dynJNMyoU2xvQaDvqi2NPzueIA0gQvdCo&e=" rel="noreferrer" target="_blank">http://reviews.llvm.org/D10304</a><br>
<br>
EMAIL PREFERENCES<br>
  <a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__reviews.llvm.org_settings_panel_emailpreferences_&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=BSqEv9KvKMW_Ob8SyngJ70KdZISM_ASROnREeq0cCxk&m=VMjH8bf8DZB_ISW8968gXZRgkAPV5qyeFiRWBld6HUU&s=xZ4BnbttJJzFk0TpiTOnX5_KBeXPjyN_p2r3kHpIy-E&e=" rel="noreferrer" target="_blank">http://reviews.llvm.org/settings/panel/emailpreferences/</a><br>
<br>
<br>
</div></div></blockquote></div><br></div></div>