public inbox for [email protected]  
help / color / mirror / Atom feed
From: David G. Johnston <[email protected]>
To: Robert Haas <[email protected]>
Cc: Peter Eisentraut <[email protected]>
Cc: Andrew Dunstan <[email protected]>
Cc: [email protected] <[email protected]>
Subject: Re: documentation structure
Date: Fri, 5 Apr 2024 09:14:56 -0700
Message-ID: <CAKFQuwaqy2XRGbw4c0kmuykfcqq+m0Byk2bzqaCikR-ZT87STg@mail.gmail.com> (raw)
In-Reply-To: <CA+TgmoY+Ew2iqNbKDsyD6Un1TjA6aBn+OCK9=EY09_ZR+DXL7A@mail.gmail.com>
References: <CA+TgmoZ2F+K0j=6BOJLD=YfpJMdJRXC7sWmtXGRjx1Rq0x8PUA@mail.gmail.com>
	<CAD5tBcJUVQu=9zpr9C+Z=3SjxrECURtr_i1oipMqke4dpZXtyQ@mail.gmail.com>
	<CA+TgmobvXwu+iJmBg3hncdjY0-agg3giP-aLi_KhDyrL9+OLew@mail.gmail.com>
	<[email protected]>
	<CA+TgmoYvQ=Oozena9qTpd3uGBuCWaMVSFD6xEd5qFeMJ5J4_pQ@mail.gmail.com>
	<[email protected]>
	<CA+TgmobTb+HEx5TiTTeXF9oPxKSFftw5R0-q1UZCpETfi7wHVA@mail.gmail.com>
	<[email protected]>
	<CA+TgmoY+Ew2iqNbKDsyD6Un1TjA6aBn+OCK9=EY09_ZR+DXL7A@mail.gmail.com>

On Fri, Apr 5, 2024 at 9:01 AM Robert Haas <[email protected]> wrote:

>
> > The rendering can be adjusted to some degree, but then we also need to
> > make sure any new chunking makes sense in other chapters.  (And it might
> > also change a bunch of externally known HTML links.)
>
> I looked into this and I'm unclear how much customization is possible.
>
>
Here is a link to my attempt at this a couple of years ago.  It basically
"abuses" refentry.

https://www.postgresql.org/message-id/CAKFQuwaVm%3D6d_sw9Wrp4cdSm5_k%3D8ZVx0--v2v4BH4KnJtqXqg%40mail...

I never did dive into the man page or PDF dynamics of this
particular change but it seemed to solve HTML pagination without negative
consequences and with minimal risk of unintended consequences since only
the markup on the pages we want to alter is changed, not global
configuration.

David J.


view thread (4+ messages)  latest in thread

reply

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: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected]
  Subject: Re: documentation structure
  In-Reply-To: <CAKFQuwaqy2XRGbw4c0kmuykfcqq+m0Byk2bzqaCikR-ZT87STg@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox