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=-4.3 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, MAILING_LIST_MULTI,NICE_REPLY_A,RCVD_IN_DNSWL_MED autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 25388 invoked from network); 15 Aug 2023 15:17:21 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 15 Aug 2023 15:17:21 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1692112642; b=ojfxjAJ6Kk9q9qJVjCUD3xli5T9SYvii7Jcp3PSyCN9U4FidREUHFe+78tb+QNZqc1QcJVhrDr uLhTTuCE9mPfbCf/oPjugtBRflJpiSNKBIgz4U88537p6C9U3mH2kj9j38b85sGvG+G/Ufy5FP Fl2dLj2gWSxW2OUQuDemzF/CjN8ashj4NtLKDrdnuvEYI0qQ0GVQ5uTvRVhReP0+JU6P6agTVZ 5tjtQMvQaNUmJAs70j9RgnRWacKnYjQeemTJYoKvZS+4OJS5n23kNQVEioqFBkxZscDTiTawqa L23uLyvciqPjiLhJkoL41Gxwj5KmnUofqeJFbC0sfcfLdQ==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mta02.eastlink.ca) smtp.remote-ip=24.224.136.13; dmarc=none header.from=eastlink.ca; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1692112642; bh=L80aTTeJyah4xEpP999KW+u/2ZvdT9sT3XcAzFqTN7Q=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:Content-Type:In-Reply-To:From: References:To:Subject:MIME-Version:Date:Message-ID:DKIM-Signature; b=jx0gfXnnnSPZsyz+/f5dXuEok9tOifVtul9H9MwxZaQyPGJz93KKT0U37Z/IofTuLUH90YMbZr H94XJGa2I6OqX+5Pgw6sFBESL5qRYr0q9HdruqtHAqP+m5eUEX4wneqEKkymawqW+NkH0Oy/by 9iRje17JgTLQgDzyh1ok5NrCcAMHvG8N1r1E5lKCObSd7pxoEm6UFKgNMVPAh6iV9CZQeJ9dNf aNNn8l3Z9jOXAku2FAkjKZra6Hiz/Z1LppbX8rwNoyWbI7sIZZna1n+zbkpgpcbRk4cG3OclhK Za6+N9B1JgcOKCyf/CDKUewSeomQP0g2+2HyuJ55LCMw2g==; 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:In-reply-to:From:References:To:Subject:MIME-version:Date: Message-id:Reply-To:Cc:Content-ID:Content-Description:Resent-Date:Resent-From :Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=I+q2w2j8RRIsVOFsXgESH6ufN+wHXNSpHk3w7tl1d4Q=; b=RXdMG0kr8HpPYYzarzl1ssu+3d b8UlE/BGVBNQjQDLmRloQb7TUBH6w2hdXxx7KM2Aagyy6MeiahSteD2B/8+q33Mj1/7gM9u91BtME 8r6tA35/i156cKnv+fNvY2m+0NYAKBnHkS8fyCKcz4nZl/bROro6ESf2tvzl09z84z8ftrzRbuYPo THTcEOfLfduk1XVZp8VfwEQ+u61ABctv+TSMyTzr3s31bpzVPuEarYzhg5rYgB8wINM+wyAml70ow v6gPF+aaDgzg5yqa1Ysb7BgsQTmconcfatfhwV00N1gAnCQbLHzEq+gxK0v+AhzbHdRfj20RsKJ+6 0fUo1Ynw==; Received: by zero.zsh.org with local id 1qVvnN-0002Vp-J2; Tue, 15 Aug 2023 15:17:21 +0000 Authentication-Results: zsh.org; iprev=pass (mta02.eastlink.ca) smtp.remote-ip=24.224.136.13; dmarc=none header.from=eastlink.ca; arc=none Received: from mta02.eastlink.ca ([24.224.136.13]:42925) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1qVvmf-0001nL-Pi; Tue, 15 Aug 2023 15:16:39 +0000 Received: from csp01.eastlink.ca ([71.7.199.166]) by mta02.eastlink.ca ([24.224.136.13]) with ESMTPS id <0RZF21JEHTXM4XI0@mta02.eastlink.ca> for zsh-users@zsh.org; Tue, 15 Aug 2023 12:16:36 -0300 (ADT) Received: from [192.168.0.4] (host-24-207-18-108.public.eastlink.ca [24.207.18.108]) by csp01.eastlink.ca ([71.7.199.166]) with ESMTPSA id Vvmeqt5scBqpUVvmeqTmd4 (version=TLSv1_2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256); Tue, 15 Aug 2023 12:16:36 -0300 X-Authority-Analysis: v=2.4 cv=Rr4DbgqK c=1 sm=1 tr=0 ts=64db96d4 a=xN66ZtSbq5jdJYpBp7G/jQ==:117 a=xN66ZtSbq5jdJYpBp7G/jQ==:17 a=IkcTkHD0fZMA:10 a=Ab5I5hfFJMInvEcCPvQA:9 a=QEXdDO2ut3YA:10 X-Vade-Cause: gggruggvucftvghtrhhoucdtuddrgedviedruddtjedgkeejucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecugfetuffvnffkpffmpdfqfgfvnecuuegrihhlohhuthemuceftddtnecunecujfgurhepkfffgggfuffvfhfhjggtgfesthekredttdefjeenucfhrhhomheptfgrhicutehnughrvgifshcuoehrrgihrghnughrvgifshesvggrshhtlhhinhhkrdgtrgeqnecuggftrfgrthhtvghrnhepiedtjeffvefgtdehgefgteekueeggeeitedutddvvdduteetffdvveelgfeukedunecukfhppedvgedrvddtjedrudekrddutdeknecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehinhgvthepvdegrddvtdejrddukedruddtkedphhgvlhhopegludelvddrudeikedrtddrgegnpdhmrghilhhfrhhomheprhgrhigrnhgurhgvfihssegvrghsthhlihhnkhdrtggrpdhnsggprhgtphhtthhopedvpdhrtghpthhtohepreerpdhrtghpthhtohepiihshhdquhhsvghrshesiihshhdrohhrghdpghgvthdqkghiphfrrghsshifugepthhruhgv X-Vade-Score: 0 X-Vade-State: 0 X-EL-AUTH: rayandrews@eastlink.ca Message-id: <52628f85-e41c-06de-a4a4-8d54148dfbf7@eastlink.ca> Date: Tue, 15 Aug 2023 08:16:35 -0700 MIME-version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.14.0 Subject: Re: Tagged parameters Content-language: en-US To: zsh-users@zsh.org References: <2084623922.2320579.1692088070247@mail.virginmedia.com> <1239829800.2332805.1692110389939@mail.virginmedia.com> From: Ray Andrews In-reply-to: <1239829800.2332805.1692110389939@mail.virginmedia.com> Content-type: text/plain; charset=UTF-8; format=flowed Content-transfer-encoding: 8bit X-Seq: 29131 Archived-At: X-Loop: zsh-users@zsh.org Errors-To: zsh-users-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-users-request@zsh.org X-no-archive: yes List-Id: List-Help: , List-Subscribe: , List-Unsubscribe: , List-Post: List-Owner: List-Archive: On 2023-08-15 07:39, Peter Stephenson wrote: > > Yes, it's worth doing something... here's my go. > > +Tags the named parameters. Tags only exist to mark the parameter for > +the user's own purposes: the set of tagged parameters can be queried > +using `tt(typeset -t)'. They have no further special meaning to the > +shell. This flag has a different meaning when used with tt(-f); see above. > ) That is so much better.  We go from a conveyed information score of -10 to +90 in one effort.  Since there is no end to little edits (which have an asymptotic convergence on perfection), I'd tweak it: +Tags the named parameters. Tags only exist to 'flag' the parameter for +the user's own purposes -- the list of tagged parameters can be queried +using `tt(typeset -t)'. Tags have no other use. Note that the `-t` flag has a different meaning when used with tt(-f); see above. ) 'flag' because that's the word used lower down 'list' instead of 'set' because set sounds too mathematical 'no other use' is simpler than 'no further special meaning to the shell' -- there is no other, not just no other *special* -- it makes one wonder what an un-special meaning might be. And 'to the shell' makes one wonder what a use *outside the shell* might possibly be. '-t' just keeps things specific. And I'd add 'Note that' simply to flag the otherwise usage. It's polite. I dream of a manual that is designed to inform the one seeking information rather than display the knowledge of the writer to himself.