Feedback-ID: i0fe9450f:Fastmail
Date: Tue, 28 Jun 2022 12:55:58 +0900
From: Michael Paquier <michael@paquier.xyz>
To: Noboru Saito <noborusai@gmail.com>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>, Peter Geoghegan <pg@bowt.ie>,
	Tom Lane <tgl@sss.pgh.pa.us>,
	Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: proposal: convert comments in documents to html comments
Message-ID: <Yrp7zoI2aKpUxqu8@paquier.xyz>
References: 
 <CAAM3qnJDsT6y6t7KY=0VCtrG=uQtNuBdhiUk3vor530WbpPsFA@mail.gmail.com>
 <20220627084839.5fuankjxgt6m62vv@alvherre.pgsql>
 <CAAM3qn+QtUWDZWbiM895b70YSttm+_UkUK=WjxAsh4ou-QMDhQ@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="r5rhwmOG8x0sYxbG"
Content-Disposition: inline
In-Reply-To: 
 <CAAM3qn+QtUWDZWbiM895b70YSttm+_UkUK=WjxAsh4ou-QMDhQ@mail.gmail.com>
Archived-At: 
 <https://www.postgresql.org/message-id/Yrp7zoI2aKpUxqu8%40paquier.xyz>
Precedence: bulk


--r5rhwmOG8x0sYxbG
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

On Tue, Jun 28, 2022 at 12:42:08PM +0900, Noboru Saito wrote:
> If you want to separate hashes or add links,
> I think it would be better to stop the current comment and make it a paragraph
> (I think it is possible to keep them folded
>  when converted to html even if they are paragraphs).
> I agree with doing it that way, but it may not be possible right away.

Hmm.  Could it be better to tweak git_changelog so as the commit ID is
reordered in the contents generated then?  Then the doc rules could be
tweaked to feed on that?  I have noticed that your patch is not able
to put a commit with its correct item.  The first item of a section is
not aligned looks associated to nothing, while the last item has no
commit associated to it.
--
Michael

--r5rhwmOG8x0sYxbG
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAmK6e84ACgkQnvQgOdby
QH1irg/9GL5UGT2kOrWWAvhs6VypPr6TyRpOV7wruqwb4Io+wlUbckwn5+HzMRE0
cZmzGA80Cv6ZqVLNac4GH9kfjt9A7MHjSHfEUblvmssomAnL7i6IfADjks7kYqSo
sTRh0vkNOHlUBLc2BlBK7P2WVAKK4Uh9mWK7pMgnw9uoYJl8XjNUkol93jBm5DVt
ZjIuLjyxh1EqPeOT6Y8fgK00kuK2LUeWaxsmwKumWPqg2GAw/UXejO+Fw1BsU925
5L9qAtQgqXXv6kg+6deHzbCt1jbeG9pdR7kRbcwl/rqqtN0gZG32gu+Y3v65ZbGe
qQfaCVhRcnyy//NlHaQzuby8I8sxQ3oxt/jkXnmS93Gt+aTrY/6kVhhLHo2ZAGin
FYC1vzNcJDxw7eVORjRTkhhGVN/RgGTtRqS7+FQa+6Ur0eJj6Wk4bLJgdoow9iU3
TGYLT7uJRuihvaxEuYOsyiK18sudVjW/3R7q063opgWOTPJwXnJBzJfXEl1yJjI3
ScqG6aLbOKofLWd7zoDFqC8hDIqQxHAexNmFLE5gfmPwZBfV5m1SBQRHCzgVYCyy
E/A0+5f1GU/o7kJNPwDXvvoWTdiJYgPwLHTg60kvzVU2Z9wyDsKe6ZONR+3GMhRn
7E5Z6jzCBT0P4yk3ALFqAtTCCEJBPnaEBmyOsZwDOSPcKtwjiss=
=Ho9g
-----END PGP SIGNATURE-----

--r5rhwmOG8x0sYxbG--