Re: Where can I find the doxyfile?

From: John Morris <john(dot)morris(at)crunchydata(dot)com>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, vignesh C <vignesh21(at)gmail(dot)com>, Bohdan Mart <mart(dot)bogdan(at)gmail(dot)com>, "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>, "postgres(at)coyotebush(dot)net" <postgres(at)coyotebush(dot)net>, Stefan Kaltenbrunner <stefan(at)kaltenbrunner(dot)cc>
Subject: Re: Where can I find the doxyfile?
Date: 2024-02-16 20:28:59
Message-ID: CYXP222MB0947E23678AD5016D7C672B7A04C2@CYXP222MB0947.NAMP222.PROD.OUTLOOK.COM
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

>> I have found it very strange that a tool like doxygen which can create
>> all sorts of call graphs, just ignores some comments. The comments
>> above function are very important.

I agree with you . I hated doxygen for decades because of the irritating annotations it required. When I discovered IDEs were creating doxygen-like popups from conventional comments, I tried to figure out what they were doing. In the process, I discovered filters, and I created a filter to match what I thought the IDEs were doing.

(As it turns out, IDEs implement their own rendering independent of doxygen.)

I find it ironic I’ve gone from being a long-time hater of doxygen to being its advocate.

* John Morris

Tiny tidbit of history. Back in the 70’s, I created a comment extractor for the language Ratfor. We used it to maintain an alphabetical index of functions and to display pseudo-code. We drew our call graphs by hand and saved them in manila folders. Hard to imagine now.

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message David G. Johnston 2024-02-16 20:31:25 Re: Change COPY ... ON_ERROR ignore to ON_ERROR ignore_row
Previous Message Heikki Linnakangas 2024-02-16 20:24:21 Re: PGC_SIGHUP shared_buffers?