<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Mar 8, 2019 at 1:28 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:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 07/03/2019 21:57, Joel Sherrill wrote:<br>
> On Thu, Mar 7, 2019 at 2:55 PM Chris Johns <<a href="mailto:chrisj@rtems.org" target="_blank">chrisj@rtems.org</a> <br>
> <mailto:<a href="mailto:chrisj@rtems.org" target="_blank">chrisj@rtems.org</a>>> wrote:<br>
><br>
>     On 8/3/19 3:24 am, Sebastian Huber wrote:<br>
>     > On 07/03/2019 15:19, Joel Sherrill wrote:<br>
>     >> On Thu, Mar 7, 2019 at 7:19 AM Sebastian Huber<br>
>     >> <<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank">sebastian.huber@embedded-brains.de</a><br>
>     <mailto:<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank">sebastian.huber@embedded-brains.de</a>><br>
>     >> <mailto:<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank">sebastian.huber@embedded-brains.de</a><br>
>     <mailto:<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank">sebastian.huber@embedded-brains.de</a>>>> wrote:<br>
>     >> For the shell, very little is really a public API. Most is<br>
>     internal.<br>
>     >> I suspect this applies in many places.<br>
>     ><br>
>     > You have rtems_shell_init() etc. functions for the public API.<br>
><br>
>     I was looking at this file today and it could benefit from<br>
>     becoming just the<br>
>     public interfaces.<br>
><br>
><br>
> Would Doxygen benefit in general from having two runs? One that is all <br>
> public<br>
> interfaces and another that is everything?<br>
><br>
<br>
Some files contain API and internal stuff. With a top-level API group it <br>
is transparent to the user what is meant for direct use in applications. <br>
Also, I was told several times that the primary user facing <br>
documentation is <a href="http://docs.rtems.org" rel="noreferrer" target="_blank">docs.rtems.org</a> and not Doxygen.<br>
<br></blockquote><div><br></div><div>Yes, we have to date focused on Doxygen as a tool for RTEMS Development itself.</div><div><br></div><div>Considering the quality of our manuals, I don't see that a DOxygen for application development would be entirely useful.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
-- <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">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>
_______________________________________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a></blockquote></div></div>