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 5BF5D25F1D for ; Fri, 26 Jan 2024 20:39:19 +0100 (CET) ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1706297959; b=NMAD6m3/chQeOK0XYe/EcU+W7VX7PPFYOvtFrF0SuGAlOpCVTXWnPeF1axYUvoYb5hJAwcjXXy FGtm0La+crWD0jbp3jIdAsSIoJkPY2j5s7KOGj+wPBv9qOP05LOn07P3eFKKVR20wkvaALRE6n x4u7vZDs/3t/6jg+jXJ++X0svbdF+XMdBW5AcixmoEYq29oxECKnIsu+C4VLjtUCOP0hfNaYMp +KKJ9WX+pahrHyuSQdWV2XeBxEYysCOa5JVtEQGy4W7KHXsnS32RgV1LYsYI2r0VrzKIrFBx81 8BvVXC7iiNT8VHlMolBsS5GrgvCkwFKpBhpRDr+B/93ADw==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-lj1-f180.google.com) smtp.remote-ip=209.85.208.180; 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=1706297959; bh=6oM2Y716FPbW+LWAtFlMvElLj2vnJTPmHFN9NTRp4TM=; 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=S0Xfm+A1IAHA0Hb8AWdwMCegzm6yJ0DbC8kqCGNuOafS8CkZk57oUhTSL08e4xa+OYDTCHFbt3 UOJY/39DZIhY/fQysERSAB9aLkQm/0mNCBzF31Og4cXicN+R1km/lSRWFBuC0SDtwQjs/C9Po4 U3Yk31+zkfcK1BdIPNK1ocrueiu0XQr7KDzoqJGwwo83Fr09vieGAhfB66Zw+5nlk85U9q//4o oMtjHFgy1JuQhFAyVOg8H9q5e6StgwDB3gDUKHlh4kr7itcEhqrQ3cKulztcchX7BZEWwSuL51 irc33LCU22bi75kUK3qMctAGpEOVrlh/0C9VZ9bYpTLOTw==; 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=6oM2Y716FPbW+LWAtFlMvElLj2vnJTPmHFN9NTRp4TM=; b=XMSZcrGgHFbUKNhh/BICALvZUi 2I6uTjIJbpBuHjqeEatM/Ye8sDyjVft7aiCRrTczDF5WkNu8DvsZtKM8Hkh0IkLOt0M9Jk5f/PsOo 7wyuT4+nIazJDOQIHAUI0cAdLaUbL8+Av0AG4XLULMrrw+Cj4UFJpZ/1JumJCJFE0k489jwjAVqbb U+zZIt+Suwzfu2SmZ0vyOYE64r3K8ZNSqUR6zzlC4acXgQXBsAU0JytUyBYws6g0J0UNEGc9hoquf qpLmq38kyTF85enG/4atyTBo3oTdXzwQkWoHRHZWHBTCjRVPF1z+jqObcdQlPB7zy1yVQRdRgIa05 EaVY5rIQ==; Received: by zero.zsh.org with local id 1rTS2p-000Dry-Fd; Fri, 26 Jan 2024 19:39:19 +0000 Authentication-Results: zsh.org; iprev=pass (mail-lj1-f180.google.com) smtp.remote-ip=209.85.208.180; 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-f180.google.com ([209.85.208.180]:43190) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1rTS1w-000D7v-TO; Fri, 26 Jan 2024 19:38:25 +0000 Received: by mail-lj1-f180.google.com with SMTP id 38308e7fff4ca-2cf33b909e8so20254891fa.0 for ; Fri, 26 Jan 2024 11:38:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1706297904; x=1706902704; 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=6oM2Y716FPbW+LWAtFlMvElLj2vnJTPmHFN9NTRp4TM=; b=BJgSWyko0LQyyOr9GD+QvS5M1u8hsjBHWrJzqPdMhRrrZDOZhWTcxwTBN42g+j8MQN QjGtdojZNdBhc7tPW01KNENen3abeLOlm45v/Ai3mldETFLPJnj60z407wvlmhVS93Xn yv9jrxhf2kR6Y2hLnQLcBCOh+5zaecA10XKUrkuGC8BoH69SvL57k6XsnlMkmepa3cy7 5nwXzbZItz/U5NrFdSD5vu0fVIsI8Cl0MeTPf10ax7u4e12Zlqmu5no5TfToTVV9msXa SdNGxPptTmCVc8RfBIjq9VNVUkdwbaNCzlllLVT4JYlTV5Vx1RvB8IWy2zvxX15cXWZz 5zXQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1706297904; x=1706902704; 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=6oM2Y716FPbW+LWAtFlMvElLj2vnJTPmHFN9NTRp4TM=; b=rB/qrIwWs3NdnQqBOB+emnEhVOkX1wUxPVMKsapPEWEXkSxQcoJmLUahH5c09JdD98 bGoVj/OMZB3nIj5Hnar1ZGGQ49srclK8ZozxLfwZciIx8gSZgFNIl2mNBL7fnjemxuGC QHaRV7hmiiqSWEabXSjf8r7tNrCg7Nhwt2VF8TGlFoie0De7UgkSJ31aubFgG6qqhw+D 9vwp/XkBETDQtPNnlzpFZDrbIiGuuk1UX1xeLRCuZwId92uj0hSxcxQ1JenEw0IVHsIA r9G+QmTSnWmUyGc7dqQ9y5wOUY5kEBSBnYVMEmWl+RlbJeACV9N4CqaSu5oBK/6VzNko x9yw== X-Gm-Message-State: AOJu0YwdmiyTZ+/UGOfwuDiOzYvNzFFK4j+XpQDc74iNP/NDAUQVyDN4 FBJ0HEZ95hpsUT98OhKlgiZD02W5Y+plLbT3lN/EoqcQfWdRakuRYXaUMGEMub/qpiJE+52PO4D YeskPt9jndU8WJgS3ISBQFVcBYkM= X-Google-Smtp-Source: AGHT+IHiKIwEMABbHQnSZJSTuSln2Eg2yosDlxuOHDxqfpoPD2QZnMlUVKYJOe7Kq79xE4ARoXpUBhZqf4uhrl4tY24= X-Received: by 2002:a2e:9c4e:0:b0:2cf:15be:462e with SMTP id t14-20020a2e9c4e000000b002cf15be462emr205474ljj.11.1706297903910; Fri, 26 Jan 2024 11:38:23 -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> In-Reply-To: From: Roman Perepelitsa Date: Fri, 26 Jan 2024 20:38:12 +0100 Message-ID: Subject: Re: Can't tell the difference in operation between PATH_SCRIPT and NO_PATH_SCRIPT To: Steve Dondley Cc: Ray Andrews , zsh-users@zsh.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Seq: 29585 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:17=E2=80=AFPM Steve Dondley wrote= : > > I see ZDOTDIR listed in the =E2=80=9CParameters=E2=80=9D chapter. I have = no idea > what a =E2=80=9CParameter=E2=80=9D is. Consider a cookie recipe that starts with "Cream the butter and sugar until light and fluffy." It assumes a basic understanding of baking techniques. Similarly, the zsh documentation, with terms like "Parameter", presupposes basic shell knowledge. It's geared towards those who have this baseline, much like the recipe book is for those with rudimentary cooking skills. > But my main point is that it feels like the documentation makes the > assumption you know how a typical shell works and that you are > familiar with the many common features between the different kinds > of shells. Your observation is correct. All documentation, including zsh's, must assume some level of prior knowledge. When our understanding doesn't meet this level, it can be challenging and frustrating, but we can bridge this gap through other resources. On the other hand, if the documentation were too basic, covering familiar ground, it would be inefficient for advanced users, leaving them to sift through redundant information. Roman.