<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Sep 29, 2020 at 8:54 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 29/09/2020 15:47, Sebastian Huber wrote:<br>
<br>
> On 29/09/2020 15:42, Joel Sherrill wrote:<br>
><br>
>><br>
>><br>
>> On Tue, Sep 29, 2020 at 8:37 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>>> wrote:<br>
>><br>
>>     Hello,<br>
>><br>
>>     I work currently on the documentation of the IO Manager. What is the<br>
>>     purpose of<br>
>><br>
>>     typedef rtems_status_code rtems_device_driver;<br>
>><br>
>>     ?<br>
>><br>
>>     For me this looks a bit like camouflage.<br>
>><br>
>><br>
>> No. It is a use of typedef to make the purpose of the method clear.<br>
>><br>
>> You have nibbled at these for years. There were at least types for<br>
>> Classic Tasks, ASRs, and TSRs at one point.<br>
> Yes, the typedefs to void.<br>
>><br>
>> If this is the last one, I'm not going to fight it. This isn't the <br>
>> hill I am<br>
>> going to die on.<br>
> I am not suggesting to remove them although I find these typedefs <br>
> pretty odd. I just look for some documentation text.<br>
<br>
What about this:<br>
<br>
/**<br>
  * @ingroup RTEMSAPIClassicIO<br>
  *<br>
  * @brief This type shall be used in device driver entry declarations and<br>
  *   definitions.<br>
  *<br>
  * Device driver entries return an #rtems_status_code status code. This <br>
type<br>
  * definition helps to document device driver entries in the source code.<br>
  */<br>
typedef rtems_status_code rtems_device_driver;<br></blockquote><div><br></div><div>That's more than sufficient.</div><div><br></div><div>Thanks. </div></div></div>