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 ) id 1rsmHA-009BuZ-4N for pgsql-hackers@arkaria.postgresql.org; Fri, 05 Apr 2024 16:18:48 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1rsmH9-001yeK-9X for pgsql-hackers@arkaria.postgresql.org; Fri, 05 Apr 2024 16:18:47 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1rsmH9-001yeC-0G for pgsql-hackers@lists.postgresql.org; Fri, 05 Apr 2024 16:18:47 +0000 Received: from mail-lj1-x22f.google.com ([2a00:1450:4864:20::22f]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.94.2) (envelope-from ) id 1rsmH6-000ofa-07 for pgsql-hackers@postgresql.org; Fri, 05 Apr 2024 16:18:46 +0000 Received: by mail-lj1-x22f.google.com with SMTP id 38308e7fff4ca-2d718efedb2so41090891fa.0 for ; Fri, 05 Apr 2024 09:18:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1712333923; x=1712938723; darn=postgresql.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=/S0y+dfoyrSQzmfQG3KHBXbFrC1OqsGr5tnPWBrrg+Y=; b=eSRebuw5GwC70thVEI/4mTQB0SMnioAVoShPizAhRQWLZDEuuZRoyUoWVwRhw++oLT G7WXOs8jDLXuqrV4St2asiLT+cPAUe8XKyjFKboWJ7sOPPXkJfwN/KFeqCoHltiPGtHP e2lgBR3x5Qzok2KTRQvkz74WV2TbyvK9UhzwcxlFB3u1m9LlgIVNLTkCPY6KZGeRNc18 CH3yi42eG4E1xrIJvOa0m4voksqjOPx4jQTOUzIQtR+rVIp+M3WWJaX4Ubedksv+b7fS V6heVJtVUbX/J0NqDjlW7vaG5z07wEHYzbBRBCnjR1g3p/IPCy2IedA1DGPb1p5myRYv IM9A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1712333923; x=1712938723; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=/S0y+dfoyrSQzmfQG3KHBXbFrC1OqsGr5tnPWBrrg+Y=; b=wfVBgCzsfHLOfSD2nN8rgr5uJUxDaPDOABAHjGH73peIW3TPatjyU2e1Jq36U9FJqz c2hhSf1jSvpySO3tVRo6sihxzzRDlKwRaPRObyTpiWZUoI03XUGccZe1sG4ESWw0mVdz NhU+626pBRjYYtHMK034yw78MFUVVD3vVFveXqIxO0+EZOCFC0veLvjd31Reu7fgA373 F5lyD6Zvuse/P30EmEkAEIdCq/H3bzPT2hIkxePPvRIsxh0B6Bzg3T04n9m5KN1jwSk2 9NeONrouhuS5nyvubtYYdqxgUBUq8QWBWQ5Nej/TQ4RHJCT0bYbbnBcpwGLz3vXCot/B g5Sg== X-Forwarded-Encrypted: i=1; AJvYcCU+QJCDnfnh0NfUjgdz9lpSfpQaiH/Vi5MXv9ZC/MYfluy9TgojfanorD5ljdWa2j5D2WmQXovZS/6k2dMp57u7QpcWiw+FpmhR4Ixk X-Gm-Message-State: AOJu0YxOeau1MfLNMFf5naVM4kp14xbCvZJJ+QdH/xZqCD08rhwNuANN ygqmEf52qW6gYBtIyPHJki//f2VVGA0ZSPSZAe6PU4OEaa+a1MEQOF/OIfWzZh7Z7UwzNCoyDRr Obxo6FEqMRRBodPMa6rGiGlK3TzA= X-Google-Smtp-Source: AGHT+IFGbpRG0ykibfjS4EPo+eXJ250h1b4OROBSwZ7w0iwKKnyHtqLRhwWRPp5drdynjdVP4ZGJtxUv2yvhKItQLCc= X-Received: by 2002:a05:6512:475:b0:515:bfaa:fa12 with SMTP id x21-20020a056512047500b00515bfaafa12mr1828567lfd.22.1712333922764; Fri, 05 Apr 2024 09:18:42 -0700 (PDT) MIME-Version: 1.0 References: <33e82e2a-3954-4c1e-8114-ffbd8dfb5293@eisentraut.org> <682e11bd-07b9-4d8b-8bef-4990a13e0d22@eisentraut.org> In-Reply-To: From: Robert Haas Date: Fri, 5 Apr 2024 12:18:30 -0400 Message-ID: Subject: Re: documentation structure To: "David G. Johnston" Cc: Peter Eisentraut , Andrew Dunstan , "pgsql-hackers@postgresql.org" Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On Fri, Apr 5, 2024 at 12:15=E2=80=AFPM David G. Johnston wrote: > 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%3D8Z= Vx0--v2v4BH4KnJtqXqg%40mail.gmail.com > > I never did dive into the man page or PDF dynamics of this particular cha= nge but it seemed to solve HTML pagination without negative consequences an= d with minimal risk of unintended consequences since only the markup on the= pages we want to alter is changed, not global configuration. Hmm, but it seems like that might have generated some man page entries that we don't want? --=20 Robert Haas EDB: http://www.enterprisedb.com