<div dir="auto"><div><br><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Mar 11, 2019, 9:36 AM Gedare Bloom <<a href="mailto:gedare@rtems.org">gedare@rtems.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><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" target="_blank" rel="noreferrer">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" rel="noreferrer">chrisj@rtems.org</a> <br>
> <mailto:<a href="mailto:chrisj@rtems.org" target="_blank" rel="noreferrer">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" rel="noreferrer">sebastian.huber@embedded-brains.de</a><br>
> <mailto:<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank" rel="noreferrer">sebastian.huber@embedded-brains.de</a>><br>
> >> <mailto:<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank" rel="noreferrer">sebastian.huber@embedded-brains.de</a><br>
> <mailto:<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank" rel="noreferrer">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 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></div></div><div dir="auto"><br></div><div dir="auto">I wasn't suggesting that if I started this. I was just saying the groups initially proposed had missing items in public and private </div><div dir="auto"><br></div><div dir="auto">FWIW I think there are still a few POSIX header files in cpukit. Do we want all to migrate to newlib? What's the rule if we don't?</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"><div dir="ltr"><div class="gmail_quote"><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" 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>
_______________________________________________<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>
</blockquote></div></div></div>