[PATCH] c-user: Add application config info directives

Chris Johns chrisj at rtems.org
Thu Sep 22 22:04:56 UTC 2022


On 22/9/2022 6:18 pm, Sebastian Huber wrote:
> On 17/09/2022 09:31, Chris Johns wrote:
>>> +.. index:: rtems_configuration_get_rtems_api_configuration()
>>> +
>>> +.. _InterfaceRtemsConfigurationGetRtemsApiConfiguration:
>>> +
>>> +rtems_configuration_get_rtems_api_configuration()
>>> +-------------------------------------------------
>>> +
>>> +Gets the Classic API Configuration Table of this application.
>> Would a comment here that the header file xxx.h describes the fields in the
>> returned structure?
> 
> The API data structures are fully specified and documented. 

We do not have doxygen links online and we do not have suitable links in a
release. So I am not sure how this helps unless you know part of all of the
answer to the question ... where is it defined?

> What is missing is
> the Sphinx documentation generation support. One option would be to add a
> "Types" section to the manager chapters and document the corresponding types in
> this section.

I was after something a little simpler. For the structs a file name the struct
is in so a user can quickly find it without needing to understand any of the
code, headers or how we do things.

Chris


More information about the devel mailing list