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.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 26703 invoked from network); 26 Aug 2022 04:27:42 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 26 Aug 2022 04:27:42 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1661488062; b=oxU1vuzyzXIEExsckrAd9hy2IrIT4qzlZ48dQPFFLhhPzlVjDwruWfWeBKz4VThYxEdPt2ZxZD zVkub6u7NIFVN9PnMX5qZB9Ir7gwmiOHzKW8sV7jIHYv96/uJ0yLLxqO+Ql2iwAGiX00rmqZ7z Q74JMFyqtvNF58kF/q7jqUozJGIk0ZITuTEG/BsWEQNeZjblDsaqXad365akdAViSG/ReeNFkV r1IEfOpBcqsdwD0Sike+raqj85XwG0E09+5f4CUO9RJEWwdQdgbRe2rjbLuqnredFaDDuaVV5s lo70/695Ec3795HriGVc9g8wSQIAIIkAUC2di0wJ3VbEzw==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-ej1-f49.google.com) smtp.remote-ip=209.85.218.49; dkim=pass header.d=gmail.com header.s=20210112 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=1661488062; bh=Sl3Gb9hV8XbVDu5nSWRrgFIFQSlUBh7ZaaRH2JkC0rQ=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Type:Cc:To:Subject:Message-ID:Date:From:In-Reply-To: References:MIME-Version:DKIM-Signature:DKIM-Signature; b=EpOSheWTWaQ3W1MuT5kVCw8uXZlvGF+eCtWAaUk4SOq6p+CPwyPgL7szp9WKegsxl7mr0u7/D8 JGDKjpx4K+xsPbhE6ZnXuvq63jWJzyOPRk7M4KZw3ltmvJQ5ij0HTkdbZu7rI0LN6VoT5P4ee8 C6/FZrEjFYeS059QwhQhtLQFN4VztUT7M6wyam5kxxUOZOjaiCy13MKBgz2GeI36k2lmj6VH94 05GK+482C5Yd4opIgC3H3JZQ60GGiMv1XJ0vOY3vXGyMcG3wHUChk2K0l8oaG2gdyZF8ws/hFu fB8R5pcJ2Gujq/A1jRAac3fcwhj8eNKzHqTm60nFAFSVqg==; 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-Type:Cc:To:Subject:Message-ID :Date:From:In-Reply-To:References:MIME-Version:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=/luWJZkNfeB5qhgQjpBiTD3B8/usUblYjkRYk5wkKEs=; b=Ogk6jR2giU85hMKT4MDxvb6GDq Qu902EzmCbFAklA9qMh2p9iMWxxbx9sph/cl+o/uNvk8p4aZVpD6judNJH2TQbpmlyPtP0jdWx+yP vWmeAssXoBZjESss33Kjf/M5IB4gbqqRJGT6/jZ4kbJNWd5g4oAkz9IDJBOFbk2P8d/IcYFdZBZhE ampx6SkBs048bJtVtuBN4qMwpd1CprM1s0Jg0cMjxudsKxWoD8w8a8N8f17MCag81MZh+ooQib1wF TCSsrE8p4/V+K5Bwp0qeMftl6nGKQnLVZJ7jKQDNuCflBFKzY13YDQI4Qhr972wAHvbDgxyhd+xtt iifM1crg==; Received: from authenticated user by zero.zsh.org with local id 1oRQwX-000KMd-HD; Fri, 26 Aug 2022 04:27:41 +0000 Authentication-Results: zsh.org; iprev=pass (mail-ej1-f49.google.com) smtp.remote-ip=209.85.218.49; dkim=pass header.d=gmail.com header.s=20210112 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none Received: from mail-ej1-f49.google.com ([209.85.218.49]:43859) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1oRQrQ-000Juq-Ii; Fri, 26 Aug 2022 04:22:25 +0000 Received: by mail-ej1-f49.google.com with SMTP id gb36so916084ejc.10 for ; Thu, 25 Aug 2022 21:22:24 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc; bh=/luWJZkNfeB5qhgQjpBiTD3B8/usUblYjkRYk5wkKEs=; b=QWok8XdUYfC+7aHhk8j4R96ExJIURmDNTLnRXazkOtGh/soqhyhlp49xYtrdBchT+T /+snKwnoafTSt4XLnUUZgalxPbF6S8Ob02wU2bb3TYjjpiwdC4WnRjLdnLg/smgxz03c +xxCzZFD+XfGvMU8Yj2UB/pQe7hNWXKBQ3BeQk+YpUDgvgzOc/reIjwLljWTZUjMARsF zyhTLInSkGBqRADG62xuK5cZW+97/OdlAExYOs01a7Sl7pkOZAA0idPKEnL3t4BK7oaN 8EgaPlib6x3+qQjxSRigDYWWtS65CTzC/iiqkoIW7OxOUzDab1T9ZRfCcdXZihFNESYj GX2Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc; bh=/luWJZkNfeB5qhgQjpBiTD3B8/usUblYjkRYk5wkKEs=; b=rR9okyIisTEGgdidixVb8mL/4U+vARlJtWT3lDfJc8M0+6jA7ToaoXi7K/zSjNd+Yy yqCHugUhaSoSp3wVW0fbcktuSdyjeMvegApcTniIHDPNudJqBMcJ2e/ZYXVOGWKC4ZSl bHZ8i6K3uvBkwJ/ZwyjYChCWj8qc/GcICFQnmfAF9tz7wmbxtQWYemQZ39wxHrhxP9a5 Ezli0B5mQlUSCS/C+3ghMywYM39dwGI4E+yf3Qox43MrOa+GlWdAeySwxuk9BSGxSkxD fEtyRLB4PfB7Ri3ZKSHyFZIw75zTXpyb4t48LwlxwH6eQaHgmJqSI41nhOtubJS8/XW2 q87A== X-Gm-Message-State: ACgBeo0DIzoCOwmE8ZT+lttaVAFVIb5aQXfxkT6+t1e79VvizSKY80y5 bc/JFXl0CIaxRI2ZH6pChGqt0QiCxze+orYGU7k9vUkEKLg= X-Google-Smtp-Source: AA6agR7W2q3vzl8v7UYKWopETFVg2MAcPc3zUkM1VZi4EafeavuPtwe/oLKnefzOZo/DjVbCFsJq7HjS43lNQkVTgmE= X-Received: by 2002:a17:906:8a62:b0:73d:5dfd:b20c with SMTP id hy2-20020a1709068a6200b0073d5dfdb20cmr4241323ejc.84.1661487744054; Thu, 25 Aug 2022 21:22:24 -0700 (PDT) MIME-Version: 1.0 References: <20220824043145.165779-1-felipe.contreras@gmail.com> <20220824043145.165779-4-felipe.contreras@gmail.com> <7779ec6b-10d5-410a-97da-5ec545cd6e1c@www.fastmail.com> In-Reply-To: From: Felipe Contreras Date: Thu, 25 Aug 2022 23:22:13 -0500 Message-ID: Subject: Re: [RFC PATCH 3/3] FAQ: sync newuser-install To: Bart Schaefer Cc: Zsh hackers list Content-Type: text/plain; charset="UTF-8" X-Seq: 50525 Archived-At: X-Loop: zsh-workers@zsh.org Errors-To: zsh-workers-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-workers-request@zsh.org X-no-archive: yes List-Id: List-Help: List-Subscribe: List-Unsubscribe: List-Post: List-Owner: List-Archive: On Thu, Aug 25, 2022 at 6:13 PM Bart Schaefer wrote: > > On Thu, Aug 25, 2022 at 3:44 PM Felipe Contreras > wrote: > > > > This is *less* complicated: > > Every addition of an option to change the way something works is > making the shell as a whole more complicated and the interactions > among the settings more difficult to explain and understand. That isn't true. That would be like saying every commit makes the code more complicated. Some commits do, sure, but not all. There are commits specifically designed to *reduce* complexity, and such changes are called refactoring. Options can be refactored too. Some changes in options can actually make multiple options unnecessary, thus reducing complexity. Others can simplify the explanation. This: sect(Why is my history not being saved?) label(321) In zsh you need to specifically enable history: verb( setopt SAVE_HISTORY ) Is simpler than this: sect(Why is my history not being saved?) label(321) In zsh, you need to set three variables to make sure your history is written out when the shell exits. For example, verb( HISTSIZE=200 HISTFILE=~/.zsh_history SAVEHIST=200 ) tt($HISTSIZE) tells the shell how many lines to keep internally, tt($HISTFILE) tells it where to write the history, and tt($SAVEHIST), the easiest one to forget, tells it how many to write out. The simplest possibility is to set it to the same as tt($HISTSIZE) as above. There are also various options affecting history; see the manual. Moreover, not all options nor all interactions need to be explained. There's a minimum set of options which are necessary to explain in order to make zsh useful to most people though. It is in the best interest of every user of zsh that these minimum options are as few as possible and as simple to explain as possible. Why would we intentionally make things harder for most new users? Cheers. -- Felipe Contreras