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.3 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 6502 invoked from network); 26 Jun 2021 14:52:41 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 26 Jun 2021 14:52:41 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1624719161; b=r1i9LUQg5ffo4fCXKpzgRd2ku0ov/Ke9Px9XjGncSV6Za1kyEeM2as+wvA2mYf7kG4UtqTWODW 7AgJ7C//uqHpaEdwmXcARoP2qZyUHxh6RSywHy47sBcs3pyjyZ0iHyD+1iB4ivlADetY5c11sy jcyqhl+f8qZo36h3gSVrxKRihvYOCjfLmPaDoPgLB6vFHva8CDYQeUnn/69mY0iJzvn3tD6GGk 9VV25HwU3drWr5qsmlw4TcY0CANZhMPIBzOQYNi8yr72IutYMRSzuXctdVgUi/hBfU2NUAfbAo PhX6H8htb7gOtmgvso+GnRG+2kUDdcyUpJpaBWD6xPSCzQ==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-ot1-f48.google.com) smtp.remote-ip=209.85.210.48; dkim=pass header.d=brasslantern-com.20150623.gappssmtp.com header.s=20150623 header.a=rsa-sha256; dmarc=none header.from=brasslantern.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20200801; t=1624719161; bh=NK9Sz0B157dVQcSm2pdZ4eGYh3uYrgYbNO3LVpoXF7c=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Type:Cc:To:Subject:Message-ID:Date:From:In-Reply-To: References:MIME-Version:DKIM-Signature:DKIM-Signature; b=T+OY0+Te9+r5B4bQkjgurmEdnDIaQU8rdNBQ1o7GA2TuJcbNKrLKWtcWtCW4NI87KVpqTxjxsH EoVn5IRhHUIPDS+tvc/MzRZivyy3uPr3POKSz68sYRtVJR5VtSvrS4bH/hMi6heRTLDYdy2zMq FC/qjpc43AtpUosE6u2BIkAjNKeMwW+/OlipQVFGywm+9xMEQm8ZZXU1QR5EG9aeP2XeH4yBLd 9FfVE2eo1/CK3NyNCSGw7rlwXc/3pJQlwvab1KYo6CmM3FHqU0ZNQ7qG5IDHkYZwEwK22n8/jt yO4UgW58O0W+XStHe0RRapJaskfPLxd3Jxznopf3hvgbKA==; 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:Content-Type:Cc:To:Subject:Message-ID :Date:From:In-Reply-To:References:MIME-Version:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=wuzNQvKJGAej6El4uV5F556V7cIp4Mf0wHGFH2VRmH8=; b=GBjifA2VyPQCsRy3n2Fh5cm1bD 1bdVIJUOPyuRWfv9DO+azFkm1zly62GGo+2mFVSNMf5/A+acuBtDQtpumXpmX1/6YxNI67tORq1pC HylFP2ZkSc6BWaXvrcROZFUMSiH2QLdSkH9ZVwxdntczHgT9eatkABSsWerZQD0MiX00krsbkRwhy uu/Ku6JXatT9EXEjIJMd3jfYopcKeSt03wlw7GAJh+9LOckutk+7/OtVjevkFtMhhddbk6Wx9oUMy ZPe3tPdPS0/sPvbU/gRy/Oq5/tjTHplXRHXBqKxi6jRabJm+YI19u2K+j451ixCZWxa8793vzh5KM Ds6JPGtg==; Received: from authenticated user by zero.zsh.org with local id 1lx9fk-000DX3-0I; Sat, 26 Jun 2021 14:52:40 +0000 Authentication-Results: zsh.org; iprev=pass (mail-ot1-f48.google.com) smtp.remote-ip=209.85.210.48; dkim=pass header.d=brasslantern-com.20150623.gappssmtp.com header.s=20150623 header.a=rsa-sha256; dmarc=none header.from=brasslantern.com; arc=none Received: from mail-ot1-f48.google.com ([209.85.210.48]:44984) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1lx9fF-000DE2-58; Sat, 26 Jun 2021 14:52:09 +0000 Received: by mail-ot1-f48.google.com with SMTP id 59-20020a9d0ac10000b0290462f0ab0800so4806351otq.11 for ; Sat, 26 Jun 2021 07:52:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=brasslantern-com.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=wuzNQvKJGAej6El4uV5F556V7cIp4Mf0wHGFH2VRmH8=; b=Ov5qbdF1PKUWVu4awToAuTuXM+lx5QUb445DNuKo+YR+7hvqhsCwu/UtH0b6CF4+YQ p4jfg/flQHAdblg9FWdLTwS5KBTnprIbMjcjf0E7G51XTOKgsqUcVpScNUoTC5V6ynoS +j6fuy4k4G9C9yPHrHqWhHmfKKcdLKsrk0bJEpuZrniuu8pfcTXBE0qwSvavUKtCTrHd 11zlIa9MHGlz6/fmhmoXlecHr6Fs0adQ4kLGFwljqq0X/okHDiTgPEjXygqyE+l087Ok kUC5BkpWzlIbbaJwOS2gKX73eMPJD4V7BngOMV25fZ34AJRGRN8mRcJqlvvSXpkf1Hoi XMhQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=wuzNQvKJGAej6El4uV5F556V7cIp4Mf0wHGFH2VRmH8=; b=BCV0N19+dAq8fpnN5fMiQhFJE1p5EAHGyMaz/gWRJKW0XnHskHu1iKTOPdPnOCqIpp Rf/DwqOaNayrTmnC7eXDJiv/zQVkbJlmHNsZPl0pV6D998zPWhTXNVayO+cNHWV7lBmV EK7NkTuh17zOsNJUzEdUuvCg2uhIz/FnSd1C/O+gk/uMtXjQFBwJu7HrNJEycNWNPM7V j46ynFa0o/6806oQJqQR17SalCt3311Nqfpeaf4x0tkZ2+dQhoGGc4WV/yESJEsfoJR0 z96SDcx7BHsSkAWmU8ei7bKScdsaygSsnKwvB01fASfGPMucgWg5K4LmZIhH+GHYN5ao Mrjg== X-Gm-Message-State: AOAM530radU6k3iNyMMCyvaWAB9JwgyWjoPkHykq8HNI1frMPQx3a+fG L+NKySBezukukJnGFJ2hdIYPYezdCXuH/+cRqsryow== X-Google-Smtp-Source: ABdhPJykQwr11lEAnUQ3jSyjV1vNULWFvk1O26cuqrUiShPYsiMY+SKUoQf7ZMR3cneZVwUXMJXbnUqN15uuBJCJy+Y= X-Received: by 2002:a9d:674b:: with SMTP id w11mr14311844otm.260.1624719127795; Sat, 26 Jun 2021 07:52:07 -0700 (PDT) MIME-Version: 1.0 References: <9c56f50a-d061-4175-958a-6f89f6bae822@www.fastmail.com> <20210624183006.GA16386@tarpaulin.shahaf.local2> In-Reply-To: From: Bart Schaefer Date: Sat, 26 Jun 2021 10:51:56 -0400 Message-ID: Subject: Re: Does add-zle-hook-widget violate the contract of ZLE hook widgets? To: Marlon Richert Cc: =?UTF-8?Q?Lawrence_Vel=C3=A1zquez?= , Zsh hackers list Content-Type: text/plain; charset="UTF-8" X-Seq: 49127 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 Sat, Jun 26, 2021 at 6:14 AM Marlon Richert wrote: > > I included those changes intentionally: > 1. In the section ZLE > Hook Widgets of the HTML version of the > manual, I want to include a link to User Contrib > Manipulating Hook > Functions. 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(...)'. > 2. To create a link, I need to use a `noderef`. > 3. To be able to use `noderef`, I need a `texinode` to link to. > 4. Manipulating Hook Functions doesn't have a `texinode`, so I need to add one. You don't NEED to, you just happen to want to. Which is not a bad thing, but no consensus was reached about the best way to do so. > 5. When I add a `texinode`, `make install.info` fails to compile if > there isn't a `menu` in the same page that links to it. That's not really what's going on. There doesn't have to be a menu, but a texinode can't stand by itself, it has to be linked into the hierarchy of nodes in the document, which means that not only does it need to reference other nodes, but other nodes need to be updated to reference it. > 6. Hence, I need to update the menu structure of User Contrib. Per our previous discussion ... you chose to restructure things to have a menu. I had only pointed out that the new section you at first created didn't have introductory text after the manner of similar sections elsewhere. Nobody weighed in on preference for either one. There are less radical changes that could be made than restructuring, and if restructuring is the right thing, it could be done in a separate patch.