<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Hi Joel,<div class=""> any test files we develop (at Lero/TCD) will be generated by python tools, </div><div class="">so we could include file level Doxygen quite easily, if that is helpful.</div><div class=""><br class=""></div><div class="">Regards, Andrew<br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On 24 Feb 2020, at 12:22, Joel Sherrill <<a href="mailto:joel@rtems.org" class="">joel@rtems.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="auto" style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 14px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><div class=""><br class=""><br class=""><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" class="">sebastian.huber@embedded-brains.de</a>> wrote:<br class=""></div><blockquote class="gmail_quote" style="margin: 0px 0px 0px 0.8ex; border-left-width: 1px; border-left-style: solid; border-left-color: rgb(204, 204, 204); padding-left: 1ex;">Hello Andrew,<br class=""><br class="">On 24/02/2020 10:48, Andrew Butterfield wrote:<br class="">> Hi Sebastian,<br class="">><span class="Apple-converted-space"> </span><br class="">> a quick question<br class="">> - does the Doxygen block requirement also apply to test programs (xxtest/init.c),<br class="">> either hand-written or model-generated?<br class=""><br class="">we currently don't use Doxygen in the tests. There is some test<span class="Apple-converted-space"> </span><br class="">documentation in the *.doc files of the test suite. I would like to<span class="Apple-converted-space"> </span><br class="">improve the test documentation with the test specification items, but<span class="Apple-converted-space"> </span><br class="">this is a future topic.<br class=""><br class="">It is probably a good approach to add some documentation to generated<span class="Apple-converted-space"> </span><br class="">files if it is available at a higher level.<br class=""></blockquote></div></div><div dir="auto" class=""><br class=""></div><div dir="auto" class="">It would be good if the tests had at least file level Doxygen. But that's a lot of retrofitting.</div><div dir="auto" class=""><br class=""></div><div dir="auto" class="">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" class=""><div class="gmail_quote"><blockquote class="gmail_quote" style="margin: 0px 0px 0px 0.8ex; border-left-width: 1px; border-left-style: solid; border-left-color: rgb(204, 204, 204); padding-left: 1ex;"><br class="">--<span class="Apple-converted-space"> </span><br class="">Sebastian Huber, embedded brains GmbH<br class=""><br class="">Address : Dornierstr. 4, D-82178 Puchheim, Germany<br class="">Phone : +49 89 189 47 41-16<br class="">Fax : +49 89 189 47 41-09<br class="">E-Mail :<span class="Apple-converted-space"> </span><a href="mailto:sebastian.huber@embedded-brains.de" target="_blank" rel="noreferrer" class="">sebastian.huber@embedded-brains.de</a><br class="">PGP : Public key available on request.<br class=""><br class="">Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.<br class="">_______________________________________________<br class="">devel mailing list<br class=""><a href="mailto:devel@rtems.org" target="_blank" rel="noreferrer" class="">devel@rtems.org</a><br class=""><a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer noreferrer" target="_blank" class="">http://lists.rtems.org/mailman/listinfo/devel</a></blockquote></div></div></div></div></blockquote></div><br class=""><div class="">
<div dir="auto" style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">--------------------------------------------------------------------<br class="">Andrew Butterfield Tel: +353-1-896-2517 Fax: +353-1-677-2204<br class="">Lero@TCD, Head of Software Foundations & Verification Research Group<br class="">School of Computer Science and Statistics,<br class="">Room G.39, O'Reilly Institute, Trinity College, University of Dublin<br class=""> <a href="http://www.scss.tcd.ie/Andrew.Butterfield/" class="">http://www.scss.tcd.ie/Andrew.Butterfield/</a><br class="">--------------------------------------------------------------------</div>
</div>
<br class=""></div></body></html>