>> 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.