On Wed, 23 Dec 2009, Joern Rennecke wrote: > I've attached what I have so far.
If you want to have documentation extracted from source files, you need to engage with the SC and FSF at an early stage to get suitable license exception wording to permit the relevant text to be used in the manuals as well as the main (GPL) sources. Of course, the ordering and (especially) section divisions in the internals manual are human-designed not arbitrary so you need to retain the ability to put the documentation of each hook in an appropriate position in an appropriate section of the manual. If you can make this work it should reduce the risk of people not documenting new hooks, but for it to work the FSF agreement is critical as is ensuring it genuinely works as well as the existing system without regressions (including working in update_web_docs). -- Joseph S. Myers jos...@codesourcery.com
