Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps  (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1sUdxH-004biR-PU
	for pgsql-hackers@arkaria.postgresql.org; Fri, 19 Jul 2024 03:06:47 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.94.2)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1sUdxF-007zUb-K5
	for pgsql-hackers@arkaria.postgresql.org; Fri, 19 Jul 2024 03:06:46 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps  (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <ishii@postgresql.org>)
	id 1sUdxF-007zUS-6d
	for pgsql-hackers@lists.postgresql.org; Fri, 19 Jul 2024 03:06:45 +0000
Received: from meldrar.postgresql.org ([2a02:c0:301:0:ffff::31])
	by makus.postgresql.org with esmtps  (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <ishii@postgresql.org>)
	id 1sUdxB-000IdN-LD
	for pgsql-hackers@postgresql.org; Fri, 19 Jul 2024 03:06:44 +0000
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;
	d=postgresql.org; s=20171124; h=Content-Transfer-Encoding:Content-Type:
	Mime-Version:References:In-Reply-To:From:Subject:Cc:To:Message-Id:Date:Sender
	:Reply-To:Content-ID:Content-Description;
	bh=eiXjnoDamizDiCLfYh98+iYBcYR2BKXQPfvFggNKaXU=; b=J3ogajCe5KK5X5zsD0vXYXUmRS
	z9ADtHHnP0E7eFsK1vTAQM3phJJBcDbGGnMKI8rLObdJWmoN7/xNWGrBk6YI1AuRbkAaWHhayjWIL
	ayqD8zRMppqr/IMDleHXYwWAkSQG9H/leGTSWppCKTbCUN6RLS3DYg5UhsMeD2asyqsc82pQFphH3
	RgyRKyRBFeh/25dIos4spvF0ti2dFjAK02S188YJyJWIiXad0Cj/bIH0wf14DG5400yijW+Cw+SEZ
	+sAwR7tSvTv+qgAeLeD7RoLB3Jz+tTWx0oEFsIch5Kc221dp2qP/bd3hB/nb72Ma5FdjAwQow6LmZ
	jHh7Pm7g==;
Received: from [2409:11:4120:300:77e7:91eb:eff1:9f35] (helo=localhost)
	by meldrar.postgresql.org with esmtpsa  (TLS1.3) tls TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
	(Exim 4.94.2)
	(envelope-from <ishii@postgresql.org>)
	id 1sUdx7-000YVD-6R; Fri, 19 Jul 2024 03:06:39 +0000
Date: Fri, 19 Jul 2024 12:06:22 +0900 (JST)
Message-Id: <20240719.120622.2156939524532481759.ishii@postgresql.org>
To: andrew@dunslane.net
Cc: corey.huinker@gmail.com, jian.universality@gmail.com,
 robertmhaas@gmail.com, pgsql-hackers@postgresql.org
Subject: Re: documentation structure
From: Tatsuo Ishii <ishii@postgresql.org>
In-Reply-To: <fe4eeace-b650-4cc4-b520-0d3abfaa7035@dunslane.net>
References: <CACJufxH+Yi521QrncwnW4sFGOhPmJQpsmoJ+Ynj+VpHu5wAahQ@mail.gmail.com>
	<CADkLM=cXvybjLKQ+n3=kwFLyRp6AA9VPh_0QJvWBU2tZFmxN-g@mail.gmail.com>
	<fe4eeace-b650-4cc4-b520-0d3abfaa7035@dunslane.net>
X-Mailer: Mew version 6.8 on Emacs 26.3
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Host-Lookup-Failed: Reverse DNS lookup failed for 2409:11:4120:300:77e7:91eb:eff1:9f35 (failed)
List-Id: <pgsql-hackers.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-hackers@lists.postgresql.org>
List-Owner: <mailto:pgsql-hackers-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-hackers>
Archived-At: <https://www.postgresql.org/message-id/20240719.120622.2156939524532481759.ishii%40postgresql.org>
Precedence: bulk

> I'm opposed to having a separate file for every function. I think
> breaking up func.sgml into one piece per sect1 is about right. If that
> proves cumbersome still we can look at breaking it up further, but
> let's start with that.

That will create at least 30 func-xx.sgml files.

t-ishii$ grep '<sect1' func.sgml|wc -l
30

I am afraid that's too many?

Best reagards,
--
Tatsuo Ishii
SRA OSS LLC
English: http://www.sraoss.co.jp/index_en/
Japanese:http://www.sraoss.co.jp