Heba Waly <heba.waly@xxxxxxxxx> writes: > So my proposal for this matter is to investigate the possibility of > using a doc generators that'd extract the documentations from the code > to a single doc file per library. Something like that may become necessary to bring docs in some of the *.h files up to par with D/t/api-*.txt. Note that the quality of the latter is quite uneven. The one I noticed perhaps is exceptionally well-structured (even if some of the details of its contents may have gotten stale) and to match its structure, the order of presentation in the generated doc may have to be different from the order of definitions in the header. But for the ones with poor structure with stale contents, getting rid of the stale D/t/api-*.txt and describing the API in *.h files is a vast improvement.
