Horton

Re: split func.sgml to separated individual sgml files

Bruce Momjian <bruce@momjian.us>

View thread View on postgr.es
From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Peter Eisentraut <peter@eisentraut.org>, Nazir Bilal Yavuz <byavuz81@gmail.com>, Andrew Dunstan <andrew@dunslane.net>, Florents Tselai <florents.tselai@gmail.com>, Euler Taveira <euler@eulerto.com>, jian he <jian.universality@gmail.com>, "David G. Johnston" <david.g.johnston@gmail.com>, Corey Huinker <corey.huinker@gmail.com>, pgsql-hackers <pgsql-hackers@lists.postgresql.org>
Date: 2025-10-06T16:37:43Z
Lists: pgsql-hackers 
On Mon, Oct  6, 2025 at 11:13:24AM -0400, Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > Uh, more accurately I run:
> 
> > 	make --silent postgres.sgml
> > 	make --silent check
> > 	make check-tabs
> 
> If we included the tabs/nbsp checks in the normal build, then the
> first of those would cover everything.  Even as it is, I don't
> think the "make check" step is adding anything.

Looking at my test code, I do

	$ make postgres.sgml
	make: Nothing to be done for 'postgres.sgml'.

and my shell comment says it is so configure runs and can check that
works first, but it looks like it now does nothing.

I agree the "make --silent check-tabs" doesn't add anything because that
is already part of 'make check'.

I still would like to run checks without building the HTML.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Do not let urgent matters crowd out time for investment in the future.

Commits

  1. Revert "Improve docs syntax checking"

  2. Improve docs syntax checking

  3. Teach doc/src/sgml/Makefile about the new func/*.sgml files.

  4. Split func.sgml into more manageable pieces

  5. Doc: add check to detect non-breaking spaces in the docs.