<div dir="ltr"><div class="gmail_quote"><div dir="ltr">On Tue, 30 Jun 2015 at 10:33 Sean Silva <<a href="mailto:chisophugis@gmail.com">chisophugis@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Sat, Jun 27, 2015 at 2:42 AM, Dimitry Andric <span dir="ltr"><<a href="mailto:dimitry@andric.com" target="_blank">dimitry@andric.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">This looks good to me too.  We had been using the .pod based man page in FreeBSD for a while, since building man pages from the other .rst files in tools/clang/docs resulted in *very* incomplete output, which looked partly like documentation, partly like a manpage...<br></blockquote><div><br></div></div></div></div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div>I think what was happening before is that Sphinx was just generating the regular docs, but formatted as man pages.</div><div><br></div><div>I think Andrew's changes actually make clang's docs be like LLVM's docs so that the only generated man pages are the things intended to be manpages (like llvm/docs/CommandGuide; in clang it is just the single manpage).</div></div></div></div></blockquote><div><br></div><div>That is correct. Previously, trying to build the man would just build the entire documentation in the man page format. Now there's a man-page specific file, with room for adding more later.</div><div><br></div><div>Is this patch acceptable now? I think the sooner it gets in and breaks packaging, the better, since people will have more time to react.</div><div><br></div><div>Cheers,</div><div>Andrew</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div>-- Sean Silva</div></div></div></div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div><div><br>
<br>
<a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__reviews.llvm.org_D10562&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=BSqEv9KvKMW_Ob8SyngJ70KdZISM_ASROnREeq0cCxk&m=oyohRJwJBB3oAjgSPB9qAsgI7EHvw4w1128300GeGPg&s=shx46o7f4EKhvSQ6cjuCPUogwle5wn0cWokN_k99lVw&e=" rel="noreferrer" target="_blank">http://reviews.llvm.org/D10562</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=oyohRJwJBB3oAjgSPB9qAsgI7EHvw4w1128300GeGPg&s=XadRwt3dZL1QoWgGPBH_Bg0462Fhnol6Q_4wVunqS1Y&e=" rel="noreferrer" target="_blank">http://reviews.llvm.org/settings/panel/emailpreferences/</a><br>
<br>
<br>
</div></div></blockquote></div></div></div></blockquote></div></div>