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,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 1145 invoked from network); 27 Mar 2021 20:59:46 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 27 Mar 2021 20:59:46 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1616878786; b=zsouMhprLksAHIR7yRoqFt5FRZkKHZ9LaCfEYsoQ9/aUzaf0qqLIMStEoJ5Pd9ZT0BZqRsavkb jyBAhBOBypeFZziu57gqqWmZnEldcZBVWzIj1DXxG/onfDJxSnogPVTU50VVveMWTPIfuJIils V8LUXiYvYizd/4zVqHkQI4A99+C4it0HItiI6jEtwtB+Cy+yHOTWij/Ksh64/kkTgEPIiMM7P+ mgI4iFLif3meuq7nq+c83mNG85VrpEZdPrMTng/sDj7+o2tOEDJqFEKycy/uI7/0Pquuddkav/ /yr71t1jLEhgRkkmIzAoEbJcV+ENuaC+dHvRIlZmC1C8xg==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (wout1-smtp.messagingengine.com) smtp.remote-ip=64.147.123.24; dkim=pass header.d=daniel.shahaf.name header.s=fm2 header.a=rsa-sha256; dkim=pass header.d=messagingengine.com header.s=fm2 header.a=rsa-sha256; dmarc=none header.from=daniel.shahaf.name; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20200801; t=1616878786; bh=N4Ibbn+cL3e+FI2EXxrUvJmvEShnDWIOBET3RZSP0LM=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:Content-Type:Subject:Cc:To:From: Date:References:In-Reply-To:Message-ID:MIME-Version:DKIM-Signature: DKIM-Signature:DKIM-Signature; b=LVhOAm8YEZ0ZWnwmID+RAc2fBscMpJZU/ECvOtg1vj/pwhIJBShXitPqqDEJbDfjGBBTb+xhki XrVqTj/2L84JocL/GXYhswXtaSu2p1tkr0lENzqDcfp8N4f4dUJV6flMfN9uHDd+aM8RNXF4dp R6BQsstcW6WdjmQAmXXOHv5t3ejA2d5SAoXsAO9F2FQ5NkxzASQr9pBXCX62ORXRP8NoUYL0uI K9pTu8f+7B3boO/ONfb9bJibSClIy/cqeUVX6K/gzQfX9UXQPpGDQe1We1THy7n0lIdxLVvQhy MY4t7fb1nlJG8cISXzUB4IxCfVof28WolKqfUb1pdUDvLQ==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20200801; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:Content-Transfer-Encoding: Content-Type:Subject:Cc:To:From:Date:References:In-Reply-To:Message-Id: Mime-Version:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=hvqkOEscnioSJj11D8BZBPoezK9OtI+vcWPNnQkaoSY=; b=W7AIOWcw+rs3H2tz549FD/GIq1 uBFnW1nm0AH7Tdxw1dY7y1/WW1hNyxlKvc1ujDD4amsPPyaklSZjIkDbsNOWOK601I7Ltx+3fF4sr hYgTa/K91abJgd081+nPVU5kWx6RVduMGoxsA9uLfm+n6+jkRdHC1G2Jfi8kiQSE/JxppyDYWWyxy 5JXLUYd79RnfWZmljfCnB8ROT6szlF5YLe1LkwnG4Gp7Il5jEuAPk6KU2inGdTvza2LnT/PZ1ULjN /RtGXTsCXDyuGTS26PQzvTd0JsE7yx2OE3onNnEiSUDwZhYRsbvh/ESwC/E4zhVltJZoqZT/izhes M8BwQTLA==; Received: from authenticated user by zero.zsh.org with local id 1lQG25-00078i-H0; Sat, 27 Mar 2021 20:59:45 +0000 Authentication-Results: zsh.org; iprev=pass (wout1-smtp.messagingengine.com) smtp.remote-ip=64.147.123.24; dkim=pass header.d=daniel.shahaf.name header.s=fm2 header.a=rsa-sha256; dkim=pass header.d=messagingengine.com header.s=fm2 header.a=rsa-sha256; dmarc=none header.from=daniel.shahaf.name; arc=none Received: from wout1-smtp.messagingengine.com ([64.147.123.24]:48623) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_256_GCM_SHA384:256) id 1lQG1q-0006zm-6L; Sat, 27 Mar 2021 20:59:31 +0000 Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.west.internal (Postfix) with ESMTP id 7BB1B10CD; Sat, 27 Mar 2021 16:59:28 -0400 (EDT) Received: from imap37 ([10.202.2.87]) by compute3.internal (MEProxy); Sat, 27 Mar 2021 16:59:28 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= daniel.shahaf.name; h=mime-version:message-id:in-reply-to :references:date:from:to:cc:subject:content-type :content-transfer-encoding; s=fm2; bh=hvqkOEscnioSJj11D8BZBPoezK 9OtI+vcWPNnQkaoSY=; b=QSbWK9SM3h0LWe2riZckiwH9Qu1yEiYyAQhcvEgTKZ 10TRO7d2qnpSfz3jRspKejL1ZU2JkaNJYQOWeMl70uKF3cmSFhDiSFcbM3bCIwA2 UyJFjaJoxHES0QKD1HFE7VpweD+GTC4M8yJGSYGbxSaU9pphIFvCVdA6ZxLzXIDW uFNlGuOyJeXUjyR9RaLtYnlguDJTMe6gt8Nt6stCcSCtwWp0+JDhX7sGNR7QVYJu fxtFkDcziSvZa7xdkioGxenRObFvtbuUWGQI6/3iy4tO9eOJJpRU7j3VD18Mp2Qp Np+kK22NcsnLJtGWBs0TOpmvI+Iq7pbV5set87ANVooQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm2; bh=hvqkOEscnioSJj11D8BZBPoezK9OtI+vcWPNnQkao SY=; b=X/az0chQPPANG241Y9cFysve6xbacgyjBpZQbHieiGw3NkxKBiP5YCnnN MHPawejy39WrqQS3YzzV3bX88go2AD4eGHFhOB8K9486lfbETzoMwEaXAbDaac3U +p4fBi1vaA4oH+EpvU36t4y32usEM1sdo5nMrmo+HreJPhKoNZz4eEfu390vegFI jqg0Og/WsZxQrDRD7giq8eSR8YPn7l782INQujRQ5dlNPjQOOq+vBJ7Jvp+CEPep 2X7GsrvMoI45fzEDKpH9hghWm8dncLR5uAGY0jcjEqgNam452NbDC9ipld4jyKNl swvqEI9VLnlXHzSkSkzfkSfvz0QNw== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduledrudehgedgudeghecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpefofgggkfgjfhffhffvufgtgfesthhqredtreerjeenucfhrhhomhepfdff rghnihgvlhcuufhhrghhrghffdcuoegurdhssegurghnihgvlhdrshhhrghhrghfrdhnrg hmvgeqnecuggftrfgrthhtvghrnhephfdtveehhfetveejjeejtefhleefvefgtdfhteeh ieeuveejjeefheehffdtiedvnecuffhomhgrihhnpehsfhdrnhgvthenucevlhhushhtvg hrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegurdhssegurghnihgvlhdr shhhrghhrghfrdhnrghmvg X-ME-Proxy: Received: by mailuser.nyi.internal (Postfix, from userid 501) id E2F786B40061; Sat, 27 Mar 2021 16:59:27 -0400 (EDT) X-Mailer: MessagingEngine.com Webmail Interface User-Agent: Cyrus-JMAP/3.5.0-alpha0-273-g8500d2492d-fm-20210323.002-g8500d249 Mime-Version: 1.0 Message-Id: <831dfccd-83cc-4a8e-9243-b5fc9b6b2d87@www.fastmail.com> In-Reply-To: <20210327205748.GI18178@tarpaulin.shahaf.local2> References: <64EB817D-F60D-4694-9406-4B67F8E3903E@icloud.com> <20210327205748.GI18178@tarpaulin.shahaf.local2> Date: Sat, 27 Mar 2021 20:59:07 +0000 From: "Daniel Shahaf" To: "Austin Traver" Cc: zsh-workers@zsh.org Subject: Re: I'd like to help maintain the Zsh Web Page Content-Type: text/plain;charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Seq: 48277 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: Archived-At: Daniel Shahaf wrote on Sat, 27 Mar 2021 20:57 +00:00: > Austin Traver wrote on Sat, Mar 27, 2021 at 10:07:21 -0700: > > I'd like to help maintain the Zsh site, as I think reliable, usable > > documentation plays a vital role in understanding software.=20 >=20 > Thanks! >=20 > > Is there any job, big or small, that you could think of, for me? >=20 > How about extending the documentation of the 'functions' builtin for t= he > issues mentioned in workers/48147 and its thread? In a nutshell, the > examples in zshbuiltins(1) under `functions -M` cause the function's > return code to be non-zero when the arithmetic expression evaluates to= > zero, which is problematic under =C2=ABset -e=C2=BB, moreover, simply = adding > =C2=ABreturn 0=C2=BB at the end of the function would break it. >=20 > The manual's sources are in Doc/Zsh/*.yo in the main repository. If > it's not clear how to edit and build them, then our developer > documentation may be in need of attention, too =E2=98=BA Note that the man pages and the HTML manual on https://zsh.sf.net/ are generated from the same sources.