Hi Samuel,
to me it just looks like doxygen became much less tolerant.
By looking at and acting upon the warning messages that doxygen prints I
was able to fix the two problems that you point out.
Regarding the missing DebuggingTools.html, this warning:
/tmp/tmp.fHubpjAE1z/starpu/doc/doxygen/chapters/starpu_extensions/debugging_tools.doxy:129:
warning: Reached end of file while still searching closing '`' of a
verbatim block starting at line 33
prompted me to apply this fix:
--- a/doc/doxygen/chapters/starpu_extensions/debugging_tools.doxy
+++ b/doc/doxygen/chapters/starpu_extensions/debugging_tools.doxy
@@ -30,7 +30,7 @@ catchup assertions. If your program is valgrind-safe,
you can use it, see \ref
UsingOtherDebugger.
Depending on your toolchain, it might happen that you get
-<c>undefined reference to `__stack_chk_guard'</c> errors. In that case,
use the
+<c>undefined reference to `__stack_chk_guard`</c> errors. In that case,
use the
<c>--disable-fstack-protector-all</c> option to avoid the issue.
Then, if your program crashes with an assertion error, a segfault,
etc. you can send us the result of
and now:
ls -l ./html/DebuggingTools.html
-rw-rw-r-- 1 paolog paolog 9434 3 dic 23.41 ./html/DebuggingTools.html
Regarding data_management.doxy,the warning on the preceding line of the log:
/tmp/tmp.fHubpjAE1z/starpu/doc/doxygen/chapters/starpu_basics/data_management.doxy:294:
warning: Found end of C comment inside a 'code' block without matching
start of the comment! Maybe the end marker for the block is missing?
prompted me to apply this fix:
index b78c6628..9a464903 100644
--- a/doc/doxygen/chapters/starpu_basics/data_management.doxy
+++ b/doc/doxygen/chapters/starpu_basics/data_management.doxy
@@ -290,8 +290,8 @@ uint32_t colind[NNZ_BLOCKS] =
};
uint32_t rowptr[NROWS+1] =
{
- 0, / * block-index in nzval of the first block of the first row. */
- 1, / * block-index in nzval of the first block of the second row. */
+ 0, /* block-index in nzval of the first block of the first row. */
+ 1, /* block-index in nzval of the first block of the second row. */
NNZ_BLOCKS /* number of blocks, to allow an easier element's
access for the kernels */
};
and ./html/DataManagement1.html went from a truncated 21782 bytes to
full 51394 bytes.
AFAICT there is nothing wrong with doxygen, it should be possible to
patch all those warnings one by one and to so fix your issues.
If you agree, please reassign to starpu.
Paolo
