On Mon, Mar 11, 2019, 9:36 AM Gedare Bloom <ged...@rtems.org> wrote: > > > On Fri, Mar 8, 2019 at 1:28 AM Sebastian Huber < > sebastian.hu...@embedded-brains.de> wrote: > >> On 07/03/2019 21:57, Joel Sherrill wrote: >> > On Thu, Mar 7, 2019 at 2:55 PM Chris Johns <chr...@rtems.org >> > <mailto:chr...@rtems.org>> wrote: >> > >> > On 8/3/19 3:24 am, Sebastian Huber wrote: >> > > On 07/03/2019 15:19, Joel Sherrill wrote: >> > >> On Thu, Mar 7, 2019 at 7:19 AM Sebastian Huber >> > >> <sebastian.hu...@embedded-brains.de >> > <mailto:sebastian.hu...@embedded-brains.de> >> > >> <mailto:sebastian.hu...@embedded-brains.de >> > <mailto:sebastian.hu...@embedded-brains.de>>> wrote: >> > >> For the shell, very little is really a public API. Most is >> > internal. >> > >> I suspect this applies in many places. >> > > >> > > You have rtems_shell_init() etc. functions for the public API. >> > >> > I was looking at this file today and it could benefit from >> > becoming just the >> > public interfaces. >> > >> > >> > Would Doxygen benefit in general from having two runs? One that is all >> > public >> > interfaces and another that is everything? >> > >> >> Some files contain API and internal stuff. With a top-level API group it >> is transparent to the user what is meant for direct use in applications. >> Also, I was told several times that the primary user facing >> documentation is docs.rtems.org and not Doxygen. >> >> > Yes, we have to date focused on Doxygen as a tool for RTEMS Development > itself. > > Considering the quality of our manuals, I don't see that a DOxygen for > application development would be entirely useful. >
I wasn't suggesting that if I started this. I was just saying the groups initially proposed had missing items in public and private 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? > > >> -- >> Sebastian Huber, embedded brains GmbH >> >> Address : Dornierstr. 4, D-82178 Puchheim, Germany >> Phone : +49 89 189 47 41-16 >> Fax : +49 89 189 47 41-09 >> E-Mail : sebastian.hu...@embedded-brains.de >> PGP : Public key available on request. >> >> Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG. >> >> _______________________________________________ >> devel mailing list >> devel@rtems.org >> http://lists.rtems.org/mailman/listinfo/devel > >
_______________________________________________ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
