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,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 16530 invoked from network); 26 Sep 2021 08:48:18 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 26 Sep 2021 08:48:18 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1632646098; b=Wx/4Ydkg1ZaVv07MuYSuaYHfY65SBTvtzYtsqWGbPmEkC81bDaXPtvBdvsLb3qkX3BGWuXRUlW dpes55Fb3euB6wFnnsg4j/pVLXWzMazkeL7T3YzIGJ0MUTGSyfiCWWgIN5ORdl5lADEfP9nghS N3sO6Nox0cvYjwkAFlZaL+TZuUcq3nQklZNSthjJ89R8ktXgQbzf4imXkzLOjTvAXaQ95vVtLo eZk9r3vR/V9ebCOXyBxmZhxT6K1q62I3DV5Pviy5Y1zjcgcc4tiWaw0bpJTrYNUa4t3T/0BV52 TOno23wLNeMJvkqqFEDIHKPCgv/fBmTMNjqDtsx+7Fe1zA==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (out4-smtp.messagingengine.com) smtp.remote-ip=66.111.4.28; dkim=pass header.d=daniel.shahaf.name header.s=fm1 header.a=rsa-sha256; dkim=pass header.d=messagingengine.com header.s=fm3 header.a=rsa-sha256; dmarc=none header.from=daniel.shahaf.name; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1632646098; bh=MOrk3uJhrY3UOed2F6vIbxgFG5wHY6tcqvohKV3ioqw=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:Content-Type:MIME-Version: References:In-Reply-To:Message-ID:Date:Subject:To:From:DKIM-Signature: DKIM-Signature:DKIM-Signature; b=OXCRFl85rN/vb6W3M4pLU21nue7WB/ZDfR8n3JdAXHtbS0idq8hkCuTgXgmIdW2WwRrxg+e4xB TGSf8JEJanbd17AIUUtC+kB2FQL8FmsZZsOCht162/sqxCBHNhEtz2yZyfdvdSUcDZ+HDenY6a IVKKrArCkMRS0ANWsW6nRGKLZMnQIelq3pzL9XxxO5wkAXwv7kD7cd2yjJZwfJulLmyF9UDGTj LSYq2MNxNb+XeJ7bgIM0kQ44RLiSfCfBSCt87lgJ+P8ISb0T+aA0jaFiYWnSdWdRa5MMT+2Uf1 besjV8FEDAbKg6yibfY3HUjBpLfd2ue/Rlks7JKUQDB90g==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20210803; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:Content-Transfer-Encoding: Content-Type:MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:To: From:Reply-To:Cc:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=nwrgJAUGZQGuIp6kMNx4hu7HGBPKGQkoaoFIrJkr4NI=; b=T4WnxPsXY+CCUUi1mbdwnDdoSI sjdbl1TDbFQo3MAo95rLqQjDBx7AgXyIUiTXz1P/xNg9fQFY0f0jNvPtRtd3nlp+D9++a8lD8nvF8 CSezm6iisJ3tUGwBPh/l4NSyPuu3s1EH12UKJN7uVG20ZSq+Lqde4WwoLbbeP+mOgnSndThJgjXoS eyZIwk+PdyTJHAeKcpQi+uone8K5bdSa0CQ7Zkvw2QFWWDvCxtKoSAosrnUhwcTW6LP7bNiAHx9Bb JAw4UGAYipDnqjL088n2sSErJzlScIWWP9jBSMc2epszb20qcoC/VaovkQeqWEYBn7WE9aYej13nA 7eSbhBQA==; Received: from authenticated user by zero.zsh.org with local id 1mUPpa-000KWy-9i; Sun, 26 Sep 2021 08:48:18 +0000 Authentication-Results: zsh.org; iprev=pass (out4-smtp.messagingengine.com) smtp.remote-ip=66.111.4.28; dkim=pass header.d=daniel.shahaf.name header.s=fm1 header.a=rsa-sha256; dkim=pass header.d=messagingengine.com header.s=fm3 header.a=rsa-sha256; dmarc=none header.from=daniel.shahaf.name; arc=none Received: from out4-smtp.messagingengine.com ([66.111.4.28]:32831) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_256_GCM_SHA384:256) id 1mUPlO-000IPx-D6; Sun, 26 Sep 2021 08:43:58 +0000 Received: from compute6.internal (compute6.nyi.internal [10.202.2.46]) by mailout.nyi.internal (Postfix) with ESMTP id A6C2D5C0047; Sun, 26 Sep 2021 04:43:57 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute6.internal (MEProxy); Sun, 26 Sep 2021 04:43:57 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= daniel.shahaf.name; h=from:to:subject:date:message-id :in-reply-to:references:mime-version:content-type :content-transfer-encoding; s=fm1; bh=nwrgJAUGZQGuIp6kMNx4hu7HGB PKGQkoaoFIrJkr4NI=; b=YBpWpo5q0Zm4rS9nGEK9MGnzPzXTmKlTuaKZ1WpSiu Alt0jyvTORpDYwk5pPnxrNZlRB8FgDRs3rIUNQL3gxrQDqOKcSgtGhjFdHeZUDFt hprwAbVmxvKMmaev0l8fqpLlfng4FtB6FfjxRpd6XMzMkfjEi2DRzfD2s8iyyO2w vcKQxPLSPwEJMvPdkn3un0SHU1UImjidpHikmIAtb1AM7NtXeBl8rc88FUmUESI5 frucw0HLeXpcKLsG0xTI2KeusdPg4p9SfsoMttudcQN23LbRDaaLy44i/T2l9TiL qfruL+GBSxN9X3nPZHPgXOkdie7Eakp1G4/eTZE8v7Yw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=nwrgJAUGZQGuIp6kMNx4hu7HGBPKGQkoaoFIrJkr4 NI=; b=lZafgpmKUfrXjS/Pz0Zx4c3i2OIwj+jmWTshDJPaE4rPMNdPJ5LlIy9yF eZ/SagFQ1w8jJ3Y8dJWn9HRGb20MDxR/yI4K02MVyD8czDE3lVBdFEK1Q6QvOmja MJLwQTD4lRpqmdBhzgGL4iR7iCvTDaw/TBlBIuSCXQ2Zl63xL+ptryj93hIBWzHL S4/+6toLvPCmB432W+UGla5K0oWPD9GD+FYSlPPxqwkW0AIrQJ7M5pFDUEwY+6+p AC+WHV/dJkdvHgN2P9TqaaDvk/f1EfBxczXIOr8lnTS0Ty5/X13NYZa1cHNr2fsq Z4EevdD8IZPeHGao+VXDdFievlZdA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrudejiedgtdeiucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpefhvffufffkofgjfhggtgfgsehtke dttdertdejnecuhfhrohhmpeffrghnihgvlhcuufhhrghhrghfuceougdrshesuggrnhhi vghlrdhshhgrhhgrfhdrnhgrmhgvqeenucggtffrrghtthgvrhhnpedtffefveeuteeuhf eljeekteefleehgfejtefftefgfeeiheeuleefffekleelgeenucevlhhushhtvghrufhi iigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegurdhssegurghnihgvlhdrshhhrg hhrghfrdhnrghmvg X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Sun, 26 Sep 2021 04:43:57 -0400 (EDT) Received: by tarpaulin.shahaf.local2 (Postfix, from userid 1000) id 4HHK7J1bTNz51v; Sun, 26 Sep 2021 08:43:56 +0000 (UTC) From: Daniel Shahaf To: zsh-workers@zsh.org Subject: [PATCH 4/4] docs: Fix pointers to the `Widgets', `User-defined Widgets', and `Standard Widgets' sections. Date: Sun, 26 Sep 2021 08:43:47 +0000 Message-Id: <20210926084347.9927-4-danielsh@tarpaulin.shahaf.local2> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20210926084347.9927-1-danielsh@tarpaulin.shahaf.local2> References: <20210926084347.9927-1-danielsh@tarpaulin.shahaf.local2> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Seq: 49448 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: The latter two didn't have their own texinode()s. Various places, both those sections' subsections and elsewhere in the manual, linked to the first section rather than to the third. For instance, zshcontrib(1) pointed to "noderef(Miscellaneous) in noderef(Zle Widgets)", even though the former (currently §18.6.6) is not under the latter (currently §18.4). Add texinode()s and fix those pointers. --- Doc/Zsh/contrib.yo | 2 +- Doc/Zsh/zle.yo | 22 +++++++++++++--------- 2 files changed, 14 insertions(+), 10 deletions(-) diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo index 0781c7eb3..6aca14f04 100644 --- a/Doc/Zsh/contrib.yo +++ b/Doc/Zsh/contrib.yo @@ -2342,7 +2342,7 @@ directly. tindex(bracketed-paste-magic) item(tt(bracketed-paste-magic))( The tt(bracketed-paste) widget (see ifzman(the subsection `Miscellaneous' in -zmanref(zshzle))ifnzman(noderef(Miscellaneous) in noderef(Zle Widgets))) +zmanref(zshzle))ifnzman(noderef(Miscellaneous) in noderef(Standard Widgets))) inserts pasted text literally into the editor buffer rather than interpret it as keystrokes. This disables some common usages where the self-insert widget is replaced in order to accomplish some extra processing. An diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo index 70dfec333..6948aa5ac 100644 --- a/Doc/Zsh/zle.yo +++ b/Doc/Zsh/zle.yo @@ -728,7 +728,7 @@ enditem() ) enditem() -texinode(Zle Widgets)(Character Highlighting)(Zle Builtins)(Zsh Line Editor) +texinode(Zle Widgets)(User-Defined Widgets)(Zle Builtins)(Zsh Line Editor) sect(Widgets) cindex(widgets) All actions in the editor are performed by `widgets'. A widget's job is @@ -736,7 +736,9 @@ simply to perform some small action. The ZLE commands that key sequences in keymaps are bound to are in fact widgets. Widgets can be user-defined or built in. -The standard widgets built into ZLE are listed in Standard Widgets below. +The standard widgets built into ZLE are listed in +ifzman(the section `Standard Widgets' below)\ +ifnzman(noderef(Standard Widgets)). Other built-in widgets can be defined by other modules (see ifzman(zmanref(zshmodules))\ ifnzman(noderef(Zsh Modules))\ @@ -750,6 +752,7 @@ as shell functions. When the widget is executed, the corresponding shell function is executed, and can perform editing (or other) actions. It is recommended that user-defined widgets should not have names starting with `tt(.)'. +texinode(User-Defined Widgets)(Standard Widgets)(Zle Widgets)(Zsh Line Editor) sect(User-Defined Widgets) cindex(widgets, user-defined) User-defined widgets, being implemented as shell functions, @@ -1206,6 +1209,7 @@ This can be used for detecting switches between the vi command ) enditem() +texinode(Standard Widgets)(Character Highlighting)(User-Defined Widgets)(Zsh Line Editor) sect(Standard Widgets) cindex(widgets, standard) The following is a list of all the standard widgets, @@ -1231,7 +1235,7 @@ menu(Completion) menu(Miscellaneous) menu(Text Objects) endmenu() -texinode(Movement)(History Control)()(Zle Widgets) +texinode(Movement)(History Control)()(Standard Widgets) subsect(Movement) startitem() tindex(vi-backward-blank-word) @@ -1378,7 +1382,7 @@ item(tt(up-line) (unbound) (unbound) (unbound))( Move up a line in the buffer. ) enditem() -texinode(History Control)(Modifying Text)(Movement)(Zle Widgets) +texinode(History Control)(Modifying Text)(Movement)(Standard Widgets) subsect(History Control) startitem() tindex(beginning-of-buffer-or-history) @@ -1726,7 +1730,7 @@ the numeric argument. Zero for both local and imported lines and nonzero for only local lines. ) enditem() -texinode(Modifying Text)(Arguments)(History Control)(Zle Widgets) +texinode(Modifying Text)(Arguments)(History Control)(Standard Widgets) subsect(Modifying Text) startitem() tindex(vi-add-eol) @@ -2052,7 +2056,7 @@ into the kill buffer. Arguably, this is what Y should do in vi, but it isn't what it actually does. ) enditem() -texinode(Arguments)(Completion)(Modifying Text)(Zle Widgets) +texinode(Arguments)(Completion)(Modifying Text)(Standard Widgets) subsect(Arguments) startitem() tindex(digit-argument) @@ -2100,7 +2104,7 @@ example(zle argument-base 16 zle universal-argument) ) enditem() -texinode(Completion)(Miscellaneous)(Arguments)(Zle Widgets) +texinode(Completion)(Miscellaneous)(Arguments)(Standard Widgets) subsect(Completion) startitem() tindex(accept-and-menu-complete) @@ -2175,7 +2179,7 @@ When a previous completion displayed a list below the prompt, this widget can be used to move the prompt below the list. ) enditem() -texinode(Miscellaneous)(Text Objects)(Completion)(Zle Widgets) +texinode(Miscellaneous)(Text Objects)(Completion)(Standard Widgets) subsect(Miscellaneous) startitem() tindex(accept-and-hold) @@ -2573,7 +2577,7 @@ If the last command executed was a digit as part of an argument, continue the argument. Otherwise, execute vi-beginning-of-line. ) enditem() -texinode(Text Objects)()(Miscellaneous)(Zle Widgets) +texinode(Text Objects)()(Miscellaneous)(Standard Widgets) subsect(Text Objects) cindex(text objects) Text objects are commands that can be used to select a block of text