<div dir="ltr">Hi,<div><br></div><div>Teemu's added some improvements to this area at <a href="https://gerrit.gromacs.org/3188">https://gerrit.gromacs.org/3188</a>, please do try it out.</div><div><br></div><div>Mark</div>
</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Feb 25, 2014 at 9:01 PM, Szilárd Páll <span dir="ltr"><<a href="mailto:pall.szilard@gmail.com" target="_blank">pall.szilard@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi,<br>
<br>
Thanks Teemu for the quick reply!<br>
<div class=""><br>
On Tue, Feb 25, 2014 at 8:01 PM, Teemu Murtola <<a href="mailto:teemu.murtola@gmail.com">teemu.murtola@gmail.com</a>> wrote:<br>
> Hi,<br>
><br>
><br>
> On Tue, Feb 25, 2014 at 8:38 PM, Szilárd Páll <<a href="mailto:pall.szilard@gmail.com">pall.szilard@gmail.com</a>><br>
> wrote:<br>
><br>
>> I've just ran into an annoying issue which I could not figure out. It<br>
>> seems that no matter what I do, the make-ing the docs-all target<br>
>> completes successfully, but the result is empty docs directories. Any<br>
>> ideas what could be wrong?<br>
>><br>
><br>
> What is in the log files? What happens if you run, e.g., "doxygen<br>
> Doxyfile-user" in the doxygen subdirectory in the build directory? Those can<br>
> give you clues what is actually happening. This might happen if Doxygen<br>
> actually terminates unexpectedly without writing anything to stderr (which<br>
> those .tmp files seem to indicate). Perhaps the build system could be<br>
> improved a bit to also fail the build in such a case.<br>
<br>
</div>Indeed, this doxygen simply does not work - it crashes, chokes or<br>
whatever, but the log files are all empty. The root index.html has<br>
some stuff, but otherwise it's all blank.<br>
<br>
It'd be great if the build system could at least warn if something goes wrong.<br>
<br>
I was really not expecting such a trivial error as all make doc-*<br>
targets succeeded. So I kept digging for quite a while, I tried three<br>
different machines with different doxygen versions, but of course,<br>
none of them had as new of a version as 1.8.5. I could not find any<br>
documentation or reference to a required doxygen version on the wiki<br>
(there is nothing on doxygen on the wiki, it seems?).<br>
<div class=""><br>
>> Here are the steps to repro the issue, used current master, cmake<br>
>> 2.8.12.1 and doxygen 1.7.3.<br>
><br>
><br>
> To get meaningful documentation with warnings that somehow resemble Jenkins,<br>
> you will need Doxygen 1.8.5 (as documented here:<br>
> <a href="http://jenkins.gromacs.org/job/Doxygen_Nightly_master/javadoc/html-lib/page_doxygen.xhtml" target="_blank">http://jenkins.gromacs.org/job/Doxygen_Nightly_master/javadoc/html-lib/page_doxygen.xhtml</a>).<br>
> Doxygen versions are sufficiently dissimilar that it may be that the old<br>
> version now completely chokes on the new input. Does using a more recent<br>
> Doxygen version help?<br>
<br>
</div>Yes, that works.<br>
<br>
Still don't know why does not want to ref a global enum (with<br>
#EnumName), but that's a different story.<br>
<br>
Cheers,<br>
--<br>
Szilárd<br>
<br>
><br>
> - Teemu<br>
<div class="HOEnZb"><div class="h5">><br>
> --<br>
> Gromacs Developers mailing list<br>
><br>
> * Please search the archive at<br>
> <a href="http://www.gromacs.org/Support/Mailing_Lists/GMX-developers_List" target="_blank">http://www.gromacs.org/Support/Mailing_Lists/GMX-developers_List</a> before<br>
> posting!<br>
><br>
> * Can't post? Read <a href="http://www.gromacs.org/Support/Mailing_Lists" target="_blank">http://www.gromacs.org/Support/Mailing_Lists</a><br>
><br>
> * For (un)subscribe requests visit<br>
> <a href="https://maillist.sys.kth.se/mailman/listinfo/gromacs.org_gmx-developers" target="_blank">https://maillist.sys.kth.se/mailman/listinfo/gromacs.org_gmx-developers</a> or<br>
> send a mail to <a href="mailto:gmx-developers-request@gromacs.org">gmx-developers-request@gromacs.org</a>.<br>
--<br>
Gromacs Developers mailing list<br>
<br>
* Please search the archive at <a href="http://www.gromacs.org/Support/Mailing_Lists/GMX-developers_List" target="_blank">http://www.gromacs.org/Support/Mailing_Lists/GMX-developers_List</a> before posting!<br>
<br>
* Can't post? Read <a href="http://www.gromacs.org/Support/Mailing_Lists" target="_blank">http://www.gromacs.org/Support/Mailing_Lists</a><br>
<br>
* For (un)subscribe requests visit<br>
<a href="https://maillist.sys.kth.se/mailman/listinfo/gromacs.org_gmx-developers" target="_blank">https://maillist.sys.kth.se/mailman/listinfo/gromacs.org_gmx-developers</a> or send a mail to <a href="mailto:gmx-developers-request@gromacs.org">gmx-developers-request@gromacs.org</a>.<br>
</div></div></blockquote></div><br></div>