could you give an example of how code to use that api might look like?
the thing that i am concerned about is, that people would have to make sure they use the right way, if they want to provide the docs and a simple compile_file() or compile_string() or even cast to program would not cut it anymore.
i'd like to be able to go into any existing pike application, add a setting or line of code in the beginning and then be sure to not miss any docs from there on.
btw, i am also considering to extend the doc parser to create structures for classes and functions that have no docs, because even without a description, being able to look up a function definition can be helpful. (and i remember that someone has asked for such a feature in the past)
greetings, martin.