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,NICE_REPLY_A,RCVD_IN_DNSWL_MED autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 354 invoked from network); 22 Dec 2022 14:21:49 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 22 Dec 2022 14:21:49 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1671718909; b=mnmabIS2YMLJWFByuIpsLpmN3BzhO5BWA4KGF282JZnkvDFmYsPHLVRKk294jOiCTA7+4BvhVY VTL7hEZdoVT7lgi/XNnfPY8AcOQIp233mF5tRGI2PkfOuj5FP2JUi80wbCJWKS51ieCZc2uagN MtdFOJu0AzuVgbWkW1uMUDAQfB785lkHqnVLYA5k8brgmbCnQGyzxBZVhnO0r1FXYFNH9TMYFt bFtq3S+f58N0OqS6GtZZCFkVIOzOQ7BTca2htbcj6DioL7xQseKlQA01oyG1e+RHqiVWItsecN P7HA7DJR8ylcq9sGPWmxZJ32pnilWKw6qq1r2bpCGsW2HQ==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mta04.eastlink.ca) smtp.remote-ip=24.224.136.10; 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=1671718909; bh=PMIGsUXDGnc3iF2nbiwvtlPQ4+nP+pngztkE1g3vPbM=; 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=VBmRZM0Sg8EL5jPOg5JiyiIX34YGZQJsjiW/oFtpju3jiGe8EKHVaQSg4q6iCZcdQe9OrGaL3A tabonunClIc7HfoghNdnoyHdT4lc90unbPC93juPtcweZzn8WG5pn+lQIl3scRQukLdiR/OOuE JYjH/tUojA8Wxt7l2qP836Mg/tmRIMQxBXRnLz4AHSxgImcbYS/h8xWG7w8OZqU6dPDAcPZSi8 venUs2ya3cHAhfwLo8rsTLwfErBXv3OdfjgubhKU90na1VgQ/V9OKVKD4/VUPJU5f1yjme5L55 dwVeYoJgUGjlvPPRlIHwV6Zm0wNMDMqUY9R99189NXdODw==; 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=HZ7XpExGABwaMPrB/tODr0XV2qDRS81utMVRm8Gt3c0=; b=pHopuX0f6kEhqhQ5MUpQQtsjdK rDPlqIXQSbfhAIXh2NrId5Km9T1DuEl1U8tIUwHM2oueG/NrT3YZVhCgCrUOwDG80tP7WGQHTYz/H vvf0uojPMuRH4FMsFJ4d9PDkrxIq7DbVScaDl8KjAjOWq4OiZyrvbjwOcejU8TZIFDijTxypjgfdv 7CbQ3G/ONir+rHFLJdfTngVHKPEHhJmS5yjtNAoEuTEQCwmrmxflgh56yr+lGq4kR5OjRcxkGwIJu /fcbdta3zXWGja11OmUwoMzMhc+Xr/G73+sqpq/G86rkqlJl5zC+/A+VxZU1qhMyf1Z0y5dcqx25n xl2+e+ZA==; Received: by zero.zsh.org with local id 1p8MSC-0002eZ-VF; Thu, 22 Dec 2022 14:21:48 +0000 Authentication-Results: zsh.org; iprev=pass (mta04.eastlink.ca) smtp.remote-ip=24.224.136.10; dmarc=none header.from=eastlink.ca; arc=none Received: from mta04.eastlink.ca ([24.224.136.10]:56181) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES128-GCM-SHA256:128) id 1p8MRQ-0001y8-4K; Thu, 22 Dec 2022 14:21:01 +0000 Received: from csp01.eastlink.ca ([71.7.199.166]) by mta04.eastlink.ca (Oracle Communications Messaging Server 8.0.2.2.20180531 64bit (built May 31 2018)) with ESMTPS id <0RNA00389M9SF750@mta04.eastlink.ca> for zsh-users@zsh.org; Thu, 22 Dec 2022 10:20:59 -0400 (AST) Received: from [192.168.0.4] ([24.207.18.108]) by Eastlink with ESMTPSA id 8MROpzG60EN8v8MROpndRc; Thu, 22 Dec 2022 10:20:59 -0400 X-Authority-Analysis: v=2.4 cv=IPDESCjG c=1 sm=1 tr=0 ts=63a467cb a=xN66ZtSbq5jdJYpBp7G/jQ==:117 a=xN66ZtSbq5jdJYpBp7G/jQ==:17 a=IkcTkHD0fZMA:10 a=flRG77W8Rddg2Jg9zqAA:9 a=QEXdDO2ut3YA:10 X-Vade-Cause: gggruggvucftvghtrhhoucdtuddrgedvhedrhedtgdeigecutefuodetggdotefrodftvfcurfhrohhfihhlvgemucfgtefuvffnkffpmfdpqfgfvfenuceurghilhhouhhtmecufedttdenucenucfjughrpefkffggfgfuvfhfhfgjtgfgsehtkeertddtfeejnecuhfhrohhmpeftrgihucetnhgurhgvfihsuceorhgrhigrnhgurhgvfihssegvrghsthhlihhnkhdrtggrqeenucggtffrrghtthgvrhhnpeeitdejffevgfdtheeggfetkeeugeegieetuddtvddvudetteffvdevlefgueekudenucfkphepvdegrddvtdejrddukedruddtkeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepihhnvghtpedvgedrvddtjedrudekrddutdekpdhhvghloheplgduledvrdduieekrddtrdegngdpmhgrihhlfhhrohhmpehrrgihrghnughrvgifshesvggrshhtlhhinhhkrdgtrgdpnhgspghrtghpthhtohepvddprhgtphhtthhopeerredprhgtphhtthhopeiishhhqdhushgvrhhsseiishhhrdhorhhgpdhgvghtqdgkihhprfgrshhsfigupehtrhhuvg X-Vade-Score: 0 X-Vade-State: 0 X-EL-AUTH: rayandrews@eastlink.ca Message-id: Date: Thu, 22 Dec 2022 06:20:58 -0800 MIME-version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.6.0 Subject: Re: manual Content-language: en-US To: zsh-users@zsh.org References: <71c9c7e9-3f95-143d-fbd6-6575d7f4c446@eastlink.ca> <20221221020026.GH8411@tarpaulin.shahaf.local2> <4bb64d1b-f21f-35e3-3573-88e7dafe6d4c@eastlink.ca> <05989f02-59f4-49cf-b766-39fda9a5154a@app.fastmail.com> From: Ray Andrews In-reply-to: <05989f02-59f4-49cf-b766-39fda9a5154a@app.fastmail.com> Content-type: text/plain; charset=UTF-8; format=flowed Content-transfer-encoding: 8bit X-Seq: 28610 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 2022-12-21 22:31, Lawrence Velázquez wrote: > > It already says where to look. > > For the meaning of the other flags, see zshoptions(1). I know it.  They send you to another section entirely which is 1487 lines long.  Not very friendly.  Please understand that it's my 'job' in a discussion like this to be crabby and snotty and hard to please.   Devil's advocate is what I'm being. > Some options also have one or more single letter names. > There are two sets of single letter options: one used by > default, and another used to emulate sh/ksh (used when the > SH_OPTION_LETTERS option is set). The single letter options > can be used on the shell command line, or with the `set', > `setopt' and `unsetopt' builtins, as normal Unix options preceded > by `-'. > > The sense of the single letter options may be inverted by > using `+' instead of `-'. Some of the single letter option > names refer to an option being off, in which case the > inversion of that name refers to the option being on. For > example, `+n' is the short name of `exec', and `-n' is the > short name of its inversion, `noexec'. > That's quite well written.  Throw in some examples and it's good. But one should not have to go hunting for that information.  Unless ... there is some heavy reason why that's needed, in which case there should be a note to that effect: "( The subject of options is so extensive that it requires it's own elaboration and can't be fully explained here.  Please see 'zshoptions' in the manual for a full development of the topic.)" ... or something like that. > > The synopsis makes it quite clear that -A and +A can be used alone. > > set ... [ {+|-}A [ name ] ] ... Clear to you but not to me.  I missed it.  The expert will always find the manual good enough but that's not the test.  The test is whether the student found it good enough.  (Mind, there will be times when the student, fallible human that he is, might miss something that really is well explained.  And to be honest, I think that's the case here -- it is good enough, but overwhelmed as I was by everything else, I missed the easy part.)  Again, I hardly expected to get it right the first time, that would be a miracle.  It was a template. The only thing that matters is that I've got a few of you guys thinking about all this :-)