They rely on parsing the code to find the comments that document the code. A noble goal that allows it to compare the documentation to what it knows about the code, but the current implementation is very fragile.
That, and you have Oliver's document on how they work. It probably should not be the case that the documentation tools are more complex than the compiler... On 2006-05-16, at 15:50 EDT, Benjamin Shine wrote: > > With some trepidation I ask... what's the story with the doc tools as > a black box? > What do they do wrong that we want them to do differently? > What currently desperately needs to be fixed? > What would it be nice to fix? > What would it be nice to change? > What would it be nice to add? > > Here is a teapot. > > > benjamin shine > software engineer > [EMAIL PROTECTED] > > > > _______________________________________________ > Laszlo-dev mailing list > [email protected] > http://www.openlaszlo.org/mailman/listinfo/laszlo-dev _______________________________________________ Laszlo-dev mailing list [email protected] http://www.openlaszlo.org/mailman/listinfo/laszlo-dev
