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