From debbugs-submit-bounces@debbugs.gnu.org Sun Jun 26 18:10:23 2022 Received: (at submit) by debbugs.gnu.org; 26 Jun 2022 22:10:23 +0000 Received: from localhost ([127.0.0.1]:49283 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o5aSU-0005Lr-Sn for submit@debbugs.gnu.org; Sun, 26 Jun 2022 18:10:23 -0400 Received: from lists.gnu.org ([209.51.188.17]:58930) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o5aSS-0005Li-5Z for submit@debbugs.gnu.org; Sun, 26 Jun 2022 18:10:21 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:55566) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o5aSS-00008Y-1U for guix-patches@gnu.org; Sun, 26 Jun 2022 18:10:20 -0400 Received: from mx1.dismail.de ([78.46.223.134]:44640) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o5aSP-0000yK-TD for guix-patches@gnu.org; Sun, 26 Jun 2022 18:10:19 -0400 Received: from mx1.dismail.de (localhost [127.0.0.1]) by mx1.dismail.de (OpenSMTPD) with ESMTP id 908e9455 for ; Mon, 27 Jun 2022 00:10:14 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=dismail.de; h=from:to:cc :subject:date:message-id:mime-version:content-transfer-encoding; s=20190914; bh=ez8vTMaAJ/YAZWhaiD5q6AHLpIFevy2p8CTKWyD9igU=; b= R/mIGNl2+sMkKQkQcrc62s/uwL2sk6A9sLgFR9J6cVEGTL2AFAsxS2Qt68OKcsBC P15sMp5DRPFr7kHa83kHzepfVC+XIOHW2vWZuUnKyxu5hTdOYr6pxTipAdG/SWK0 ng2o3hDJVOhkDdVHNoY2yWJx0zLIKJNG4IJ1xsfNVgRWDIoMqzUPHGfNxUYyIu3B a4/loulIJdchBtceVdA1GRiaNBXZDVU/JxtU5sGYFYk6hg72QaeLhfoncIlxLKdU pXFBd5V1nmDU69ia0rY3Pi/yRF/ZIYFB+g7H2yOakKT5bqXpICBbEPchLCbaIxGf 7zorcE2GAkzvI0zNfjrxQQ== Received: from smtp1.dismail.de ( [10.240.26.11]) by mx1.dismail.de (OpenSMTPD) with ESMTP id dc443fcb for ; Mon, 27 Jun 2022 00:10:14 +0200 (CEST) Received: from smtp1.dismail.de (localhost [127.0.0.1]) by smtp1.dismail.de (OpenSMTPD) with ESMTP id 4799efea for ; Mon, 27 Jun 2022 00:10:14 +0200 (CEST) Received: by dismail.de (OpenSMTPD) with ESMTPSA id c626f400 (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO); Mon, 27 Jun 2022 00:10:13 +0200 (CEST) From: jgart To: guix-patches@gnu.org Subject: [PATCH] gnu: python-debug: Improve description and synopsis. Date: Sun, 26 Jun 2022 17:09:38 -0500 Message-Id: <20220626220938.12896-1-jgart@dismail.de> X-Mailer: git-send-email 2.36.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=78.46.223.134; envelope-from=jgart@dismail.de; helo=mx1.dismail.de X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit Cc: jgart X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) * gnu/packages/python.scm (python-debug): Improve description and synopsis. [synopsis]: Improve synopsis. [description]: Improve description. --- gnu/packages/python.scm | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/gnu/packages/python.scm b/gnu/packages/python.scm index ad475d8acc..6611e13096 100644 --- a/gnu/packages/python.scm +++ b/gnu/packages/python.scm @@ -617,10 +617,11 @@ (define-public python-debug ((#:configure-flags flags '()) `(cons "--with-pydebug" ,flags)))) (synopsis - "High-level, dynamically-typed programming language (for debugging)") + "Python with the debug hooks enabled") (description - "This variant of Python provides an interpreter built with -@code{--with-pydebug} to help develop and debug extensions. See +"This variant of Python provides an interpreter +built with the @code{--with-pydebug} flag, enabling +debug hooks for development or testing purposes. See @url{https://pythonextensionpatterns.readthedocs.io/en/latest/debugging/debug.html}, for more information."))) -- 2.36.1 From debbugs-submit-bounces@debbugs.gnu.org Sun Jun 26 18:40:50 2022 Received: (at 56243) by debbugs.gnu.org; 26 Jun 2022 22:40:50 +0000 Received: from localhost ([127.0.0.1]:49302 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o5avw-0008Es-Kl for submit@debbugs.gnu.org; Sun, 26 Jun 2022 18:40:50 -0400 Received: from laurent.telenet-ops.be ([195.130.137.89]:45514) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o5avq-0008Eg-Sq for 56243@debbugs.gnu.org; Sun, 26 Jun 2022 18:40:46 -0400 Received: from ptr-bvsjgyhxw7psv60dyze.18120a2.ip6.access.telenet.be ([IPv6:2a02:1811:8c09:9d00:3c5f:2eff:feb0:ba5a]) by laurent.telenet-ops.be with bizsmtp id nygh270014UW6Th01yghwD; Mon, 27 Jun 2022 00:40:41 +0200 Message-ID: <19be37371b7a8e551cad80d45aa839e811f9c542.camel@telenet.be> Subject: Re: [bug#56243] [PATCH] gnu: python-debug: Improve description and synopsis. From: Maxime Devos To: jgart , 56243@debbugs.gnu.org Date: Mon, 27 Jun 2022 00:40:34 +0200 In-Reply-To: <20220626220938.12896-1-jgart@dismail.de> References: <20220626220938.12896-1-jgart@dismail.de> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-xL5VIKtX2Ost6Ssl4iOl" User-Agent: Evolution 3.38.3-1 MIME-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r22; t=1656283241; bh=bq2wJ7ZgpWbn5a8KIwMtwS46gw3M3086Qkq+NnqdgEs=; h=Subject:From:To:Date:In-Reply-To:References; b=Er5uG2ZtNORz1wlos7tvhCRKKfFb5AfGhKmP/9+/mtkEnJcZpSR++YdbTxL3QHbAZ y+poVHtvsSxiyKbRThO6Vx/qxzXUZqxMaqFZLJlH5I2aY/N6drSESeVP8KeDxsU6Il wpYje4O8tJHInQ3aL4QYAF3hZixuFqFYTDjxkEHCBDgegmZXPSs8HufTCH+qdvcXJy pW3egEB1c2RdGamAp3EcYywJn/iGmTM8jGqGoQj59RgwBfgd9z7cF+QFcUoygK9PUd 7FmgYDak80dOqi++OZUKbw97GwXaMLIgsRb20dDyGkZC2jmmDYutO1ylBYzFdRwmTt MxH802cECV2Gg== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 56243 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --=-xL5VIKtX2Ost6Ssl4iOl Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable jgart via Guix-patches via schreef op zo 26-06-2022 om 17:09 [-0500]: > =C2=A0=C2=A0=C2=A0=C2=A0 (synopsis > -=C2=A0=C2=A0=C2=A0=C2=A0 "High-level, dynamically-typed programming lang= uage (for debugging)") > +=C2=A0=C2=A0=C2=A0=C2=A0 "Python with the debug hooks enabled") > =C2=A0=C2=A0=C2=A0=C2=A0 (description > -=C2=A0=C2=A0=C2=A0=C2=A0 "This variant of Python provides an interpreter= built with > -@code{--with-pydebug} to help develop and debug extensions.=C2=A0 See > +"This variant of Python provides an interpreter > +built with the @code{--with-pydebug} flag, enabling > +debug hooks for development or testing purposes.=C2=A0 See > =C2=A0@url{https://pythonextensionpatterns.readthedocs.io/en/latest/debug= ging/debug.html}, > =C2=A0for more information."))) I can't tell whether the old or new description is better but the new synopsis seems better to me (more to the point and descriptive -- you can do debugging in the regular python too!). Maybe it would be even better to make clear in the description that you can also do debugging with the _regular_ python package? Greetings, Maxime. --=-xL5VIKtX2Ost6Ssl4iOl Content-Type: application/pgp-signature; name="signature.asc" Content-Description: This is a digitally signed message part Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- iI0EABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYrjgYhccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7p0NAQClOtJD11CM/wBPJQu/Q7Oq+amc DN1FlvYWuzxcyOTcSQD/bPzb6dwm4E7kAUST7wd2rvdIsAlkCtg3EyGMhS7FtQs= =W48x -----END PGP SIGNATURE----- --=-xL5VIKtX2Ost6Ssl4iOl-- From debbugs-submit-bounces@debbugs.gnu.org Fri Jul 15 23:54:41 2022 Received: (at 56243-done) by debbugs.gnu.org; 16 Jul 2022 03:54:41 +0000 Received: from localhost ([127.0.0.1]:42681 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oCYt4-0008J0-6j for submit@debbugs.gnu.org; Fri, 15 Jul 2022 23:54:41 -0400 Received: from mail-qt1-f174.google.com ([209.85.160.174]:44637) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oCYsz-0008Ih-23 for 56243-done@debbugs.gnu.org; Fri, 15 Jul 2022 23:54:36 -0400 Received: by mail-qt1-f174.google.com with SMTP id r21so4476839qtn.11 for <56243-done@debbugs.gnu.org>; Fri, 15 Jul 2022 20:54:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=Va9lN8v+W4TGugseQluPE9fXJTB/rwvz8fLUjc5nlpY=; b=bT5MXkBWfWPZqyw5AFQMdPGosK3XDltll3OkF//IkhWs7NcDmHGzmbrbFCd7ZuChNo qiosyVtkhha7y4jcP7qD+7SVuXZ2bWxGkdM0PKK/8BPgSlXJ4VptPQgU3BjYwhXr3AHg Y/ZirPjhI1pcIWBk4f51x72spXik0Vpmn3ObOJ62SUun2WG7cEiomGEKyleP+iIex52x 2Reei/kbL3BbUAqXWvHpiG6jNCDpmP/kakpnyPNZbjGhSqP29WooLmdU4zgyP+Z0k0Iw ldyg2q/FB/YO8dCbQlwImjFnH96SNlW9k44ifMSZUKwR3QZOprJBIwE67PWVnZwXW8lT KxGw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=Va9lN8v+W4TGugseQluPE9fXJTB/rwvz8fLUjc5nlpY=; b=2vS5ypYhedEO5E2jv9rUTptLBdbcoWp75dHqBdIbbrT5nso1PTSF1bxrdH4WN+3Sil WwrD7UgNMnS8BjaRANpGwZWsm1vH573FoTDkxlspFMti0WErnlPrJAPHTCPkcNcwKLMV wqtdHW4zxX/GuWDjzy1Tqnn1TwgDz/k+gvy4UvN+dMrDqM6a6KIhXKhybXhzlzcbp02T VszCWIU0u/9ooJ1tYSfKTmsjk2xNJMqQNfeqjTaGAPPVmqIPy6ApH8GsK8HaVMojSC2m lEzPiaWZBTzla9MxVkDZQulEAA7MDOroSI2H29Y4wyc+VVWNdOTCJuXNPLesNfgolO1P AZdg== X-Gm-Message-State: AJIora9kIgltE1AifBDAzZEUMLKZ2FibhQ6Vq9L4hcaRFa7iTSOAIokU Qv3jorUT3sVH04EArfdeKK517XZkTRMU7OPD X-Google-Smtp-Source: AGRyM1vI1zPIyhN75MUMDWS4KZkqHDcnefsFJpkX04DknTe9iOOx0iBS3oU0sWXj7HZe4yS/T5xV7A== X-Received: by 2002:ac8:580c:0:b0:31e:e03d:dc57 with SMTP id g12-20020ac8580c000000b0031ee03ddc57mr3301630qtg.402.1657943667364; Fri, 15 Jul 2022 20:54:27 -0700 (PDT) Received: from hurd (dsl-205-233-125-176.b2b2c.ca. [205.233.125.176]) by smtp.gmail.com with ESMTPSA id b25-20020ac87559000000b0031ed91c84f9sm3263861qtr.81.2022.07.15.20.54.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Jul 2022 20:54:27 -0700 (PDT) From: Maxim Cournoyer To: Maxime Devos Subject: Re: bug#56243: [PATCH] gnu: python-debug: Improve description and synopsis. References: <20220626220938.12896-1-jgart@dismail.de> <19be37371b7a8e551cad80d45aa839e811f9c542.camel@telenet.be> Date: Fri, 15 Jul 2022 23:54:25 -0400 In-Reply-To: <19be37371b7a8e551cad80d45aa839e811f9c542.camel@telenet.be> (Maxime Devos's message of "Mon, 27 Jun 2022 00:40:34 +0200") Message-ID: <87ilnxr9u6.fsf_-_@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 56243-done Cc: 56243-done@debbugs.gnu.org, jgart X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi, Maxime Devos writes: > jgart via Guix-patches via schreef op zo 26-06-2022 om 17:09 [-0500]: >> =C2=A0=C2=A0=C2=A0=C2=A0 (synopsis >> -=C2=A0=C2=A0=C2=A0=C2=A0 "High-level, dynamically-typed programming lan= guage (for debugging)") >> +=C2=A0=C2=A0=C2=A0=C2=A0 "Python with the debug hooks enabled") >> =C2=A0=C2=A0=C2=A0=C2=A0 (description >> -=C2=A0=C2=A0=C2=A0=C2=A0 "This variant of Python provides an interprete= r built with >> -@code{--with-pydebug} to help develop and debug extensions.=C2=A0 See >> +"This variant of Python provides an interpreter >> +built with the @code{--with-pydebug} flag, enabling >> +debug hooks for development or testing purposes.=C2=A0 See >> =C2=A0@url{https://pythonextensionpatterns.readthedocs.io/en/latest/debu= gging/debug.html}, >> =C2=A0for more information."))) > > I can't tell whether the old or new description is better but the new > synopsis seems better to me (more to the point and descriptive -- you > can do debugging in the regular python too!). Maybe it would be even > better to make clear in the description that you can also do debugging > with the _regular_ python package? I pushed the improved synopsis, but also had doubts about the description change, so left it out in 15943fa75788edb8d9ed1c3d8d320f50d21e4baa. Closing. Thanks, Maxim From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 16 00:04:28 2022 Received: (at 56243-done) by debbugs.gnu.org; 16 Jul 2022 04:04:28 +0000 Received: from localhost ([127.0.0.1]:42711 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oCZ2a-0002Jf-Ga for submit@debbugs.gnu.org; Sat, 16 Jul 2022 00:04:28 -0400 Received: from mx1.dismail.de ([78.46.223.134]:34716) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oCZ2X-0002JP-M9 for 56243-done@debbugs.gnu.org; Sat, 16 Jul 2022 00:04:27 -0400 Received: from mx1.dismail.de (localhost [127.0.0.1]) by mx1.dismail.de (OpenSMTPD) with ESMTP id cf833f33; Sat, 16 Jul 2022 06:04:18 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=dismail.de; h=date :message-id:from:to:cc:subject:in-reply-to:references :mime-version:content-type:content-transfer-encoding; s= 20190914; bh=0Kh286XJqKj87nLyZOEGhVawISByIdvxf+Hvf0eXlfQ=; b=BA6 hF7olVI2s1xsCA1+G+Xc0UQgodR5XFrn7ixRKVgRPttpaQIciT8hidMdyRb7g7uv OgwKaQh/rRZrM5DQ/jPVLCKxP0Z/Q6GXTYFiT9FXMAAIpmUyDOCEOLY+0/Epjjj3 vqAQdiPdiYsxtpj4JH66APq6Fvfc6mehr7QFvcH8H9iPaP9BtOWMJ/xmEvKCvzo7 QNFk6/txCffaJXIOUakRk460nCHoh7k/9Tx5+4Uw+60UcZykBMlKndB6Aa4AO+bl XF8iqAqMbJZDeSHHP+jm63SY0ZlNB5ApsAMQoY/gZVSTYhI3wNjE9L9lbQLFcucW rW/ZmPKzd2m+Sc82w+g== Received: from smtp2.dismail.de ( [10.240.26.12]) by mx1.dismail.de (OpenSMTPD) with ESMTP id 70bedfac; Sat, 16 Jul 2022 06:04:18 +0200 (CEST) Received: from smtp2.dismail.de (localhost [127.0.0.1]) by smtp2.dismail.de (OpenSMTPD) with ESMTP id 7c4fceef; Sat, 16 Jul 2022 06:04:18 +0200 (CEST) Received: by dismail.de (OpenSMTPD) with ESMTPSA id 9f6a233c (TLSv1.3:TLS_AES_256_GCM_SHA384:256:NO); Sat, 16 Jul 2022 06:04:17 +0200 (CEST) Date: Fri, 15 Jul 2022 23:04:25 -0500 Message-ID: <20220715230425.GB1120@gac> From: jgart To: Maxim Cournoyer Subject: Re: bug#56243: [PATCH] gnu: python-debug: Improve description and synopsis. In-Reply-To: <87ilnxr9u6.fsf_-_@gmail.com> References: <20220626220938.12896-1-jgart@dismail.de> <19be37371b7a8e551cad80d45aa839e811f9c542.camel@telenet.be> <87ilnxr9u6.fsf_-_@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 56243-done Cc: 56243-done@debbugs.gnu.org, Maxime Devos X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) On Fri, 15 Jul 2022 23:54:25 -0400 Maxim Cournoyer wrote: > I pushed the improved synopsis, but also had doubts about the > description change, so left it out in > 15943fa75788edb8d9ed1c3d8d320f50d21e4baa. Hi Maxim, Sorry I couldn't get to it in time but thanks for working on it. all best, jgart From unknown Sun Jun 22 04:23:31 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 13 Aug 2022 11:24:06 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator