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.1 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED 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 31A40225B6 for ; Mon, 25 Mar 2024 03:35:16 +0100 (CET) ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1711334116; b=rmxkxW6Dg55Z13F4ogqcXRu4cokKGPA0jiQljZQ70MFsZ91vAP0Faj3zBdJhiExlVUeE2bDpG6 ffFpGQZp9tpdYWOiGDUhcbkRIyygV0uZgemTbrt6alCdYAzAdKm5fOH57hUsVV0WB3Ncrtn0g8 fokyPCz8HPRwf+UEGp9ukwZj3+HnY8ZQ904PvF4v0IigIphKYdpuCr/Z17k5Jub5/f/hieAy2N q9k3O0lhLGDaWfOzjfdDhcNIcYsIWqYCiuN4kqfJNoAsNFWBmziM4gXb08ZZJ6KLmsU+g5k/Vi iI6d2cYkR3dg1tW2JBmcDG7/JdBzGCvgQEhQJ7PqdtqZlw==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-ej1-f52.google.com) smtp.remote-ip=209.85.218.52; dkim=pass header.d=brasslantern-com.20230601.gappssmtp.com header.s=20230601 header.a=rsa-sha256; dmarc=none header.from=brasslantern.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1711334116; bh=0u6VXlppvQG1kxxsQ3uxBENUWgYCdVcDNNDnLAkscuc=; 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=CsFWmEF3BQjTughr2GiCGF6mBtOac6qgdYHwAo1xKONpDyo7HohueJ7cem+GrgIk8jbWKlo8WO xAxPNaIcOfxep4U08Lxswx8n6pJjF7G5vBNlP07b8MaVdB++5MqxYlTIuCnMd23eixOlN7NypZ mewtb6vgqXQ4zYzN8HAKxbQXk7uY775mB7UxbCPy9tIM4GGlcvvqSTl7zv53n3jW/dfYYDAGNM wtMQJ1A396IrKW8+UAowfVnSoQIVJ4PmsJSvfB5WGdjlo4MYcKDwU9fWVi4aGpR1JRr9MV9QIw 2F0bjYv2pALZPk5qfHehAd2Gthx80sx5j4T2xT//NZZkgw==; 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=iwPLV9K1RW0Yoj8qZncrJ9SqyrNuPj+x9MTdYdmlx2g=; b=IrlCMDPTxHLOW+T1mgVjYuwB5q 2X5NfsfIbD2QVwlL250kT4Mfc608zdWKO4zuVAZ8J5DWJvmkQfgU7PCZZuayk3JpTHktvuJSoBKFJ 0jslva8T/HAz3GvCejqgcou0MCdoB1gRRloKjbZ7aWwnkXJTe8j+fYf3sYJBa/hO6DE0zyhee0YWF 7C/uDdG24AKQ/5pQBLZEq7yiO2rWdqYl88qpiYO9VJVi9G+6hyc4dPlhiv1pVabzLniu8aOxSVDwA NDwicAv1laFeAlfQUyD7I6k2W4tcr9inOZZM0jn1x8YPB2aLwyl0jK2olDV5lymDZpiz4SkQG3irA 7ETzW8qQ==; Received: by zero.zsh.org with local id 1roaB8-000MPD-1M; Mon, 25 Mar 2024 02:35:14 +0000 Authentication-Results: zsh.org; iprev=pass (mail-ej1-f52.google.com) smtp.remote-ip=209.85.218.52; dkim=pass header.d=brasslantern-com.20230601.gappssmtp.com header.s=20230601 header.a=rsa-sha256; dmarc=none header.from=brasslantern.com; arc=none Received: from mail-ej1-f52.google.com ([209.85.218.52]:60876) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1roaAX-000M53-K0; Mon, 25 Mar 2024 02:34:38 +0000 Received: by mail-ej1-f52.google.com with SMTP id a640c23a62f3a-a466a27d30aso474364666b.1 for ; Sun, 24 Mar 2024 19:34:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=brasslantern-com.20230601.gappssmtp.com; s=20230601; t=1711334077; x=1711938877; 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=iwPLV9K1RW0Yoj8qZncrJ9SqyrNuPj+x9MTdYdmlx2g=; b=BUYmxjerJ8IAov3JnAB6kjO9JzPQRuto549Pp3RTSZ97G/FGBhbM+XDuCfDc3dFk5+ AJJ8E0NXpYxNXmR2bieDqRk0N38WvHvtLlpNre3nyApFrY5DaMqR/xiyahC8LGLNe7zi Ahx1mKB1P6G0d+X4T3lbFYxk9xIoxgT4RO1xDzsmagPi+ARhn2mltm1akRKSl1CeDGC3 cJ9WQ6lPtMn8PIX1TzegiGS9917oHkMcapGI6KCBdsO5H2+3SwT68L/5X2OyWgHv4xcg O9v7Dr7V1HhMm5E4UlnPpzC+gz9wKsHTG3bL9gRR5hPgF7StrTdheiyUj/Htrycnk1/U d6+w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1711334077; x=1711938877; 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=iwPLV9K1RW0Yoj8qZncrJ9SqyrNuPj+x9MTdYdmlx2g=; b=f/SsQSIt2G/1g+feRJgQqUUrHhWEfZLf3rrut/9VlwVXx1emFdrmfxbL/dr9A59O1x s7Z557rwcADMI3Qr2KTTpy0lsTYdTcBr9AIlIxeilgsbjLVbsxB6eNJ+cKtriE0Ly4ve hipNv9Uqx601nBoTFSvEk1QC7oBlc3xHbqyAXFUbTrNPWx6Eqo0iDOx1iRdWRuAK/U6d +uwK4ul+Ttrc+tZX1xuNrmr3/JwggFiyIg4BbOkKSdF6VCch71/bfPakVJC4QC8NVE3H 6I91kSksqpyGZOKREK1wEbJ3Ngmt8ZONA3/CQUhqsvS0sq+pEc04LZisBRPmPwus6DJQ 7gWw== X-Gm-Message-State: AOJu0YznwhmybvDX4Vwpm9SGn1358Xy+lUhCXHMVjllJZ+va+u7+KB5P IkIhsLBkMRLzJJVTMvHkHC8bqdjKHrmCSwYOAhueEKk1PDyegPDciuYU1wx7BfGBKf2S5TLRV0t fE2kbCg7SHdyucmoFHcqrKKqTlMB+sZnF4o2c2I3Dd9RmBIP5b8ms X-Google-Smtp-Source: AGHT+IHvLQsmCl5vaaTTKunIxW3j0wCqNZ3/TaNI3+y50ruE6N9fhIjOBz0tPPZo+RYqimyDxVzZaBZEnp23SJ/NnaM= X-Received: by 2002:a17:906:1d04:b0:a47:34c8:900b with SMTP id n4-20020a1709061d0400b00a4734c8900bmr3711254ejh.0.1711334076770; Sun, 24 Mar 2024 19:34:36 -0700 (PDT) MIME-Version: 1.0 References: <57374b5f-77b9-4dee-aaba-5c4bdeb1b281@zentaur.org> In-Reply-To: <57374b5f-77b9-4dee-aaba-5c4bdeb1b281@zentaur.org> From: Bart Schaefer Date: Sun, 24 Mar 2024 19:34:25 -0700 Message-ID: Subject: Re: [PATCH 0/1] zsh/random module To: Clinton Bunch Cc: "zsh-workers@zsh.org" Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Seq: 52810 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 Sun, Mar 24, 2024 at 7:11=E2=80=AFAM Clinton Bunch = wrote: > > zrand_int takes 0-3 arguments, an exclusive upper bound, a lower bound, > a flag to make the upper bound inclusive. Documentation remarks: +optional. If none are specified it is equivilent to Typo: "equivalent' +tt(inclusive) is a flag to determine whether the result can ever equal +tt(upper). By default it can not. If this argument is set to a non-zero v= alue +then it can. Something about the use of "can" in those sentences strikes me as odd. a flag that controls whether the result is ever equal to by default it is not then it may be ?? +possible return values 0-15, in order to use it as an array index which go= es +from 1-16 you need to add one. Since it can return zero, you don't want i= t +to return 16. It took me a few re-readings to figure out that "16" is meant as an example result of $#a from the previous two expressions. The switch to addressing the reader as in "you need" / "you don't want" threw me off. Perhaps adding: For example, if $#a is 16, and then end sentence and start again: values 0-15. Thus in order I might also change "Since" to "Because".