Re: [PATCH] Explain what the default output_plugin_libraries do

On Mon, Sep 21, 2026 at 11:09 PM Chao Li <li(dot)evan(dot)chao(at)gmail(dot)com> wrote:
> I tried to build the HTML page, and see that <xref linkend="guc-output-plugin-libraries-builtins”/> is rendered as “Table 19.2”, so it looks like “(Table 19.2 documents ….)”,

Right. (I've attached a sample screenshot for everyone.)

> which looks a little awkward.

Any particular reason?

> How about not using parentheses, and just say something like: See <xref linkend="guc-output-plugin-libraries-builtins"/> for the effects of removing these plugins from the list.

Mm, it's easier for my brain to figure out *why* we're saying it with
the parenthetical, because it's meant to be an aside. "If you're
motivated to remove these, maybe take a look at what they do first.
Otherwise, don't worry about it and keep reading." It's the sort of
thing a book might use a footnote for, but it's really difficult to
use footnotes well on these pages.

--

Thanks everybody for the reviews! v2 has the backpatchable piece. It
doesn't incorporate Kuroda-san's suggested new section from upthread,
since that's master-only and can be committed separately once we have
the wording we like.

--Jacob