On Wed, 2009-05-20 at 01:08 -0700, Zach Welch wrote: > Hi all, > > I want to get the style guide up-to-date. Here's my plan. > > Barring any objections, I will add doc/manual/style.txt by moving the > relevant bits out of openocd.texi. The style guide is for developers > working on the code; the user guide should not need to mention the code. > though that may take some time. > > I will then patch the new file with some pending changes that I made > when style topics were being discussed in the past month. That patch > includes a list of those C99 features that the community seemed to think > would be acceptable. Others can then choose to revisit my revisions or > to expand this section in its new location. > > In the process, I will revisit my changes to add another section to > provide some rules for typedefs, though I have seen that this needs to > be filled out have some discussion. What should the typedef rules be?
In r1895-1897, I have done most of what I said I would do above, but -- amusingly -- I did not get around to revisiting the typedef sections. I intend to end all future "style wars" by updating the guide once a consensus has been reached by the community. [[This includes any flames sparked by my updates to the guide.]] If agreement proves intractable, the maintainers may need to make executive decisions. I hope this will help improve the code over time. Cheers, Zach _______________________________________________ Openocd-development mailing list Openocd-development@lists.berlios.de https://lists.berlios.de/mailman/listinfo/openocd-development
