On Mon, Feb 17, 2003 at 11:06:26PM +0100, Xavier Beaudouin wrote:
Seems that we (the caudium group) will have to make our own autodocs system. This is so bad we have to reinvent the wheel every time... :(
i don't think this is a "reinventing the wheel" problem, but rather an extension and integration problem.
the current autodoc system has not been designed for what we want to use it.
we do need a more generic system to embedd documentation and help into the code. however different from the pike reference documentation caudium and sTeam documentation needs to be accessible by the functions through some sort of introspection, eg to display help in the admin interface and the like and to publish that same help in an admin or user manual.
some sort of integration with the current autodoc system would be usefull, but if it can not be done, then that's that.
greetings, martin.