From unknown Fri Jun 20 20:10:22 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#70640 <70640@debbugs.gnu.org> To: bug#70640 <70640@debbugs.gnu.org> Subject: Status: A Texinfo aware `,describe` command. Reply-To: bug#70640 <70640@debbugs.gnu.org> Date: Sat, 21 Jun 2025 03:10:22 +0000 retitle 70640 A Texinfo aware `,describe` command. reassign 70640 guile submitter 70640 Yuval Langer severity 70640 normal thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 28 23:49:03 2024 Received: (at submit) by debbugs.gnu.org; 29 Apr 2024 03:49:03 +0000 Received: from localhost ([127.0.0.1]:54601 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s1I0k-00016X-Ft for submit@debbugs.gnu.org; Sun, 28 Apr 2024 23:49:03 -0400 Received: from lists.gnu.org ([2001:470:142::17]:53084) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s1I0i-00015Y-HC for submit@debbugs.gnu.org; Sun, 28 Apr 2024 23:49:01 -0400 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 1s1I0G-0005ES-Rc for bug-guile@gnu.org; Sun, 28 Apr 2024 23:48:32 -0400 Received: from mail-lj1-x229.google.com ([2a00:1450:4864:20::229]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1s1I0E-0007hc-E6 for bug-guile@gnu.org; Sun, 28 Apr 2024 23:48:32 -0400 Received: by mail-lj1-x229.google.com with SMTP id 38308e7fff4ca-2dd6a7ae2dcso62421101fa.1 for ; Sun, 28 Apr 2024 20:48:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1714362507; x=1714967307; darn=gnu.org; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=9InXxXuxmnbLsVDj/fvaK75GIu8XJJoLbW9KdOWLWqo=; b=ZjwAaFbndp2Hs2StKkwPGxBWAGzL0kL9mBRZEG7eR0iKsM7VeaFXk+8+SqxoSxuVwg U6is1uk3SXQDuFlgtZtqvwYykJ2UCfBnpLQAng/mU+Ou+SBvhfplH9zvEMzTewvmI/Wt MRR+wYnFFBufng7c208nJ5WE7QzB9/xGSysN2IJKqx9HHzNeIX+DUr1C6lIVEkYeM697 hqcdm0AWBYt0mh6tsIZjQIKXJPAydsmAT1osQK6nhhDvv47PZfRAyP/PIvJnEZOzciiA Ir6PPa57qzuI4mPAFTQFvEUQFutklCiHRQdWlx5snWHFw2TabUGH01lGErx8De+xbzPJ O4wQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1714362507; x=1714967307; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=9InXxXuxmnbLsVDj/fvaK75GIu8XJJoLbW9KdOWLWqo=; b=usQu5rCYMvGV5aeAGaii6QF/ashte61ZiJOBfu+63j0HUdNZSmYsn8NxeP9fyILt8T 2fhfHNV920PC8ymRkbzK4qXvWz26KJ8DbgiSkpu3JWzP1ziI9iRbyNPPzG+dqli+Idcv +xGlsGvyfPqeLbz+oYIaxf4VHfI+K4PngbONLhw+jwuYLyfuSlXO6xC0hABG/ywjkorx yO58bJkYx7yg8X+Pjv8y6CKzdyEUrMp/niVPEFKdr/mu62IUtaUecP/19se6PWlt/Gbr Ej6UhjLmzR0CqvsnEzJ01BpK4cUfex/fTlShVMzKI/o0VfpAXatCT4nY1aKF1Q/M68F+ 1klg== X-Gm-Message-State: AOJu0YzY5TzC45S2zA61HTyt2wgwxRdmaG1+lxz4yzsK/prAKOeCqypU hEEwIciFUpkMMdNeoYgd68WEYUJ0eym0mxDVVUapxPRWJ6+xHiIsHOrsJDlb/6XnL3/ONlrLbxS HoqQ4e9Vv10IZGewaXwMvkxSD5a+eGvrj X-Google-Smtp-Source: AGHT+IFAm3qTF0CKwKY4qLVVZF3fbNHd+e0dgkwTDWuRdDhNAhOHszwVwIVrtW2Wku8IOhTtBYasQlBQ7dw35AfKjSo= X-Received: by 2002:a2e:87c2:0:b0:2de:c912:ec08 with SMTP id v2-20020a2e87c2000000b002dec912ec08mr6807971ljj.16.1714362507263; Sun, 28 Apr 2024 20:48:27 -0700 (PDT) MIME-Version: 1.0 From: Yuval Langer Date: Mon, 29 Apr 2024 06:47:50 +0300 Message-ID: Subject: A Texinfo aware `,describe` command. To: bug-guile@gnu.org Content-Type: multipart/mixed; boundary="000000000000431caa0617342008" Received-SPF: pass client-ip=2a00:1450:4864:20::229; envelope-from=yuval.langer@gmail.com; helo=mail-lj1-x229.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: submit 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: -0.0 (/) --000000000000431caa0617342008 Content-Type: text/plain; charset="UTF-8" Hello hackers, I have noticed there are many docstrings containing Texinfo markup, but when one runs the `,describe` command, one gets the Texinfo markup source, not a render of those Texinfo commands. I wish to write a better `,describe` command that would render Texinfo in a pleasant way. Attached are some procedures I wrote for this purpose. They are far from being complete, but I wish to start a conversion about the topic. I searched for the describe command in the guile source code and found: https://git.savannah.gnu.org/cgit/guile.git/tree/module/system/repl/command.scm#n346 Is that the right place? Also, the code of these files is currently stored in: https://codeberg.org/kakafarm/guile-fancy-describe/ Also also, previous message related to this: https://lists.gnu.org/archive/html/guile-devel/2024-04/msg00015.html --000000000000431caa0617342008 Content-Type: text/x-scheme; charset="US-ASCII"; name="fancy-docstrings.scm" Content-Disposition: attachment; filename="fancy-docstrings.scm" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_lvkf4y3i0 KGRlZmluZS1tb2R1bGUgKGZhbmN5LWRvY3N0cmluZ3MpCiAgIzp1c2UtbW9kdWxlIChzcmZpIHNy ZmktMSkKICAjOnVzZS1tb2R1bGUgKHRleGluZm8pCiAgIzp1c2UtbW9kdWxlIChpY2UtOSBkb2N1 bWVudGF0aW9uKQogICM6dXNlLW1vZHVsZSAoaWNlLTkgbWF0Y2gpCiAgIzp1c2UtbW9kdWxlIChp Y2UtOSBwcmV0dHktcHJpbnQpKQoKKGRlZmluZSBhbnNpLWJlZ2luLWJvbGQgIlx4MWJbMW0iKQoo ZGVmaW5lIGFuc2ktYmVnaW4tdW5kZXJsaW5lICJceDFiWzRtIikKKGRlZmluZSBhbnNpLWVuZC1p dC1hbGwgIlx4MWJbMG0iKQoKOzs7KHByZXR0eS1wcmludCB0ZXhpLWNvbW1hbmQtc3BlY3MpCgoo ZGVmaW5lIChkaXNwbGF5LWZhbmN5LXN0cmluZyBzdHIpCiAgIkRpc3BsYXkgYSBmYW5jeSBAdmFy e3N0cn0uIgogIChkaXNwbGF5IGFuc2ktYmVnaW4tdW5kZXJsaW5lKQogIChkaXNwbGF5IGFuc2kt YmVnaW4tYm9sZCkKICAoZGlzcGxheSBzdHIpCiAgKGRpc3BsYXkgYW5zaS1lbmQtaXQtYWxsKSkK CihkZWZpbmUgKGRpc3BsYXktZmFuY3ktc3RleGktcGFyYSBzdGV4aSkKICAiRGlzcGxheSBmYW5j eSBAdmFye3N0ZXhpfSBwYXJhZ3JhcGguIgogIChsZXQgbG9vcCAoKHN0ZXhpIHN0ZXhpKSkKICAg IChtYXRjaCBzdGV4aQogICAgICAoKCkgJygpKQogICAgICAoKCgndmFyIChhbmQgKD8gc3RyaW5n Pykgc3RyKSkgLiByZXN0LW9mLWVsZW1lbnRzKQogICAgICAgKGRpc3BsYXktZmFuY3ktc3RyaW5n IHN0cikKICAgICAgIChsb29wIHJlc3Qtb2YtZWxlbWVudHMpKQogICAgICAoKCgnY29kZSAoYW5k ICg/IHN0cmluZz8pIHN0cikpIC4gcmVzdC1vZi1lbGVtZW50cykKICAgICAgIChkaXNwbGF5LWZh bmN5LXN0cmluZyBzdHIpCiAgICAgICAobG9vcCByZXN0LW9mLWVsZW1lbnRzKSkKICAgICAgKCgo c29tZS10YWcgKGFuZCAoPyBzdHJpbmc/KSBzdHIpKSAuIHJlc3Qtb2YtaXRlbXMpCiAgICAgICA7 OyBUT0RPOiBXaGF0IGFib3V0IHRoZSByZXN0IG9mIHRoZW0/CiAgICAgICAoZXJyb3IgIlN0aWxs IHVuc3VwcG9ydGVkIHN0ZXhpIGVsZW1lbnQ6IiBzb21lLXRhZyBzdHIpCiAgICAgICAobG9vcCBy ZXN0LW9mLWl0ZW1zKSkKICAgICAgKCgoYW5kICg/IHN0cmluZz8pIHN0cikgLiByZXN0LW9mLWl0 ZW1zKQogICAgICAgKGRpc3BsYXkgc3RyKQogICAgICAgKGxvb3AgcmVzdC1vZi1pdGVtcykpCiAg ICAgIChfCiAgICAgICAoZXJyb3IgIlVua25vd24gc3RleGkgdmFsdWU6IiBzdGV4aSkpKSkpCgoo ZGVmaW5lIChkaXNwbGF5LWZhbmN5LXN0ZXhpLWZyYWdtZW50IHN0ZXhpKQogIChsZXQgbG9vcCAo KHN0ZXhpIHN0ZXhpKSkKICAgIChtYXRjaCBzdGV4aQogICAgICAoKCkgJygpKQogICAgICAoKCcq ZnJhZ21lbnQqICgncGFyYSAuIGZpcnN0LXBhcmFncmFwaCkgLiByZXN0LW9mLXBhcmFncmFwaHMp CiAgICAgICAoZGlzcGxheS1mYW5jeS1zdGV4aS1wYXJhIGZpcnN0LXBhcmFncmFwaCkKICAgICAg IChsb29wIHJlc3Qtb2YtcGFyYWdyYXBocykpCiAgICAgICgoKCdwYXJhIC4gcGFyYWdyYXBoKSAu IHJlc3Qtb2YtcGFyYWdyYXBocykKICAgICAgIChkaXNwbGF5ICJcblxuIikKICAgICAgIChkaXNw bGF5LWZhbmN5LXN0ZXhpLXBhcmEgcGFyYWdyYXBoKQogICAgICAgKGxvb3AgcmVzdC1vZi1wYXJh Z3JhcGhzKSkKICAgICAgKChlbGVtZW50IC4gcmVzdC1vZi1lbGVtZW50cykKICAgICAgIChlcnJv ciAiVW5rbm93biBzdGV4aSBlbGVtZW50IiBlbGVtZW50KSkpKSkK --000000000000431caa0617342008 Content-Type: text/x-scheme; charset="US-ASCII"; name="mucking-about.scm" Content-Disposition: attachment; filename="mucking-about.scm" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_lvkf50i91 KHVzZS1tb2R1bGUgKGZhbmN5LWRlc2NyaWJlKSkKCihkZWZpbmUgZmluZC1zdGV4aSAodGV4aS1m cmFnbWVudC0+c3RleGkgKG9iamVjdC1kb2N1bWVudGF0aW9uIGZpbmQpKSkKCihwcmV0dHktcHJp bnQgZmluZC1zdGV4aSkKCihkaXNwbGF5LWZhbmN5LXN0ZXhpLWZyYWdtZW50IGZpbmQtc3RleGkp IChuZXdsaW5lKQoKKGRpc3BsYXktZmFuY3ktc3RleGktZnJhZ21lbnQgKHRleGktZnJhZ21lbnQt PnN0ZXhpICJwb29wIikpIChuZXdsaW5lKQoKKGxldCogKCh0ZXh0ICJhYWFhYSBAdmFye2FhYWFh fSBiYmJiYi4KCmNjY2NjIEB2YXJ7bW9vfSBkZGRkZC4KCgpAdmFye0BAbW9vfQoKCmVlZWVlIEBj b2Rle2dhaH0gZmZmZmYuCiIpCiAgICAgICAoc3RleGkgKHRleGktZnJhZ21lbnQtPnN0ZXhpIHRl eHQpKSkKICAocHJldHR5LXByaW50IHN0ZXhpKQogIChkaXNwbGF5LWZhbmN5LXN0ZXhpLWZyYWdt ZW50IHN0ZXhpKSkKCihuZXdsaW5lKQoKKGxldCogKCh0ZXh0ICJAdmFye21vb30KQGNvZGV7Z2Fo fQoiKQogICAgICAgKHN0ZXhpICh0ZXhpLWZyYWdtZW50LT5zdGV4aSB0ZXh0KSkpCiAgKHByZXR0 eS1wcmludCBzdGV4aSkKICAoZGlzcGxheS1mYW5jeS1zdGV4aS1mcmFnbWVudCBzdGV4aSkpCihu ZXdsaW5lKQo= --000000000000431caa0617342008--