From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Simon Tournier Newsgroups: gmane.lisp.guile.bugs Subject: bug#71684: [PATCH v2] doc: Document the peek and pk procedures. Date: Thu, 11 Jul 2024 10:59:08 +0200 Message-ID: <878qy8i9sz.fsf@gmail.com> References: <87jzi45tyn.fsf@gmail.com> <20240702164418.11886-1-juli@incana.org> <878qy9glbd.fsf@gmail.com> <877cdtuixm.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26612"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 71684@debbugs.gnu.org, Juliana Sims To: Maxim Cournoyer Original-X-From: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Thu Jul 11 12:00:44 2024 Return-path: Envelope-to: guile-bugs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1sRqbT-0006ng-Rp for guile-bugs@m.gmane-mx.org; Thu, 11 Jul 2024 12:00:44 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sRqas-0004aB-2e; Thu, 11 Jul 2024 06:00:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sRqap-0004Uj-G7 for bug-guile@gnu.org; Thu, 11 Jul 2024 06:00:03 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sRqap-0008Bf-5D for bug-guile@gnu.org; Thu, 11 Jul 2024 06:00:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sRqao-00072u-EH for bug-guile@gnu.org; Thu, 11 Jul 2024 06:00:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Simon Tournier Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Thu, 11 Jul 2024 10:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71684 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch Original-Received: via spool by 71684-submit@debbugs.gnu.org id=B71684.172069198127011 (code B ref 71684); Thu, 11 Jul 2024 10:00:02 +0000 Original-Received: (at 71684) by debbugs.gnu.org; 11 Jul 2024 09:59:41 +0000 Original-Received: from localhost ([127.0.0.1]:51096 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sRqaT-00071a-4d for submit@debbugs.gnu.org; Thu, 11 Jul 2024 05:59:41 -0400 Original-Received: from mail-wm1-f44.google.com ([209.85.128.44]:41275) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sRqaQ-000719-JS for 71684@debbugs.gnu.org; Thu, 11 Jul 2024 05:59:39 -0400 Original-Received: by mail-wm1-f44.google.com with SMTP id 5b1f17b1804b1-426593b99daso900695e9.1 for <71684@debbugs.gnu.org>; Thu, 11 Jul 2024 02:59:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1720691913; x=1721296713; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:user-agent:message-id:date :references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=L03Y+3EKUcnwG16ZTYRNh3Hj4bMXRkGWQzyFSD9I+SE=; b=US9hhA4HYUk7ltrExQKpYwfzJW7XuZZrz+TKhsjEv3GrTHkN92LNG4AjudqBDpGk92 jas2+iI0mS2YhcntNtogV4fqitAkJZTPEGbZy4x+4HzR9yYOMVW1Doxv1IoEvp5P1oS2 tWA4rNPxPvTnNMWYvsNmTlkhXzyweCU3TISoSIzCLZAGpKKlkf6+kNfXdTykSBDXNF8c QI5VC9idtRFwDKj5c/y0kV9zIi5CbEvaSgm8ri1yHm/3yzgdi1ZME1AJQMzMkFh2mAhA gBrSOdvZ6w/Swvqs3W3gARLMShfixPRsqMePEYtcQLspQ8DPYsvuLoe9emAEQZuWeq1i DGjw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1720691913; x=1721296713; h=content-transfer-encoding:mime-version:user-agent:message-id:date :references:in-reply-to:subject:cc:to:from:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=L03Y+3EKUcnwG16ZTYRNh3Hj4bMXRkGWQzyFSD9I+SE=; b=THsUx7RfxFt90dtfIHA38w5oO37YT7nT6ZKVN+N9YBlpqeid5fOUTfHoABOd8e6UHr +1lIgI9aSjG+sqCnVujOuJC6JKust9UhfkCt117QFZZJfVK24WCofmGGJcAz10vrGLIZ +mC2AdfHUPyJFK9b7JQdStyj7CF9OLRnJ7s3Qciv7wvueSoGAdH5QpqwwMQwRsrNlG89 sB6xLOkzEKhHqdwLwnHm8IY4oWWMbXWZ58ZNvcr4ZT8sAhCu51ay5o4UeecS4Dtj/4yd lRIBCMg9QZiMFzMEV5iWOBX8GyeOxg8xgx21MFnYNvW/5Cr3C+5TFOJMF0k6pMp+KBLA Ivdg== X-Gm-Message-State: AOJu0Yw/YZ+afXj4RLxGnHz7pZcON6NYJ1+SW6IzeckM5JY8d1exy4bS uojOYf/8DiaIlADHCQGKKGZiYJ0J/PJ97Uuw9WXJaWkAloxsUWb5HKGnrA== X-Google-Smtp-Source: AGHT+IE3FaCo9nR7/s6dKWQ6RfYNwP9xaw00SekGZxQXWoax6RGuq6gm/UiB199aylRWt9H98Sy6nQ== X-Received: by 2002:a05:6000:1849:b0:366:eb60:bd0c with SMTP id ffacd0b85a97d-367ceab5f38mr5729177f8f.3.1720691912840; Thu, 11 Jul 2024 02:58:32 -0700 (PDT) Original-Received: from lili ([2a01:e0a:59b:9120:a17c:5a42:b196:e92e]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-367cde84655sm7285072f8f.32.2024.07.11.02.58.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 11 Jul 2024 02:58:32 -0700 (PDT) In-Reply-To: <877cdtuixm.fsf@gmail.com> (Maxim Cournoyer's message of "Wed, 10 Jul 2024 15:48:53 -0400") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guile@gnu.org List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Original-Sender: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.lisp.guile.bugs:10891 Archived-At: Hi Maxim, On Wed, 10 Jul 2024 at 15:48, Maxim Cournoyer w= rote: > I think I'd prefer more simple examples than a single more complicated > one, if we go that route. I think the text explained 'peek' clearly > already, though, so I personally would opt to leave it as is, especially > since adding a 'begin' block to showcase multiple 'pk' calls goes > against the merit of peek of being least intrusive (it prints then > returns the value, so the code structure needs not be changed). Well, I do not have a strong opinion on the topic. :-) I would suggest to apply the =E2=80=99pk=E2=80=99 on the other branch, some= thing as: --8<---------------cut here---------------start------------->8--- (map (lambda (v) (if (number? v) (pk 'number v (number->string v)) v)) '(1 "2" "3" 4)) --8<---------------cut here---------------end--------------->8--- Cheers, simon