>> I wish you'd stop proposing the lex filter so that we can discuss the
>> Doxyfile.in file and the accompanying Meson rule.

I see no obstacle to discussing Doxyfile.in and the meson.build file. Your 
suggestions are welcome. If you can find the original Doxyfile, it
would make sense to incorporate it.

>> but having something that purports to display our source code and
>> then show something that is*not* our source tree sounds insane.

The filter enables doxygen to interpret Postgres comments. Any code displayed 
is the original code, not the filtered code.

>> Speaking from my personal point of view, I make very little use
>> of our Doxygen pages,

Same for me. The pages are missing critical information, such as function 
descriptions and descriptions of structure fields. This filter is an attempt at 
fixing those problems.

Of course, nothing will fix doxygen when there are no comments to begin with. 
If we want comprehensive doxygen output, we need to add comments. However, we 
don’t need to add those irritating extra symbols.


Reply via email to