<div dir="auto"><div><br><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Feb 24, 2020, 6:03 AM Sebastian Huber <<a href="mailto:sebastian.huber@embedded-brains.de">sebastian.huber@embedded-brains.de</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hello Andrew,<br>
<br>
On 24/02/2020 10:48, Andrew Butterfield wrote:<br>
> Hi Sebastian,<br>
> <br>
> a quick question<br>
> - does the Doxygen block requirement also apply to test programs (xxtest/init.c),<br>
> either hand-written or model-generated?<br>
<br>
we currently don't use Doxygen in the tests. There is some test <br>
documentation in the *.doc files of the test suite. I would like to <br>
improve the test documentation with the test specification items, but <br>
this is a future topic.<br>
<br>
It is probably a good approach to add some documentation to generated <br>
files if it is available at a higher level.<br></blockquote></div></div><div dir="auto"><br></div><div dir="auto">It would be good if the tests had at least file level Doxygen. But that's a lot of retrofitting.</div><div dir="auto"><br></div><div dir="auto">Andrew may not realise that Doxygen is newer than RTEMS and that all Doxygen comments are later additions or conversions of the previous comment format.</div><div dir="auto"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
-- <br>
Sebastian Huber, embedded brains GmbH<br>
<br>
Address : Dornierstr. 4, D-82178 Puchheim, Germany<br>
Phone   : +49 89 189 47 41-16<br>
Fax     : +49 89 189 47 41-09<br>
E-Mail  : <a href="mailto:sebastian.huber@embedded-brains.de" target="_blank" rel="noreferrer">sebastian.huber@embedded-brains.de</a><br>
PGP     : Public key available on request.<br>
<br>
Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.<br>
_______________________________________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank" rel="noreferrer">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a></blockquote></div></div></div>