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 31825 invoked from network); 21 Dec 2022 04:44:13 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 21 Dec 2022 04:44:13 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1671597853; b=ggYgrAQNzD6BS/gocitDhoZzPExee+lWcSe0Irzr+kmicVM++o/K/u4rsSAthCQGA0M70HO/Sg +CO7X7wHEFy6ESYcyaxJCr4r2iQgjA19i1LFGEKl2VijLLfFJDWH7nLVRCiqr6iycPgA1bWVWy wuHhxc7HT/x+9pWAwIxXrjgWq9c+UelCuc3N1Gi47Z0il77cX1WnCX30+yIppj4pUTPFi+cNqe dERiWUEfULOSHbeIwkwV7Y1OfbI68kzSJEybpVcYknKyeNHvn5kbShsiDW6+11DGbd7RRZunhv gX+G8t6B9jJdw/THh98oogFyXAIWzeyqGxmki4ChNSZ9/Q==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-ej1-f44.google.com) smtp.remote-ip=209.85.218.44; 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=1671597853; bh=eVfD6geH996dz/yR43DWfSZywpg9V3uEFTHSiM9Cb/A=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:Content-Type:Cc:To:Subject: Message-ID:Date:From:In-Reply-To:References:MIME-Version:DKIM-Signature: DKIM-Signature; b=ByTBHfMqMomFhajkDyhoJpHYiPe27kkTmidUy1r1aU/Hqn8WonHCSSbbLrEGvIlX3rQ3NxvV2r BJQBRplZeRc2FnHOSCMiGK338g4QHQYn4jOmyS6se9U9DDZYHk/1KY+db5fpMg9GnaEP5atHIc aNyKDH1gyh/PmXzJJFY/wASLyGKqYN1v5/BIc0grIwXAiJUBMlWCLTaNUewKUCIj3WkVjAlr4i WZRjESflFZFzIxdx2MPbkC6T+GmdHw2g1zdwgw1D8gPzZbSN3bJP5XGafjqMB5ZYtQbkYKJMk0 JzfQtSlzLCrlZiDUVsmUywMis1FBi0ZS+6GOnH1iIiUyMg==; 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:Cc:To:Subject:Message-ID:Date:From:In-Reply-To:References: MIME-Version:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=l1+jAxnGgEzrAA5HBmOMTUIqSrZz+GELXLNVY2cWxjY=; b=FPCEdaf0Krhj18m+QioVVoMx6A GiM2fbOED9V1dU3FpJaFyUsUvtIZYav0UQle2+cS/DD+h/C1bcjLINzAuagX0y6rxhVDxxFzDXqBr MAx5G2S3qW6/+si1OzDmKi8NiKdNiT2Hy6+CX288m2VmTRVg+lupmpdzqaGGalgFfiuEGcAS4YQec yqgXpJrfJWy8w01D3c1LmW2jeIorCzsqt6eOwEXCBw6KXuygqJJ1iILVeli/tj3KtkwY6pCxVqbZz SX+IVgYBlRa/6vqjDdxtV3MrCU+jCu+CsS8J7hTJ2tCMFIScbLafm3dBRpJIjCJ76l43Tc/22C+LG uiHYLxFw==; Received: by zero.zsh.org with local id 1p7qxg-000LYa-Qt; Wed, 21 Dec 2022 04:44:12 +0000 Authentication-Results: zsh.org; iprev=pass (mail-ej1-f44.google.com) smtp.remote-ip=209.85.218.44; 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-ej1-f44.google.com ([209.85.218.44]:45824) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1p7qwu-000Kph-5T; Wed, 21 Dec 2022 04:43:25 +0000 Received: by mail-ej1-f44.google.com with SMTP id fc4so33974886ejc.12 for ; Tue, 20 Dec 2022 20:43:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=brasslantern-com.20210112.gappssmtp.com; s=20210112; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=l1+jAxnGgEzrAA5HBmOMTUIqSrZz+GELXLNVY2cWxjY=; b=iUh+OR2avvCM2dUr1nVi9+nYaBbFFYRn+kr0RamEU3edG8De4F2+ZCUbRO9h2WVqna A1Ny7vPlWua6tvgkRQckb1rv2yASpZF98pkyXnfTu4qXMUI+Uv1IStBIN5XwqGJVuVe2 jAvtv/ZglVpy1vwRpagiIENm4/YXc78rtkkJd6FzW/nTmUAdLZLZ27/TID1Dw1cE/lIJ gNrWIxzVN+GurzoriLeiPBM2aYG4AXOaK3z1yfb01QHneppRFx5BVIu09qlSXAHek+c/ xv4dXN99TCrT4ikREk1l0M7uPn8qcLSKHqi+GuOoew0kupoHdi8d92K/cl6yoqDjRxRZ 0f0Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:cc: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=l1+jAxnGgEzrAA5HBmOMTUIqSrZz+GELXLNVY2cWxjY=; b=7pOszM6A9UwadOkyemCaMGh3I8Nbvy1szau2/exQKuYjcpPIZOv4IMNxg0B66Fr6ZR qLhqI8I4cWfc0ftoZ1YlJNIuE7T0yiw0PCmb+nuouZ3+2TP3/cUKnTPQY5oopEycAuWW KsujjBVHz666WZqXvdsLgwMPvTbIFMTN1B1B8pZhNXrWkDkTZImfb/hACZ8qNkoyBASI ZqDQ2GZJj1sBWL7sbuso9uRut2Zsvh9/JtFVQhKyUrEt/VvS10cDIsbWO3CtWGYhxPrY uiUCdBsWknNmiqVwMMOmAYtf/RBeIWE2//pSFRLJlXiHoRpnnez+snKzap84DQC5UVio Gm1A== X-Gm-Message-State: AFqh2krBvsCjOG72tH5bZ8H/5SwEsOggkOD8zVFayRxe5f8QcN/CGLsY ndvCGh+QjOR0owjB1M89o2Dr8kevV2zBSvti2qa6WuLOtDRhDLW3 X-Google-Smtp-Source: AMrXdXsH9ehjMnAg7qeQAdwka+A4lXUOcmvyvH0KV7AxG8W1ogbigv7UTE3Z5JAMyg+jhHs3qscLKelA0Mo8F9+yX1k= X-Received: by 2002:a17:906:e2c4:b0:829:e4f0:bf2b with SMTP id gr4-20020a170906e2c400b00829e4f0bf2bmr8610ejb.389.1671597803805; Tue, 20 Dec 2022 20:43:23 -0800 (PST) MIME-Version: 1.0 References: <71c9c7e9-3f95-143d-fbd6-6575d7f4c446@eastlink.ca> <20221221020026.GH8411@tarpaulin.shahaf.local2> In-Reply-To: <20221221020026.GH8411@tarpaulin.shahaf.local2> From: Bart Schaefer Date: Tue, 20 Dec 2022 20:43:12 -0800 Message-ID: Subject: Re: manual To: Daniel Shahaf Cc: Ray Andrews , Zsh Users Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Seq: 28603 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 Tue, Dec 20, 2022 at 6:00 PM Daniel Shahaf wrot= e: > > The synopsis just says =C2=AB{+|-}options=C2=BB, with "options" in var() = markup. > > That's unusual: most synopses spell out all valid flags. "No; it is too much. Let me sum up." -- Inigo Montoya There was for a long time an effort made to keep the first-line synopsis of each command short enough to fit on one line of "man" output. For a few commands that was impossible so we started adding explicit line breaks with the expectation that the reader would understand it was still all one command line. For some others there was no way to add a line break at a sensible place. In this particular case (as you noted) there's an entire other section already dedicated to the single-letter options that can be manipulated with "set" and another for the long names for "set -o". 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.