From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: zsh-workers-return-43708-ml=inbox.vuxu.org@zsh.org X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE autolearn=ham autolearn_force=no version=3.4.2 Received: from primenet.com.au (ns1.primenet.com.au [203.24.36.2]) by inbox.vuxu.org (OpenSMTPD) with ESMTP id 5028c864 for ; Wed, 17 Oct 2018 23:29:52 +0000 (UTC) Received: (qmail 14572 invoked by alias); 17 Oct 2018 23:29:39 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: List-Unsubscribe: X-Seq: 43708 Received: (qmail 19597 invoked by uid 1010); 17 Oct 2018 23:29:39 -0000 X-Qmail-Scanner-Diagnostics: from mail-lj1-f196.google.com by f.primenet.com.au (envelope-from , uid 7791) with qmail-scanner-2.11 (clamdscan: 0.99.2/21882. spamassassin: 3.4.1. Clear:RC:0(209.85.208.196):SA:0(-1.9/5.0):. Processed in 3.825736 secs); 17 Oct 2018 23:29:39 -0000 X-Envelope-From: schaefer@brasslantern.com X-Qmail-Scanner-Mime-Attachments: | X-Qmail-Scanner-Zip-Files: | DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=brasslantern-com.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=HY43kp1cjQouTHgzlbvox5NXOZIXwmeOXNGSxghS2d4=; b=io7IfU/BdoQVTU5zjudcblDDUCEHinPQQMfApUhBLiufNc2s7XtfoqYdxpqItin1IR 7Er6A+OHVJk4zhjcGFflzp+UPBk53Td96H5QcADPurB1uGlSd2eB4zoXNhO6y0n5DgSJ 8Y8M8bYLDH3tiytAkbEQlzElq2bfqxhiHPaJMQ9XURl5x+y2Gsw6pG2rdpsKG3Q64/wp fI2gS+mIFgV609Wb3DK5NQB3tPryVeAZdNOofN3BTsEhaaQeYuq+ayk0Gge9Im+2UrEw bQCXHdYALQ5nY6rMIpAC/ELZj6by+noMCtBbLS3D6RbbC9xgMrnk++tPEOp1XBz0fRmd OIiQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=HY43kp1cjQouTHgzlbvox5NXOZIXwmeOXNGSxghS2d4=; b=G3iptwMtPD+5M/LZRGDWULlzCi86F7iI6oUGJHPfugBIpbOcHMYCBH9gwb3LmwmIYg OBDsSwxC4ckG0OGLQhuOkkLqxpaevHzRtnXV2HFQPpuzZDu6Y2ulZcchgeR9VWcgVV8E tz/fHh+ij/7NYgE5tw9ajIf4q4OcZY+y0Xa0mJbxa5Rw2iWkEZLzoIMe8fjDWglBKmu1 zdbYZwC536RnX+1/exGPcWjSvyCpn12em4niM3WOPuufE2PCEdkEF9gaFzpJcZDD3O8D X9DSIDJJIwUMat7p5J6HKhUQ2hTRpmFmOXGUpg0bdoDxMcQ1LTNwGmcNpIOML2BSb9/R QYuQ== X-Gm-Message-State: ABuFfoiJR876fRRAvRTP227+jZo00L39Z4GZegyZSeoDJidF25QG0x8J qBYP8LxlD6P2juNjPDQ0q9yT5aVsWI9+ZISGykr0sboD254= X-Google-Smtp-Source: ACcGV61yb5ZZlcc6T3ZgHYN/1ZbPnWbFVzNLinZSnzYrdM6WS/EFoupNUWWQ8ugEI7+B3p9WX+ckwJsJekbCjz0VZb0= X-Received: by 2002:a2e:2bd5:: with SMTP id r82-v6mr18054507ljr.63.1539818970882; Wed, 17 Oct 2018 16:29:30 -0700 (PDT) MIME-Version: 1.0 References: <042AC609-6169-4637-B7FF-708840B30853@dana.is> In-Reply-To: <042AC609-6169-4637-B7FF-708840B30853@dana.is> From: Bart Schaefer Date: Wed, 17 Oct 2018 16:29:17 -0700 Message-ID: Subject: Re: [PATCH] Clarify documentation of parameter-assignment behaviour To: dana Cc: "zsh-workers@zsh.org" Content-Type: text/plain; charset="UTF-8" On Wed, Oct 17, 2018 at 3:56 PM dana wrote: > > Considering huge portions of the manual are dedicated to explaining the most > fundamental aspects of shell functionality (how commands are resolved, how to > redirect files, what a pipe-line is, &c.), and AFAICT it's been that way since i > was a child, it kind of seems like that assumption went out the window a pretty > long time ago Some of those things are different in zsh, and some of the differences can't be explained in isolation. You can't explain how a while-loop or an if-else differs from csh without explaining concepts like "list" and "sublist", even though a bash user probably knows. You have to at least enumerate all redirection syntax if you're going to add explanation of file descriptor duplication and process substitution. But yes, extra details have been coming in for a long time. I meant to encourage some sort of agreement on when enough is enough, but maybe that's impossible (to know, not to agree on).