change log for rtems (2011-06-21)

Joel Sherrill joel.sherrill at OARcorp.com
Wed Jun 22 13:15:17 UTC 2011


On 06/22/2011 07:09 AM, Sebastian Huber wrote:
> On 06/22/2011 01:57 PM, Joel Sherrill wrote:
>> There were over 4000 warnings in the doxygen log.
> Then you should better set:
>
> WARN_IF_UNDOCUMENTED = NO
>
That covers up problems.  I would rather fix the problems and
improve the documentation over time.

I am not of the cover up warnings school of thought.
>> I started nibbling on them. I had some time to kill and wasn't in a mood to work on something more difficult.
>>
>> The sparc is used for the output on the site and it was over 200 of them. If we want Doxygen, it should be thorough
> Yes, it should be thorough, but documenting trivial stuff leads only to a lot
> of copy and paste.  It distracts also from more important things.
>
OK. If I had had more time and SPARC documentation, each register would
have more details.


-- 
Joel Sherrill, Ph.D.             Director of Research&  Development
joel.sherrill at OARcorp.com        On-Line Applications Research
Ask me about RTEMS: a free RTOS  Huntsville AL 35805
    Support Available             (256) 722-9985





More information about the vc mailing list