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 3127 invoked from network); 21 Dec 2022 14:05:12 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 21 Dec 2022 14:05:12 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1671631512; b=snGFv4vjXW/R3XdIyyDrHpNLQ7bEGCkv5OtsxTG12rt8WLx94YrWBvAVdkzpfiwIiVDXTnDPIm 9FPfw3Q0L88jrnO1LxtpDSh8M5YL4bCMgzjrErChkeoq05iyxupvZsBxesi8K7mUdHXH+43rV1 LozosnmlIPwVeOcmtyXFVHzQw9ybi+q6WbG6I3gqmotBcqy5IGtKMtIJLvroxdWunAMPfR9NQr 34A12aNomJL9TthQISOGTLIRS3WK9GtoZY1e+x6GOlcZK8GmIN0UJX+g0Jyw5qX0shxkx1nLFZ L3cnO+KoAKVvt8u9BqU8ISKa4qvqf4MpOf8yIlsbLtc64w==; 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=1671631512; bh=cvTyEiwQ+3YN/Dyx8fR39xFNiEtkwfHYqVMo1LTPMI8=; 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=RDGz9Ae7xZxnq/1nsK1h9c0qEkiG4a7Sv3AIp9p6xexIlaROheOQ3IymQ2I4UtjzgSxpRLxNx1 kRB1H6DW4lHoNms9BOil9Xg920Qgul1eGuOs/WKLDKjCV+4Z0e+SfbWrnODYREzMsutDVprApX fGnpg7kxiFLSP3pAvJIW7jG3pvxAIFNvVJmVLLv34SGBwYpurSSn8P3CkuHOVusZQWxz9h81xK F+JNf1rjwaJCJu9Dw6Eexx1yDSHzbLqwJSJmwlaZlqMbh9zYG29kbX3iC3QKxBCprSEszLQVub HOTl2BZBkHL4cNx+qKn1nv2ftSquLV2RMTwpgi3SjRSMIA==; 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=3OdwrHRxGb2RWzzTp7SgpLnslDvY/yagiw/WwN4H1R0=; b=DMgJCWx779qeO+SLyS1f6BKVYZ t6SUoh/k1ceeEA5oSJ+k/+G0mVuBX8UwpugLbKENGDC9WIJ8NwM9/1JyB3A4q00KNvCiov3Zy5Rg7 /nvqiYdYeWz1I/ci786+G3/EVWEVugayogAkpAJbFvbeHxXhQrN60sx/wzhGrclGTQm82aPDMAEdy GAIGUwxn9/jJFscbF8etjFRhWxmGENcUXPSf3ngy3VKSAs4Gh1tYb0OJSHpdeBJwOM+JGcEReoKYE e7lFuTYKR0vO1Bj1/4XTDcHsDsilr8x4qw7BnP5z9190Xz91K3VfKUiuk2r/f4JlO30ZvLxdJTQI/ 0I7syAfg==; Received: by zero.zsh.org with local id 1p7ziY-000Bnp-P1; Wed, 21 Dec 2022 14:05:10 +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]:59556) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES128-GCM-SHA256:128) id 1p7zht-000B6m-IB; Wed, 21 Dec 2022 14:04:29 +0000 Received: from csp01.eastlink.ca ([71.7.199.166]) by mta02.eastlink.ca (Oracle Communications Messaging Server 8.0.2.2.20180531 64bit (built May 31 2018)) with ESMTPS id <0RN800MOZSL4A350@mta02.eastlink.ca> for zsh-users@zsh.org; Wed, 21 Dec 2022 10:04:27 -0400 (AST) Received: from [192.168.0.4] ([24.207.18.108]) by Eastlink with ESMTPSA id 7zhqpvwGPEN8v7zhqpmxfR; Wed, 21 Dec 2022 10:04:27 -0400 X-Authority-Analysis: v=2.4 cv=IPDESCjG c=1 sm=1 tr=0 ts=63a3126b a=xN66ZtSbq5jdJYpBp7G/jQ==:117 a=xN66ZtSbq5jdJYpBp7G/jQ==:17 a=IkcTkHD0fZMA:10 a=G6a98PcB-fRENbA1l-0A:9 a=QEXdDO2ut3YA:10 X-Vade-Cause: gggruggvucftvghtrhhoucdtuddrgedvhedrgeekgdeitdcutefuodetggdotefrodftvfcurfhrohhfihhlvgemucfgtefuvffnkffpmfdpqfgfvfenuceurghilhhouhhtmecufedttdenucenucfjughrpefkffggfgfuvfhfhfgjtgfgsehtkeertddtfeejnecuhfhrohhmpeftrgihucetnhgurhgvfihsuceorhgrhigrnhgurhgvfihssegvrghsthhlihhnkhdrtggrqeenucggtffrrghtthgvrhhnpeeitdejffevgfdtheeggfetkeeugeegieetuddtvddvudetteffvdevlefgueekudenucfkphepvdegrddvtdejrddukedruddtkeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepihhnvghtpedvgedrvddtjedrudekrddutdekpdhhvghloheplgduledvrdduieekrddtrdegngdpmhgrihhlfhhrohhmpehrrgihrghnughrvgifshesvggrshhtlhhinhhkrdgtrgdpnhgspghrtghpthhtohepvddprhgtphhtthhopeerredprhgtphhtthhopeiishhhqdhushgvrhhsseiishhhrdhorhhgpdhgvghtqdgkihhprfgrshhsfigupehtrhhuvg X-Vade-Score: 0 X-Vade-State: 0 X-EL-AUTH: rayandrews@eastlink.ca Message-id: <4bb64d1b-f21f-35e3-3573-88e7dafe6d4c@eastlink.ca> Date: Wed, 21 Dec 2022 06:04:26 -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 To: zsh-users@zsh.org References: <71c9c7e9-3f95-143d-fbd6-6575d7f4c446@eastlink.ca> <20221221020026.GH8411@tarpaulin.shahaf.local2> Content-language: en-US From: Ray Andrews In-reply-to: Content-type: text/plain; charset=UTF-8; format=flowed Content-transfer-encoding: 8bit X-Seq: 28605 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-20 20:43, Bart Schaefer wrote: > In this particular case (as you noted) there's an entire other section > already dedicated to the single-letter options that can be manipulated Yabut they sent you to the head of an entire nother section of the manual.  Avoiding an entire block of duplication could be OK but say something like: "There are many other 'set' switches that are duplicated in/for the 'setopt' command (q.v.) which you can read just below this entry." > with "set" and another for the long names for "set -o". Ah!  Another thing I missed.  It's far from clear that they're even talking about single-letter options.  Why not say that?  I spent about two hours reading, experimenting, re-writing, trying to get every bit of information out of that page and I missed 'set -A' (by itself) and single letter options entirely.  Not to be too whiny but 'set' is a dogs breakfast of bad design.  It is a bizarre bazaar of bits and pieces of semi-related functionality rather like a junk-shop or a gypsy camp.  It's like jazz -- don't ask for a definition. > It might have been nice to be consistent about what was an "option" > and what was a "flag" or a "switch", but those terms are thrown around > colloquially with interpretation expected from context. More than nice.  As discussed, manuals are not really focused on being helpful, but they should be absolutely consistent.  Perhaps a bit of literary license is welcome in a paragraph of exposition, but in a synopsis, if the word is 'flag' then stick with flag throughout.  I like 'switch' myself but that's DOSey.  (A flag is a variable used to communicate some bit of information between one part of code an another IMHO.)  Nope, the entire Linux word (no doubt UNIX too but I've never touched it) should be ashamed of itself for it's abominable documentation.  Our manual is far from the worst. >