Re: DoxyGen Style Kernel API reference.
Sascha Wildner wrote:
> Brian Gianforcaro schrieb:
>> Depending on how nice you want the documentation to be, and how good
>> the existing documentation is.
>>
>> I'd be more than willing to put all my effort into modifying the
>> existing comments to be doxygen compliant, if this what is finally
>> decided.
> Maintaining man9 and doxygen in parallel? I think there is even less
> chance that developers will care about both man9 & doxygen than taking
> care of man9 alone.
I actually don't think so. Docs can be copied from the doxygen to the
man page format.
I worked on the linux source in the last days, and I have to say that
proper doxygen comments are *really* helpful for navigating in unknown code.
I strongly support Brian's enthusiasm and suggest just going forward and
doing it. Let's see how it is working out. The more documentation the
better. I don't think we should turn this into a lengthy discussion.
cheers
simon
討論串 (同標題文章)
完整討論串 (本文為第 13 之 18 篇)：