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 1tVDRw-006Txw-BZ for pgsql-hackers@arkaria.postgresql.org; Tue, 07 Jan 2025 17:33:04 +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 1tVDRv-0064Ir-Im for pgsql-hackers@arkaria.postgresql.org; Tue, 07 Jan 2025 17:33:03 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1tVDRv-0064IU-8t for pgsql-hackers@lists.postgresql.org; Tue, 07 Jan 2025 17:33:02 +0000 Received: from mail-yb1-xb2d.google.com ([2607:f8b0:4864:20::b2d]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.96) (envelope-from ) id 1tVDRt-000MiX-08 for pgsql-hackers@postgresql.org; Tue, 07 Jan 2025 17:33:02 +0000 Received: by mail-yb1-xb2d.google.com with SMTP id 3f1490d57ef6-e4419a47887so20058551276.0 for ; Tue, 07 Jan 2025 09:33:01 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1736271181; x=1736875981; darn=postgresql.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=VPIjR/8217oTwrCs1V2f1uHts/9feIo0BdxQWZFEVd0=; b=OI7wZr554EP3eGIlLFpQ6AgBtHFzkHmA4PAfN9dTAH9v8Ucbe41OnGWnSQM0XZu1WS jDparHFHdVTV0ilSrAGfKwfLTzsw8w5Qjdc9KQYAMQafiNY/YsyZOlGVMBXmGQcslhnX uu9Swg95h9rM0GVshSccEJ+SI+VGrguMw9qoaCVhnzYGTl3oxPquCwj4tggpt3OfQ0UD gjU2YqzFhK1w/spmJNkuu0x9XexRVpoUPsaFPtC6V6PmFpBdzjHmnJCSZiejnAJj4IUC YF/Svspg+xKBq/EHPrSluAK27wRJUyy/s36cPCjD9KCfB/uAwUbbTAyflkVki/NcBgq4 5u5g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1736271181; x=1736875981; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=VPIjR/8217oTwrCs1V2f1uHts/9feIo0BdxQWZFEVd0=; b=HVR9Iwrz5Uck5wHqFwd2FNbiV3IGtjw776Xf2vDmcuurTsrMjCaNI7jx0aeVoktNLH W5VAepSYLHxEUWFdxocFw7clqH6N0fZIUt56BCRowlXMRI38iihqOHlbAQmNXSzm2P4V v9di/IPzHKrc3ZAc6HRtniNFVMNMVMq6F23BlJ2egl+SDXcNhoUXbDSBxKPWXP3Hg3+v Dei21TXhgjzQ1UyWIhFzN1v7zs5DzQjjusWcjoBIk6jZ8ZJvJV9/OoeNZzSo7kRlofuC xomI1uapqIumiOfjvwTyPLt5aAzaKxpvwK453H55mJFiPWS/nNVzP0v0dD3KksLaJHFg bOnQ== X-Forwarded-Encrypted: i=1; AJvYcCXTEsgDFUN4gUPTNMwYZ2+HW84fWsTSi9Kx/CXoyHHzWRdYFwHW5+MJgrl/8j+BnKx2iWh1zOF364lvwI0S@postgresql.org X-Gm-Message-State: AOJu0YwtQLtQ7p5zLfcype36Q8+umIVjGnoCvwwOia7brcCvpVq2dw+N sGP4g4wNCKwxw2dSgKudtxLcx1341gQC8qJgbEMMFOgnageYBLRZ7CGL9w== X-Gm-Gg: ASbGncv2bVHNCXhPRWK54hXG2qEe09fFOUXAlfRS2T/6dBx9y6WI5JLwM19j5twx9iL qhA8jMKjcM78AHN3TyyuTit2uJ2jP1AwgK3Pv/Y55q+1gQ1NtyoVyC0pU/In/20vg0F2bkG2/VE Tx61mqX6Q6OMjEWZOxcaW8b6k82/TECHU9j/kiBPxm1kWwaTrXIUqV4YONXz3az9Rq/kAdWYAUz c//MANrB/FJ0q0Cf2aJ10cKOYcfPHbIZuCX+uSunGBVxL1U3FOV9oV54dNzKiOx0a1B7g8SHA4i Rq/E8YoHQu78Dqz6s1IxXnHmm5pdqoSKeN+baI7Wi2gxLLg= X-Google-Smtp-Source: AGHT+IGaIMS9BlQHqhZDnpKXNl914EHCk6oGwqtpipRd2RK4/WLwzt4kfupyYgrDSsFRo9BVAbjSvg== X-Received: by 2002:a05:690c:25c2:b0:6ef:910d:7847 with SMTP id 00721157ae682-6f3f8135bdbmr493548337b3.24.1736271180731; Tue, 07 Jan 2025 09:33:00 -0800 (PST) Received: from nathan (162-195-168-172.lightspeed.stlsmo.sbcglobal.net. [162.195.168.172]) by smtp.gmail.com with ESMTPSA id 00721157ae682-6f3e77ed58dsm90175477b3.94.2025.01.07.09.32.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 07 Jan 2025 09:32:59 -0800 (PST) Date: Tue, 7 Jan 2025 11:32:58 -0600 From: Nathan Bossart To: Melanie Plageman Cc: Tom Lane , Pg Hackers Subject: Re: Moving the vacuum GUCs' docs out of the Client Connection Defaults section Message-ID: References: <1373018.1736213217@sss.pgh.pa.us> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On Tue, Jan 07, 2025 at 12:15:17PM -0500, Melanie Plageman wrote: > This is my first docs patch that introduces new sections and such, so > I'm not sure I got the indentation 100% correct (I, of course, tried > to follow conventions). I haven't reviewed the patch in depth, but I think it's worth considering whether this change will break any links that work in one version but break if you change the version number. I believe appendix-obsolete.sgml is designed to help with that a bit, but I've had mixed results when I've tried to use it. Of course, it's also possible that we don't care too much... But overall, consolidating the docs for the vacuum GUCs seems like a good idea. -- nathan