From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI,MIME_QP_LONG_LINE, RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 21574 invoked from network); 29 Jun 2021 14:51:26 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 29 Jun 2021 14:51:26 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1624978286; b=QAULrW+8X0YVc+ltxsc7q0Sjf91L9dExoKqvj7yyYjvx6ajF7KO74GR7aii2GZzNp3oIeahj6O r427FaXpT0NKyDgjxN3FH0xoJphjWL9bTmFAt4KwvpFu54M63SI5SiBp6DVgU8yRcHTbfhLatf bQZMLq8nClr4DzZDKe3XG5RC27O/cyjhV5QdH9LTPztFZsi8xtn3Kn7e44HolIq50Rv7lREYne xgmTMLQq6WMT/h7Hk0AIJSXz1PTVODSd34rvSRw+Si0g5XDPDAN/mqyaKc/Fn1RKBnL0YWX97o 4eKXAi5kE1hM6VCvYHiZfKVUqNNbJQGF/Fie6Nq1Ox+hJg==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-lf1-f46.google.com) smtp.remote-ip=209.85.167.46; dkim=pass header.d=gmail.com header.s=20161025 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20200801; t=1624978286; bh=xgYoB6CVl0SaXm8xPfXjqw0BW992XlNAOd8jmh7b5OA=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:To:In-Reply-To:Cc:References:Message-ID:Date:Subject: MIME-Version:From:Content-Transfer-Encoding:Content-Type:DKIM-Signature: DKIM-Signature; b=tRi8DR/9Wi00VGwtqIJvA6kT45Gijuak1IP9PaqqL81/sa6fvgZHlpSxPGUDO5qFmZdWjDpINy Jizy/1iXu5wfsKaIyFniDzUi47yJ9J5mdP1B9ZKSYE+4z24oWvibj7BtUF3YV3VMGoWyqi2Ahy UPIFo6IWnyj48lZcqdhABlOohFvrCALPWcNora4TWCdi3VWlLvqbseNQ/PAV0cKlxgIug6hR/6 iUPoNRrGgB4SQfTr+a+LBQ4CdxqDvD0SqrWpWkDWksBY/DnE5DRwazQIi30RhjLMh29VBljEGp 1Nm97HgQlQEFkioMcPH7T3bdZEKwt+kFrxymJVE0SQ5NXA==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20200801; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:To:In-Reply-To:Cc:References: Message-Id:Date:Subject:Mime-Version:From:Content-Transfer-Encoding: Content-Type:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=xgYoB6CVl0SaXm8xPfXjqw0BW992XlNAOd8jmh7b5OA=; b=OTIb0g5RUWpTg3Ptyx5KA8vxfN R5AT4gzbSf6I2CR+GS1oYOtoYfyAEUtinuCXqnLfMQf5dxnhBYf8iw52BKkqX2I1UCXQ5/Fgjqedl FfuAX7C3rED8/ILt56UkQcpQl7s9efJkJl0Z5JoPZIqr+Og1WeKYVaHEJuXOb6ID1HUtARdp0pjKL H4uReHjJam7f1a7N5DzRgv2V6f20+uIkUkVqswD/FcZNAKpXrOXb7BPcFu7ADvD2TPlB81c3sL8bU 5eOQYP+ftmTkSokZkpjMdO6nO4UVN74rH2YKJDWcDcXDV0KHSRiGelq3oTefyqSemVr5spbAyJF/5 gYGomIJA==; Received: from authenticated user by zero.zsh.org with local id 1lyF5B-000BlL-1S; Tue, 29 Jun 2021 14:51:25 +0000 Authentication-Results: zsh.org; iprev=pass (mail-lf1-f46.google.com) smtp.remote-ip=209.85.167.46; dkim=pass header.d=gmail.com header.s=20161025 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none Received: from mail-lf1-f46.google.com ([209.85.167.46]:45905) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1lyF4d-000BVF-Ou; Tue, 29 Jun 2021 14:50:52 +0000 Received: by mail-lf1-f46.google.com with SMTP id h15so39891483lfv.12; Tue, 29 Jun 2021 07:50:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=content-transfer-encoding:from:mime-version:subject:date:message-id :references:cc:in-reply-to:to; bh=xgYoB6CVl0SaXm8xPfXjqw0BW992XlNAOd8jmh7b5OA=; b=eoyyqq4VmwtAWz8gs4pbr+7gqxVLpENg2ZRH2xC1dbwwDI+UB6osup037TaWduFIYZ N7C6QjkNLlP2cyJHrNHYfW2loxzHq71a+ttCcH7Vn2KqXFs+SQ3UfiPIKe5npKoJF5N3 Snl8j8thpiae6tGzgoosHrXJtWBhCvhtRdDWVi/H15aREiL3Qno/xR7kkg1F73GsjNYI V4BqoRCi2tDFd5piz0ZNxlZuIxif0UEI/deB8AUv7ivWim5cWc2OFIZJGmWxzfJrr1aV UsEPyEU5qy2Qk6INwgS8M36Fk2zbSEVCtElpjVY3sm0j6TJFNMCezufzagViYTnaRvZ3 RnvA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:content-transfer-encoding:from:mime-version :subject:date:message-id:references:cc:in-reply-to:to; bh=xgYoB6CVl0SaXm8xPfXjqw0BW992XlNAOd8jmh7b5OA=; b=EUCeWiYdg+loogaUgSnYN6njj3VFrTemH3At/Wllb9e/W9hSLzjfy9wI5zegxlHhQn Ur+wgEhi+5DDU1yGB34ZDDW+6f/1Ban3x/mCNBp8TfY9vP9ghCsHWPRNQ+lHFUCVbpMY JMRKuqdVkqLnyzJ5hjCoL5i8XUPdS3gUxYuHhkP3R/ZYkYrBFQ9ewZmaWGMDnX2Xb9ME xLBmkmXkKJjDlb6LUEJnnsqq0oqlQJtQyBT8TuRISW5eOAjz1xVVVfR5Dotlce8gnKf+ f5HN5GByq8M50qEf0KUzKyYrtRIacswjdQO15hLdM4fvByAIG6jHtChsqmQQblqdty6V ZDPQ== X-Gm-Message-State: AOAM530IucYsjIiCqIp4Kvxub6LDs4XzcC76gDxtzCTNsEA4JRP+6y5G DuyrrJgM1FYvXd64guJxndSTf1EpUsk= X-Google-Smtp-Source: ABdhPJwnd/myzhL7flS9oKu9IYKn1JF0tdDpwLNLOqbXedSC1QzKDINbm+n+XI/NWfdqQ6AWvYIoVg== X-Received: by 2002:a05:6512:69:: with SMTP id i9mr7346425lfo.615.1624978250396; Tue, 29 Jun 2021 07:50:50 -0700 (PDT) Received: from smtpclient.apple (dy45zjklff7vt13hz0ljt-4.rev.dnainternet.fi. [2001:14bb:633:43a1:2426:e30a:dcd4:f24f]) by smtp.gmail.com with ESMTPSA id z133sm1591685lfa.241.2021.06.29.07.50.49 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 29 Jun 2021 07:50:49 -0700 (PDT) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable From: Marlon Richert Mime-Version: 1.0 (1.0) Subject: Re: Does add-zle-hook-widget violate the contract of ZLE hook widgets? Date: Tue, 29 Jun 2021 17:50:48 +0300 Message-Id: <07C746D6-EA7C-4E16-BC35-7317F541D643@gmail.com> References: Cc: =?utf-8?Q?Lawrence_Vel=C3=A1zquez?= , Zsh hackers list In-Reply-To: To: Bart Schaefer X-Mailer: iPhone Mail (18F72) X-Seq: 49137 Archived-At: X-Loop: zsh-workers@zsh.org Errors-To: zsh-workers-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-workers-request@zsh.org X-no-archive: yes List-Id: List-Help: List-Subscribe: List-Unsubscribe: List-Post: List-Owner: List-Archive: > On 29 Jun 2021, at 05:06, Bart Schaefer wrote:= >=20 > =EF=BB=BFOn Sun, Jun 27, 2021 at 4:19 AM Marlon Richert wrote: >>=20 >>> On 26 Jun 2021, at 17:52, Bart Schaefer wrot= e: >>>=20 >>> =EF=BB=BFOn Sat, Jun 26, 2021 at 6:14 AM Marlon Richert wrote: >>>> However, my understanding of Yodl is limited. Is there a simpler way to= do this? >>=20 >> Did you notice I asked a question? You left it out of your reply. >=20 > Sorry, I thought it was implicit that the simpler way is to not do it at a= ll. >=20 > "Typically the way to do this would be to include a link to User > Contrib within text that says something like 'see Manipulating Hook > Functions in noderef(...)'." OK, I see. However, since there is also an HTML version of the manual, I thi= nk adding a direct link makes a lot more sense. Also, as stated before, havi= ng an empty Utilities section makes no sense to me; documents shouldn=E2=80=99= t have empty sections. Plus, having the subsections of Utilities listed in t= he menu would both make it easier to browse that page and make it easier to r= ealize they even exist on that page in the first place. But feel free to spl= it these two things into separate commits. I don=E2=80=99t think this greatl= y affects the text I=E2=80=99ve written.