Re: split func.sgml to separated individual sgml files

From: Nazir Bilal Yavuz <byavuz81(at)gmail(dot)com>
To: Andrew Dunstan <andrew(at)dunslane(dot)net>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Peter Eisentraut <peter(at)eisentraut(dot)org>, Florents Tselai <florents(dot)tselai(at)gmail(dot)com>, Euler Taveira <euler(at)eulerto(dot)com>, jian he <jian(dot)universality(at)gmail(dot)com>, "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, Corey Huinker <corey(dot)huinker(at)gmail(dot)com>, pgsql-hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: split func.sgml to separated individual sgml files
Date: 2025-10-06 08:29:56
Message-ID: CAN55FZ2bxpeR2Y91ymJv5RsM6LFvKqN5U933cMDjk+VTvYoACA@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Hi,

On Fri, 3 Oct 2025 at 18:47, Andrew Dunstan <andrew(at)dunslane(dot)net> wrote:
>
> On 2025-10-03 Fr 10:41 AM, Tom Lane wrote:
>
> Peter Eisentraut <peter(at)eisentraut(dot)org> writes:
>
> If you look at this more closely, creating postgres-full.xml and running
> the syntax check perform the same operations, except that the latter
> throws away the output. So it seems redundant to build a whole new code
> path for this. I think you can make the check target dependent on
> postgres-full.xml and be done, kind of like this (starting from
> pre-b2922562726):
>
> Would it be unreasonable to discard the "check" target altogether?
> It made sense back in the day when actually building the html docs
> took many minutes. But I haven't used it in years, so I wonder
> if anyone else has either.
>
> I have no objection. We'll need to work out what we're doing on the meson side, which is kinda where we came in ...

I can work on this but I want to clarify it first. Which one do you prefer:

1- We won't have any command to do syntax checks (including tab and
nbsp), these checks will automatically run when we generate docs.

2- We will have a 'check' target but it will only do tab and nbsp
checks; xmllint will run only when generating the docs.

--
Regards,
Nazir Bilal Yavuz
Microsoft

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tomas Vondra 2025-10-06 08:35:26 Re: Should we update the random_page_cost default value?
Previous Message Tomas Vondra 2025-10-06 08:22:11 Re: Should we update the random_page_cost default value?