From: Michael Paquier <michael@paquier.xyz>
To: Noboru Saito <noborusai@gmail.com>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Peter Geoghegan <pg@bowt.ie>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: proposal: convert comments in documents to html comments
Date: Tue, 28 Jun 2022 12:55:58 +0900
Message-ID: <Yrp7zoI2aKpUxqu8@paquier.xyz> (raw)
In-Reply-To: <CAAM3qn+QtUWDZWbiM895b70YSttm+_UkUK=WjxAsh4ou-QMDhQ@mail.gmail.com>
References: <CAAM3qnJDsT6y6t7KY=0VCtrG=uQtNuBdhiUk3vor530WbpPsFA@mail.gmail.com>
<20220627084839.5fuankjxgt6m62vv@alvherre.pgsql>
<CAAM3qn+QtUWDZWbiM895b70YSttm+_UkUK=WjxAsh4ou-QMDhQ@mail.gmail.com>
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
Attachments:
[application/pgp-signature] signature.asc (832B, ../Yrp7zoI2aKpUxqu8@paquier.xyz/2-signature.asc)
download
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: michael@paquier.xyz, noborusai@gmail.com, alvherre@alvh.no-ip.org, pg@bowt.ie, tgl@sss.pgh.pa.us, pgsql-docs@lists.postgresql.org
Subject: Re: proposal: convert comments in documents to html comments
In-Reply-To: <Yrp7zoI2aKpUxqu8@paquier.xyz>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox