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 1r7LHh-005449-0d for pgsql-docs@arkaria.postgresql.org; Sun, 26 Nov 2023 19:59:17 +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 1r7LHb-009CV9-VE for pgsql-docs@arkaria.postgresql.org; Sun, 26 Nov 2023 19:59:11 +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 1r7LHb-009CV1-Im for pgsql-docs@lists.postgresql.org; Sun, 26 Nov 2023 19:59:11 +0000 Received: from mail-ed1-x535.google.com ([2a00:1450:4864:20::535]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.94.2) (envelope-from ) id 1r7LHX-007UO3-Dd for pgsql-docs@postgresql.org; Sun, 26 Nov 2023 19:59:10 +0000 Received: by mail-ed1-x535.google.com with SMTP id 4fb4d7f45d1cf-54b1812ae1fso1778127a12.1 for ; Sun, 26 Nov 2023 11:59:06 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cybertec-at.20230601.gappssmtp.com; s=20230601; t=1701028744; x=1701633544; darn=postgresql.org; h=mime-version:user-agent:content-transfer-encoding:autocrypt :references:in-reply-to:date:cc:to:from:subject:message-id:from:to :cc:subject:date:message-id:reply-to; bh=iOjVDPm4gwHiRqJBGmzoxyvCB7iWj3gf8CGeCk+YvW4=; b=TiADC6w4Am7s6mxDT8Mm4GvRBPrPOlQID4dVsedjQJlG4gyupnC4R8R6pvy2j1pB9k AikjMGHuP9u4j7SYc+NAPT/pComaLOPNkgbZI3oZnw22heoFHaNl+6MQ9iy7Z6FB7NPG dv8efS3lhQH8oTfJzVPYOH1IZ86dhVlPABizcD9McDFGo8BOf8IoH13HRX2RGUS7C38+ BE2t8cLePE1lkGgGy8QKm9lr/xGyqL3nagXBH7t/g6UuX0wYi63o9tev0b4qBkP6UfAv lTi3iL4lgibm8hEuTxXa4Ko6nLl190M2y/dUb8GUQ5lTCe/omqUsAiAXdZey5npMBoxW KqbQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1701028744; x=1701633544; h=mime-version:user-agent:content-transfer-encoding:autocrypt :references:in-reply-to:date:cc:to:from:subject:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=iOjVDPm4gwHiRqJBGmzoxyvCB7iWj3gf8CGeCk+YvW4=; b=mV3C4F4jg0RPpU6nVlaPZmDpuM+TeFje//FQ32xv8D7rYPh6Hm02RAABf43lVvLNR3 eUolkRiwBMqIhNGBNnSd/n2tV73t0fYnIi8fHTwYN3Sss37BxxmMrMZtiXh8xIYajVzJ P+aUN/yp2zlIGiMTjwBbugjHmkdVGoeLqbzW7cX1XbXHtCMi4Fkso234H9mQ5VuKUjar yghog1WnaShJysIazt2qZTwi99L2YRk2RM0PldrLGQcfZd2N2ty6apcJrjahEPAH7G4M ZButSbQCpT5onDhNnFc2ZP549K0ARrEaDie5JxpYSKPu7o3nv/V2NWOgPKfwIy3D0gZE NDEw== X-Gm-Message-State: AOJu0Yye597NoZ5z+Kmu5s/a9WEpMq1ccVF0nX19BOtRWU48sRx087iK k95tLGQkeOONVsdhhZWCHKJsBQ== X-Google-Smtp-Source: AGHT+IHLFfsYaIOWg69Zy6jY9tOIaiAtLvk0wBrtk/p91cSXxA3mloh5ZWew/GfdTNga2tfL+IG9mw== X-Received: by 2002:a17:907:7203:b0:a01:9985:30d9 with SMTP id dr3-20020a170907720300b00a01998530d9mr7672634ejc.12.1701028743969; Sun, 26 Nov 2023 11:59:03 -0800 (PST) Received: from localhost.localdomain ([2001:871:260:ce4b:3efa:9f:2675:fc7c]) by smtp.gmail.com with ESMTPSA id r17-20020a170906a21100b009ae57888718sm4835271ejy.207.2023.11.26.11.59.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 26 Nov 2023 11:59:03 -0800 (PST) Message-ID: <043ce4b19d6ea5d4a25955643a48a29cf754631c.camel@cybertec.at> Subject: Re: [DOCS] Confusing Trigger Docs. From: Laurenz Albe To: Bruce Momjian Cc: Peter Geoghegan , neil@fairwindsoft.com, PostgreSQL-documentation , Andres Freund , Heikki Linnakangas Date: Sun, 26 Nov 2023 20:59:02 +0100 In-Reply-To: References: <20170703200710.27956.64565@wrigleys.postgresql.org> <20170831132544.GC2355@momjian.us> <103ef5b01c801d372f8aa2353aecf4fc8364bd6c.camel@cybertec.at> Autocrypt: addr=laurenz.albe@cybertec.at; prefer-encrypt=mutual; keydata=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 +AnW5l0HsQcY9ntFL/zEBOaonjdJf Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable User-Agent: Evolution 3.50.1 (3.50.1-1.fc39) MIME-Version: 1.0 List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On Fri, 2023-11-24 at 13:14 -0500, Bruce Momjian wrote: > On Thu, Nov 23, 2023 at 08:36:34AM +0100, Laurenz Albe wrote: > > On Wed, 2023-11-22 at 14:49 -0800, Peter Geoghegan wrote: > > > I don't think that your proposed wording for this is an improvement. > >=20 > > Well, the existing wording is impenetrable even for someone with some > > PostgreSQL knowledge, like me. >=20 > I moved the parition pagagraph to a more logical location and tried to > clarify the new paragraph to be more targeted on the goal, patch > attached. I cannot tell if that covers everything that the original text (which I failed to understand) did, but your wording makes sense to me. Yours, Laurenz Albe