[PATCH] c-user: Add application config info directives
Sebastian Huber
sebastian.huber at embedded-brains.de
Fri Sep 23 06:34:08 UTC 2022
On 23.09.22 00:04, Chris Johns wrote:
> 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?
For example:
https://git.rtems.org/rtems-central/tree/spec/rtems/config/if/api-table.yml
>
>> 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.
It wouldn't be hard to generate some documentation for types. There are
some options to do this.
Do we want a single chapter with all Classic API types?
Do we want a section per manager for the types?
Which types should be documented?
I would document them in a single chapter and only structs.
--
embedded brains GmbH
Herr Sebastian HUBER
Dornierstr. 4
82178 Puchheim
Germany
email: sebastian.huber at embedded-brains.de
phone: +49-89-18 94 741 - 16
fax: +49-89-18 94 741 - 08
Registergericht: Amtsgericht München
Registernummer: HRB 157899
Vertretungsberechtigte Geschäftsführer: Peter Rasmussen, Thomas Dörfler
Unsere Datenschutzerklärung finden Sie hier:
https://embedded-brains.de/datenschutzerklaerung/
More information about the devel
mailing list