[rtems commit] libcsupport: GCI Doxygen Task #7

Gedare Bloom gedare at rtems.org
Thu Dec 13 12:31:57 UTC 2012


I think it makes sense to put comments derived from the POSIX
specification, but am not opposed to removing the comments and putting
a pointer to the standard in the file's header. Are there similar
files that should be treated thus?

On Thu, Dec 13, 2012 at 6:41 AM, Sebastian Huber
<sebastian.huber at embedded-brains.de> wrote:
> On 12/13/2012 12:34 PM, Ralf Corsepius wrote:
>>
>> On 12/13/2012 11:26 AM, Sebastian Huber wrote:
>>>
>>> On 12/11/2012 12:45 PM, Gedare Bloom wrote:
>>>>
>>>>   cpukit/libcsupport/include/sys/termios.h           |   13 ++++++++++++
>>>
>>>
>>> I think we should remove all documentation from this file.  This file
>>> contains a POSIX API.  We should use exclusively the documentation
>>> provided by Open Group for this.
>>>
>>> http://pubs.opengroup.org/onlinepubs/009604599/basedefs/termios.h.html
>>>
>> Please define "use".
>
>
> Use means here that we should not provide our own documentation.
>
>
> --
> Sebastian Huber, embedded brains GmbH
>
> Address : Dornierstr. 4, D-82178 Puchheim, Germany
> Phone   : +49 89 18 94 80 741-16
> Fax     : +49 89 18 94 80 741-09
> E-Mail  : sebastian.huber at embedded-brains.de
> PGP     : Public key available on request.
>
> Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.
>
>
> _______________________________________________
> rtems-devel mailing list
> rtems-devel at rtems.org
> http://www.rtems.org/mailman/listinfo/rtems-devel




More information about the devel mailing list