From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Maxim Cournoyer Newsgroups: gmane.lisp.guile.bugs Subject: bug#71684: [PATCH v2] doc: Document the peek and pk procedures. Date: Sat, 14 Sep 2024 00:47:43 +0900 Message-ID: <87v7yztv1c.fsf@gmail.com> References: <87jzi45tyn.fsf@gmail.com> <20240702164418.11886-1-juli@incana.org> <87r0c3w9vs.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="9419"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 71684@debbugs.gnu.org To: Juliana Sims Original-X-From: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Fri Sep 13 17:50:19 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 1sp8Ys-0002GO-Pd for guile-bugs@m.gmane-mx.org; Fri, 13 Sep 2024 17:50:18 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sp8YU-00041P-3R; Fri, 13 Sep 2024 11:49:54 -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 1sp8YS-000416-Sa for bug-guile@gnu.org; Fri, 13 Sep 2024 11:49:52 -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 1sp8YS-0003Kk-Iq for bug-guile@gnu.org; Fri, 13 Sep 2024 11:49:52 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=57feOpRhfOu3OUJNRBZM99naTRL0J18bWnLtq451/VE=; b=HTYQJWQaPfkeiFUfwJhJfqrVEstJJalCPIiNvJutRPyUwW5dAfArooq3R+4oZUxMXYVFYCCMeRgs66EeiJ86gW/Ga2xJf6XyT+/NJYMuf30HoM4RfpofjoT55OneKb8dVfOzywtKEPy6dGnlh2eAkODBsm4rtAicL1mtqB2tQ0pyUpSxu80IXNnR+YPuJDRb72uAfM52PmKMP/jpw/oeq/FxwoBWWSw2hSfGDO7ny7Dxk6v6qUIoXOO05M3vU5B4dHkFzQHn7xudqe03KEUZawmeHnJAdyufb9VZY26Rg3NRdfFCI5WWwzJj6oqiHoreNmDsBLhPFTd+TCc7q70HDQ==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sp8Yb-0007Et-Qd for bug-guile@gnu.org; Fri, 13 Sep 2024 11:50:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Maxim Cournoyer Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Fri, 13 Sep 2024 15:50:01 +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.172624254527684 (code B ref 71684); Fri, 13 Sep 2024 15:50:01 +0000 Original-Received: (at 71684) by debbugs.gnu.org; 13 Sep 2024 15:49:05 +0000 Original-Received: from localhost ([127.0.0.1]:44072 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sp8Xh-0007CS-3I for submit@debbugs.gnu.org; Fri, 13 Sep 2024 11:49:05 -0400 Original-Received: from mail-pl1-f175.google.com ([209.85.214.175]:59675) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sp8Xe-0007Bs-HI for 71684@debbugs.gnu.org; Fri, 13 Sep 2024 11:49:02 -0400 Original-Received: by mail-pl1-f175.google.com with SMTP id d9443c01a7336-201d5af11a4so26153555ad.3 for <71684@debbugs.gnu.org>; Fri, 13 Sep 2024 08:48:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1726242467; x=1726847267; darn=debbugs.gnu.org; h=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=57feOpRhfOu3OUJNRBZM99naTRL0J18bWnLtq451/VE=; b=Vl4lWyRbN3s+nL1VELOlSHASqoXTfy6nnzCyPCubujcuc9CKwwKudnhg2obueLDDhY w3GDt/5ByhIGdh8+oY36Cjt36b7vjQ0sC3OlL4j/FLQkbnm51xslcPvPf2KbHx2Hlpbh iJLY2P3CB7/DgcBagVt40Hfb/IBvVxkAmfkHNXvoMQQMM7Xy9G5Ygbr7Y+dOQyiV8PHb U4WkDiTvqVes5QIHTUWK5gGxjkR3vm6nVBNBmf1SyxUB9hLJc7eZ5blKidRMoxEPLECj oVWWifOYXPgkiycQvDJFexnyt4kvkMfYQIgkwbDfXGiLKXX8STenA08NATXxAjKog9aI oLEg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1726242467; x=1726847267; h=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=57feOpRhfOu3OUJNRBZM99naTRL0J18bWnLtq451/VE=; b=uxMx8NYt6dd1J9rLAmGIjVWJk1HzXEPQqH9mDXk384QrYcBNMTZN5tfc3GU9B0lScf DahX1AUlJx+24NlK0S0hC/Mcc1nvhWkW4lfwp8na88R2rXRyCevimkeJdq0j37rHs9by stGTDnYDAvj1qqN5AAdBWpzJMJ6AQxD+o7pu9PDNqBLkCkK2hzcvI+n/eqpvcyNLFYW5 MAh8y0cIESdNHxQfDUpT8qre24zjxaDoEHpaFR7KvQ0udenqs+MFKWbbUrzyoTP+Ll2o BPts8Reb3zOjnL/eMxvd4nFdyUYQGfFGs0DnWSRdPjny/JiJQ3EDQ3yID3ZSrh8p/TSu Hfpw== X-Gm-Message-State: AOJu0Ywkok3s2U+Uv//OQX6dVDXB8cVLSZp/mDC7ZBuDTnO+N4zPkAFm cwGVuEXdb135XWc++HVlRRWjs1Gfmv7Q5l0UxGQ0sON8OOtFMp5+NKmirIL8 X-Google-Smtp-Source: AGHT+IEHYA8Q7CS/ukrMWOva6FWOZeqhgMN9iAqR/6VFOn/UiQskozKu3Hms0P1MHFkN9N+yB1Ek9A== X-Received: by 2002:a17:902:e846:b0:202:3dcf:8c38 with SMTP id d9443c01a7336-2076e3f4b30mr99704745ad.44.1726242467042; Fri, 13 Sep 2024 08:47:47 -0700 (PDT) Original-Received: from hurd ([2405:6586:be0:0:c8ff:1707:9b9:af89]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2076afdd44asm29342255ad.125.2024.09.13.08.47.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 13 Sep 2024 08:47:46 -0700 (PDT) In-Reply-To: <87r0c3w9vs.fsf@gmail.com> (Maxim Cournoyer's message of "Mon, 08 Jul 2024 22:56:55 -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:10972 Archived-At: Hi Juliana, I hope you are still around. [...] >> +@code{pk} improves on using @code{write} directly because it enables >> +inspection of the state of code as it runs without breaking the normal >> +code flow. It is also more convenient than a full debugger because it >> +does not require the program to be stopped for inspection. Here is a >> +basic example: > > I hadn't commented on that last sentence before, but if I knew how to > have the Guile debugger reliably break where I want it to (I don't, or > somehow haven't managed to have it work well), I don't think using 'pk', > which requires editing files before and after debugging, could be > described as more convenient :-). I think your new addition above could be modified lightly like: +@code{pk} improves on using @code{write} directly because it enables +inspection of the state of code as it runs without breaking the normal +code flow. It is also sometimes more practical than a full debugger +because it does not require the program to be stopped for inspection. +Here is a basic example: With the above change, I'd like to see this in the Guile manual :-). Would you be able to send an easily applicable v3? Then the last step would be to tap on the shoulder of a committer in #guile. -- Thanks, Maxim