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 autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 29875 invoked from network); 7 Feb 2023 03:26:18 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 7 Feb 2023 03:26:18 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1675740378; b=rDPrkPTLQM/5MDJdw0cMOPFhRljxqJr5D0CQ0Djxl8Y3Xj0lI0QltD1ni8DGQkvfb0JsZb4xlD flQmgowUW4+knI5GsRAZKV6BenKvWxItLx7z2T6x+A0aibtu/+2O+giBMgfbST5iCt/DzTDIzY TfvFes/Jz3jl0rjBQ7Y2faD40FrPSrWA7pKarqDkjJiIxFbAIuAhsVYmRyRDae0a644CGwdIXZ QdiHex8jeFhkzNdROg9ywfv/PU9ymycnjaDBG5rosWRGHmv1B9BtaYI29N6aewSs/QGptsBwAQ 0WjyzH+vYniy/W6Hk3eITRRvth3KGuCQ6AZYYV78PlSiDw==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-ed1-f48.google.com) smtp.remote-ip=209.85.208.48; dkim=pass header.d=brasslantern-com.20210112.gappssmtp.com header.s=20210112 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-20210803; t=1675740378; bh=jQFTShZ2/IxJzcFG8RpZqHrDkLhZ17VBMZhYP/Z74nc=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Type:To:Subject:Message-ID:Date:From:In-Reply-To: References:MIME-Version:DKIM-Signature:DKIM-Signature; b=cLKBti18ffaMHOoZmAWbE5NupMhXtxbQj8uPJyXp0I+Q43Bq3Yz5hPFhqwxiSEeUbPviB6IcvV FtgiMXhsLvudpT7OPIhByZGzJPx9gjm5hkFGMXXERx2ZHZL0sqqsbgb0pwqNQQpM+EJ8Zn3sMf GjUec6zv74km2zEP7E3N6UlRHGemAiK96XT7lHPOdNWhlaSjrrFN9eqPJPTZZOH+E5iREcX40A 3JYokoI4D85gGz2D6idqWD5je+fNwdKoXIl60H9F3ixQuHngiYobaDa+BtppJryX88bkQzKnFb 6IMMQ6LCora7/3ZJvrHCTfu/xyPvCtXLOWd1r24jTSIntg==; 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-Type:To:Subject:Message-ID: Date:From:In-Reply-To:References:MIME-Version:Reply-To:Cc: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=SFMJxkH6WpSL8fjT47FkXO0a+n9AqEKLX2l/uhaRdZA=; b=Ujit9Vy/dW/UYX9Belsb7nNdiA 7Lcc1Tglm8YbeTaroayvTMhi+D7crp33/LNpEwA3frtugvktCkJ2z0eQoWf5oKRttxsDTQ+mQmfy+ BPxPtuqlQod6dDMFgg1YSqnc2VJ+DWG5IplRvYxvw62b6iPQ1cE7WHwvPA1tIh5gSfDrqGOo/KfTD 7Qhgx3qhQI1AdB9WO+41OkqvZKjKRqfdM6r4Kj/aQ6J/ADt1PfoaHdpemLpDd/fuGdETat9aisgv3 paHYr0/DmHWKkviSr5mNgcF/pg7nEgP3Yv7/JNLlDSGj0Yb5DbdHN+Ak22xlRHo8JO5jnOmLbNBvF jdRZsUWg==; Received: by zero.zsh.org with local id 1pPEcc-0005k2-Ip; Tue, 07 Feb 2023 03:26:18 +0000 Authentication-Results: zsh.org; iprev=pass (mail-ed1-f48.google.com) smtp.remote-ip=209.85.208.48; dkim=pass header.d=brasslantern-com.20210112.gappssmtp.com header.s=20210112 header.a=rsa-sha256; dmarc=none header.from=brasslantern.com; arc=none Received: from mail-ed1-f48.google.com ([209.85.208.48]:44714) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1pPEbb-0004r2-Iu; Tue, 07 Feb 2023 03:25:16 +0000 Received: by mail-ed1-f48.google.com with SMTP id v13so13707620eda.11 for ; Mon, 06 Feb 2023 19:25:15 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=brasslantern-com.20210112.gappssmtp.com; s=20210112; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :from:to:cc:subject:date:message-id:reply-to; bh=SFMJxkH6WpSL8fjT47FkXO0a+n9AqEKLX2l/uhaRdZA=; b=M4MwbULrshICnjieC2XpE+5sVnuV/FE6qEUTU1ttSZRr7vXRrZCphcyt/fL3KumWW1 zJU7vt1mjF61aZKrVJoo7rEXtZ8TdkaZ4eeaVcMJA0YMBjhMKkIpssB0XmzICl56PP2y dCq75sQjaY8WvkEdZBAeIUQAjlwXozwGQu306CNll9ujzS3XVftdVy0fGtk5H02KBxvG hERu8mE7mpgsFqqkagpXhwjQO5n7dKWTjq9jLHc0JyHnAnkGjUmlSVM/exNFvxAzqhAR Ix9/DBEVsralHmrS5h+1oCFnoVzA7ofnMGASn7l6rPDmUylugJvDRsFf4vIXLyZTA35B aU9w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=SFMJxkH6WpSL8fjT47FkXO0a+n9AqEKLX2l/uhaRdZA=; b=RgP6KEaI5MGRAElGyoLbZ1Ws7AkR6us0ZDds/LjkEWAaw5UlYiYzDqD++9GZr8IGcP 9VeIJUqdzyHYb5r6HBkFuPcsZ0m/jx4hEjLiI/Wcf+ab/q2ZOEoIFR/LqXtFw9YntFiV JJGKnC1aVnzzo2pQthlGppkR8kMZRe7D1bzFLvoigynNgiV30QY5oEIjTfessxF00NUH S7d41cmvO5cJPnTc7QnwsXzfCGB3cGouU8SwwspKFFXNUiZk4fDXZDZFsr8bRyHJWVcZ 9hrg4GkT9AZU4wyx4S7iwfnkLGngl6tNUGHcPZucHo9hYz4UQfWni+ZTr8TSdwO90d3/ Wqjg== X-Gm-Message-State: AO0yUKWCOPX513bbDdB1JvYnjH48d4SYWypp1kgR2Vgsp7H7Y97ApsmQ 0tKer+9BPzOXfVFn9aS6Me7gT7jTEONIwAI66XyfNq9JnKBoJw== X-Google-Smtp-Source: AK7set9WsqyKjXbBiK+dCAnjUls5sXRVsGLP5iTwMIlaA1+VLESHe3eoVwD4O/5HiKFFVs9IVQXSPi2FzEQceAPx1mU= X-Received: by 2002:a50:cd17:0:b0:4a2:2e9e:c2e5 with SMTP id z23-20020a50cd17000000b004a22e9ec2e5mr167469edi.3.1675740315265; Mon, 06 Feb 2023 19:25:15 -0800 (PST) MIME-Version: 1.0 References: <20230207005647.GA5789@tarpaulin.shahaf.local2> In-Reply-To: <20230207005647.GA5789@tarpaulin.shahaf.local2> From: Bart Schaefer Date: Mon, 6 Feb 2023 19:25:03 -0800 Message-ID: Subject: Re: [PATCH 3/3] Documentation for named references To: Zsh hackers list Content-Type: text/plain; charset="UTF-8" X-Seq: 51370 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 Mon, Feb 6, 2023 at 4:57 PM Daniel Shahaf wrote: > > Bart Schaefer wrote on Sun, Feb 05, 2023 at 18:26:50 -0800: > > +tt(-n). The var(name) assigned-to may not be an array element nor use > > s/assigned-to/assigned to/ I did that on purpose to remove any ambiguity about what object "to" acts upon. I've used s/assigned-to/so created/ > "incuding" Thanks. > > +the type information of var(rname), unless var(rname) is empty, in which > > +case `tt(nameref)' is expanded, or when no variable var(rname) exists, > > "in which case the expansion is `tt(nameref)'"? Better, thank you. > > +When both a named reference and the `tt((P))' flag appear, the named > > +reference is resolved before `tt((P))' is applied. > > Add a test for this last sentence? I can't think of a way to do so. Given ${(P)ptr}, there are two possibilities: 1) ptr is a scalar, in which case we're not testing the right thing 2) ptr is a reference, so any other order of expansion is meaningless If ptr is a reference, a working test of ${ptr} implies that ${(P)ptr} also works. I almost didn't include that sentence in the doc at all, but I found the nameref sections of "man ksh93" to be so nearly unreadable that I went as far as I could in the other direction. (The sections on discipline functions are even worse, even the author of the O'Reilly ksh book basically gives up on the topic.) > WDYT of documenting somewhere in the manual namerefs are new in 5.10? I was going to add something to NEWS and README eventually ... also, I wasn't sure we'd landed on a version number yet. I suppose (once we do) a mention wouldn't hurt since the docs are likely to end up on line. > > +em(This is a misfeature.) > > Does "This is a misfeature" mean "This may change in the future to be > compatible with ksh93"? Oops, I was supposed to delete that whole paragraph, I already fixed that with the base/width overloading. > > texinode(Parameters Set By The Shell)(Parameters Used By The Shell)(Local Parameters)(Parameters) > > sect(Parameters Set By The Shell) > > s/Local Parameters/Named References/ Thanks, thought I'd caught all of those ... it was nice when the older version of yodl complained about those incorrect references. > (public service announcement: we have *.yo syntax highlighting for Vim > in our tree) I have a yodl-mode.el file for emacs floating around somewhere too, tho it hasn't been updated since about GNU emacs 12.