From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.0 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4 Received: from zero.zsh.org (zero.zsh.org [IPv6:2a02:898:31:0:48:4558:7a:7368]) by inbox.vuxu.org (Postfix) with ESMTP id 8660724075 for ; Fri, 26 Jan 2024 21:09:50 +0100 (CET) ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1706299790; b=LAgdaabmNSvC+RcrEUhzKgZh/IQRxSebrUkQ6SoETh1LPAbHrhghYKB4Xc15UR/cKeBjoOWyBf +OAUQ1KSLV39ueSDvBEsmK3BTf8P5ZhMjFL3sT75wK0jBd7bzTjDoqF3Pq9QF4gqK5i/PMa1Fi 96go9omT629FCfPW5JpHntS55ApfIVyBFDZm9wnUvuQecQCVx5XfLA/ZS4Ed+rhYzCC49dLUG2 J0QFT+BqFDXWuVeawpDZitiry9nRY3C04lBPMu3uoFD6s9I0Q9KbFpSBoSBsfF75f4C0MONHW4 cfzuGiVNHJWgPi0vzrm7b7iXbQ0Od5Mcke5h0fXz2FC1pg==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-lj1-f178.google.com) smtp.remote-ip=209.85.208.178; dkim=pass header.d=gmail.com header.s=20230601 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1706299790; bh=xCCavQ29/u8n/vfIzQA/28NXbYM7RthDttpCnlkRRVU=; 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=b8i34Js5+EMtRfdMdpLa+FGGhClv6hlOW9sr0hZrrd5uocX4nhLgTdb0ZgX7yERtYClQs9xxhj djVEzql8jLrbXal8tTgGR0GKVIb3ev0TGwE7xOvs0Ll3oTBfzOQVU2/MRr/jaRJKACFRbg/8Rj f/Iuh6fM9wU1WTM7fGyEuO014gS8AoVQVQSHmR3yw7r1JEMZASBbUH7WdazxRqbFus9+GXz5rz X4wmdLbFq4wsB8FyKQ7yoNZRZK+zw9md8zZa9qkDBlYKNGi3f9g+SRah11z4mGnrEuvTMTf3xR zCU5zVgr/JT4UULmr/lupNnAAJxvJSqNMyL5nr/FYdmClw==; 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=xCCavQ29/u8n/vfIzQA/28NXbYM7RthDttpCnlkRRVU=; b=IxowgOqPEcFeo7gXFpfgu/3OLb fvAwAGa3XK7p3o442CVq75DOH51x0E+wIjDnjlQX8rS1uuYAoWF5KGWn2uKtuKn8P7OKQMxMnF40B 6FebUPw0rzlUeiVec4kU9p8wQWseeC6PCKlM7DC0bPFdnWnh69TOvmuVwS3RlIVcbqb0KgPu4NMKI MF9/RJQa6y35ir8XvMo+6AEgj7SzyRBsQ+1AyoF76o+kuccq43FUzq8r1VmCzcAHXR86Vd8pLw7jo oPJ6dLcf8Y3sAQNaXTGA1m9h3YB+wdHay86j5vR4RDhdp28Ebgj3pcmLL+hYr1tLDIu/5vL7uKGir ZYlo/lDQ==; Received: by zero.zsh.org with local id 1rTSWM-000Ltk-9T; Fri, 26 Jan 2024 20:09:50 +0000 Authentication-Results: zsh.org; iprev=pass (mail-lj1-f178.google.com) smtp.remote-ip=209.85.208.178; dkim=pass header.d=gmail.com header.s=20230601 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none Received: from mail-lj1-f178.google.com ([209.85.208.178]:47370) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1rTSVd-000LCV-7M; Fri, 26 Jan 2024 20:09:05 +0000 Received: by mail-lj1-f178.google.com with SMTP id 38308e7fff4ca-2cf206e4d56so7675391fa.3 for ; Fri, 26 Jan 2024 12:09:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1706299744; x=1706904544; darn=zsh.org; 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=xCCavQ29/u8n/vfIzQA/28NXbYM7RthDttpCnlkRRVU=; b=Rg1aI51FI3RYDs15uFuVowVl+Hkgp61WBr0cwpXVRwSlX334xIEnZHl6gq2W/ZP9ZU QFFse3r1kODZeUgKFCthnT/4z+HZQbux/t0zNbyaB/PvQnZaOYjpY5vbeukIzqDjGji5 z+3e/sCWZkLl3HdT3lvhQyzT5zbuGYltqI4JdVNcFUvnqQcfQJf9kb3g0kwnVKhgv8ZC kuirbMX1nx+68+YZMMSxN+CsTPTXBRNtKDM1se1IznxpxJCBms5H6K9VQuNaJNAZD4kq T2zb+90DaAkbl3lArLDKkS6SyG03zfeccPEwY+WFtagdNlQPO4a/t61Zvjn1FKwJmnMW tKBw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1706299744; x=1706904544; 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=xCCavQ29/u8n/vfIzQA/28NXbYM7RthDttpCnlkRRVU=; b=LZfw7f92rRn+IdCL50p5O8QUHPjeQW0VZJYSQz34FxjOldjr3nXBp9awmdDNdouqxL gkfJuoz35sBs7Se48mlg+hjVI5YvxiTxIqAG5fABh/9d6LXpcH/8gbC/HMoeVoGCVc2N eI5ZoWaJXMBSAFnSKRxAL8TZdnGjMdOE8lsScHUhplBk6n5TjW4Mc+osSE6++e8YAc38 L+fiQGv/C+ReE4UzogZALzl6JpVfPycL3lyh3dyrQuTUgNV2PYI6RKGqygM5TYRoOzzh 4ZJPD/K75M6j8EUbZCWiwL2fZ7wEXo2fd86zJMPsiXIGH0JOw9vvBm1Xt8uNg9927yiN sn2Q== X-Gm-Message-State: AOJu0Yycv9qlwWNKtWQMtRvyxF7oQ2KcvrwHkMMMfx1GdEuhxIQ1cFdI ohw26x0zmDxZMBaHUKiJZs/OUvxKP+gh8/A5tHkMfBIw/AlzuE0iTBNNxc4fMAfzTekcUBPu/Cx vRjVytxkgvX5OMGzI5cnv6263Kig= X-Google-Smtp-Source: AGHT+IG7i1XDfYuNYvd0SUT2/V0HY850iDd3MhVugjbeHA0cmKivRVnIBX9tohYXHwBZNGP0dIwwXx/st7RKQsdCAEI= X-Received: by 2002:a2e:bc87:0:b0:2cd:936c:f2ad with SMTP id h7-20020a2ebc87000000b002cd936cf2admr210153ljf.20.1706299744382; Fri, 26 Jan 2024 12:09:04 -0800 (PST) MIME-Version: 1.0 References: <73E4333B-C282-4A58-837C-A50F73E13289@dondley.com> <680FA5D3-E8FD-49F2-9AE3-C169A6D9DA9E@dondley.com> <4a1df20e-70c4-41ed-b370-4fbbae0619b9@app.fastmail.com> <3DC872AC-5B19-468D-85D5-5D3A501EF7E9@dondley.com> <2CF29A22-6721-4275-8E92-7FF61CE4CDCB@dondley.com> <316F625D-EC13-43C5-808F-B78DD09E906C@dondley.com> <395469e2-bcfe-467b-b749-85a284876b64@eastlink.ca> In-Reply-To: <395469e2-bcfe-467b-b749-85a284876b64@eastlink.ca> From: Roman Perepelitsa Date: Fri, 26 Jan 2024 21:08:53 +0100 Message-ID: Subject: Re: Can't tell the difference in operation between PATH_SCRIPT and NO_PATH_SCRIPT To: Ray Andrews Cc: zsh-users@zsh.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Seq: 29591 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 Fri, Jan 26, 2024 at 8:43=E2=80=AFPM Ray Andrews wrote: > > They are indispencible in the same way that the blueprints of a nuclear p= ower station are indicpencible Exactly, zsh documentation is a nuclear power station blueprints. Transforming it into a basic physics tutorial would dilute its effectiveness as a specialized blueprint. For foundational knowledge, there are plenty of resources on the basics of physics. On Fri, Jan 26, 2024 at 8:52=E2=80=AFPM Steve Dondley wrote= : > > [...] instead of just dropping ZDOTDIR on my head like I already > knew what it was, it could instead say: > > On most systems,, a user=E2=80=99s zsh configuration files are kept in > their $HOME directory by default. If you wish to store these > modules in a different location, this can be modified by setting > the value of the ZDOTDIR parameter to a directory path of your > choosing. For example, if you wish your user to follow the XDG > specification, you might set the value to $HOME/.config/zsh. > Typically, this value is set in the /some/config/file configuration > file but consult your OS=E2=80=99s manual for details. > > This is a much gentler way of introducing this variable to me. I agree that your version would be better for someone unfamiliar with this concept. But can you see that it might be less efficient for someone who already understands it? And consider where to draw the line with foundational explanations. Should we also explain what $HOME is, what a directory means, or what 'consult' implies? I understand it's frustrating to read something you're not yet familiar with. This happens with any technical text. The documentation works well for those at a certain knowledge level. You can get to that level too, but you might need to learn from other sources first. Roman.