>> 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 discover
On Mon, Feb 5, 2024 at 05:29:08PM +, John Morris wrote:
> >> It seems something you want to keep for your personal use.
>
> >> I think this filter is the kind of genious idea that it's OK if you
>
> >> can do it at home
>
> I don’t agree with your characterization.
>
> The purpose of the
Update: another patch with 1) suggested changes, 2) delete old html before
generating new, and 3) added flex names for the more complex regular
expressions.
Exercising the “ninja doxygen” command, brought up some issues.
1. The generated html directory contained old as well as new pages.
Th
>> We also have a handful of .cpp files.
Fortunately, our .cpp files are simple and do not include C++ specific features.
We shouldn’t have any problem adding .cpp to the filter list.
At some point it will be necessary to support general C++, but I wasn’t
planning to do it yet.
>> This file isn'
Hi,
On 2024-02-08 18:30:01 +, John Morris wrote:
> +FILTER_PATTERNS= *.c *.h
We also have a handful of .cpp files.
> +/*
> + * Custom banner character to be removed from comments.
> + * We'll hardcode it to suit postgreSQL, but it should be set through a
> command line arg.
> + */
>
>> I think all the explanatory messages in doc/doxygen/meson.build
>> are a bit much. I think it's enough to just not define the target
Here is a patch with an updated meson.build as you suggested. I agree the
messages were a bit much.
On the other hand, I would like to see clear error messages
>> Maybe this is something that can be tweaked on the doxygen side?
I’ll look into that idea. Doxygen is a separate project with its own developers
to persuade. I could imagine a special “C” or “C++” mode. I wanted to keep
things simple, and the filter mechanism is how they extend doxygen to sup
>> I think all the explanatory messages in doc/doxygen/meson.build
>> are a bit much. I think it's enough to just not define the target
>> when the required conditions (dependencies, options) are not there.
>> Maybe something like docs_pdf can serve as an example.
Makes sense, and it is simpler.
L
On 02.02.24 01:19, John Morris wrote:
Here is the updated patch. It should fix the meson issue when no doxygen
is present.
I think all the explanatory messages in doc/doxygen/meson.build are a
bit much. I think it's enough to just not define the target when the
required conditions (dependenc
On 05.02.24 18:29, John Morris wrote:
The purpose of the filter is to bring existing Postgres comments into
the doxygen output. While I haven’t done a full survey, the majority of
Postgres code has comments describing functions, globals, macros and
structure fields.
Currently, those comments
>> It seems something you want to keep for your personal use.
>> I think this filter is the kind of genious idea that it's OK if you
>> can do it at home
I don’t agree with your characterization.
The purpose of the filter is to bring existing Postgres comments into the
doxygen output. While I ha
>> 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 incorpora
On 2024-Feb-02, John Morris wrote:
> Here is the updated patch. It should fix the meson issue when no
> doxygen is present.
I wish you'd stop proposing the lex filter so that we can discuss the
Doxyfile.in file and the accompanying Meson rule.
I think there's pretty much zero chance that we'd ac
Here is the updated patch. It should fix the meson issue when no doxygen is
present.
doxygen-v3.patch
Description: doxygen-v3.patch
On Thu, 18 Jan 2024 at 06:39, vignesh C wrote:
>
> On Tue, 7 Nov 2023 at 12:23, John Morris wrote:
> >
> > Another update, this time with an abbreviated Doxyfile. Rather than
> > including the full Doxyfile, this updated version only includes modified
> > settings. It is more compact and more l
On Tue, 7 Nov 2023 at 12:23, John Morris wrote:
>
> Another update, this time with an abbreviated Doxyfile. Rather than including
> the full Doxyfile, this updated version only includes modified settings. It
> is more compact and more likely to survive across future doxygen versions.
Meson buil
Another update, this time with an abbreviated Doxyfile. Rather than including
the full Doxyfile, this updated version only includes modified settings. It is
more compact and more likely to survive across future doxygen versions.
* John Morris
doxygen_v2.patch
Description: doxygen_v2.patch
On 14.10.23 21:54, John Morris wrote:
Thank you for trying the patch out and commenting on it.
Thank you! I even didn't know such filters are possible, and after that
googling filter for C/C++ didn't gave good results.
I'm starting to think of it as a project. Here's a quick project stateme
Thank you for trying the patch out and commenting on it.
I'm starting to think of it as a project. Here's a quick project statement.
The purpose is to generate improved Doxygen output while making maximal use of
how Postgres currently does program comments.
Thinking in terms of specific steps,
On 07.10.23 00:23, Bohdan Mart wrote:
On 07.10.23 00:29, postg...@coyotebush.net wrote:
Sometime earlier, I created a filter to annotate regular C comments as
doxy
comments. I'll attach it along with a sample doxyfile for running
it. Just
in case it looks useful.
I've never been a big fan
On 07.10.23 00:29, postg...@coyotebush.net wrote:
Sometime earlier, I created a filter to annotate regular C comments as doxy
comments. I'll attach it along with a sample doxyfile for running it. Just
in case it looks useful.
I've never been a big fan of Doxygen, but it seems to have gotten
Sometime earlier, I created a filter to annotate regular C comments as doxy
comments.
I'll attach it along with a sample doxyfile for running it. Just in case it
looks useful.
I've never been a big fan of Doxygen, but it seems to have gotten better over
time.
Now that some editors are display
Sometime earlier, I created a filter to annotate regular C comments as doxy
comments. I'll attach it along with a sample doxyfile for running it. Just
in case it looks useful.
I've never been a big fan of Doxygen, but it seems to have gotten better
over time. Now that some IDEs display doxy comm
On 07.10.23 00:06, Bruce Momjian wrote:
On Fri, Oct 6, 2023 at 10:50:25PM +0300, Bogdan Mart wrote:
> On 2008-06-02 18:33:42 Stefan Kaltenbrunner wrote:
>>
>> Zdenek Kotala wrote:
>>> Xin Wang napsal(a):
Hi,
I don't know where I can find the doxyfile which generate
"doxygen.pos
On Fri, Oct 6, 2023 at 10:50:25PM +0300, Bogdan Mart wrote:
> On 2008-06-02 18:33:42 Stefan Kaltenbrunner wrote:
> >
> > Zdenek Kotala wrote:
> > > Xin Wang napsal(a):
> > >> Hi,
> > >> I don't know where I can find the doxyfile which generate
> > >> "doxygen.postgresql.org" web site. I found that
On 2008-06-02 18:33:42 Stefan Kaltenbrunner wrote:
>
> Zdenek Kotala wrote:
> > Xin Wang napsal(a):
> >> Hi,
> >> I don't know where I can find the doxyfile which generate
> >> "doxygen.postgresql.org" web site. I found that when reading code the
> >> doxygen source code is quite helpful. However,
26 matches
Mail list logo