From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?utf-8?Q?Bj=C3=B6rn?= Bidar Newsgroups: gmane.emacs.devel Subject: Re: Integration of Info manuals in programming modes, Re: Integration of Info manuals in programming modes Date: Sun, 08 Dec 2024 22:10:59 +0200 Message-ID: <1691.70616879768$1733688696@news.gmane.org> References: <87ser8c230.fsf@jeremybryant.net> <86jzcj6e4h.fsf@gnu.org> <87y10u6174.fsf@web.de> <87ser8c230.fsf@jeremybryant.net> <86ser87rut.fsf@gnu.org> <87cyicuk25.fsf@melete.silentflame.com> <86jzcj6e4h.fsf@gnu.org> <87y10u6174.fsf@web.de> <86ldwuy3lu.fsf@gnu.org> <877c8ey0iu.fsf@gmail.com> <86ed2mxzj4.fsf@gnu.org> <87y10uwjc6.fsf@gmail.com> <865xnyxtsv.fsf@gnu.org> <87ttbiweqx.fsf@gmail.com> <86a5damj8c.fsf@gnu.org> <87plm6wbg4.fsf@gmail.com> <86ldwuy3lu.fsf@gnu.org> <865xnuvbg9.fsf@gmx.net> <86ttbeflxg.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37660"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: James Thomas , emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Dec 08 21:11:25 2024 Return-path: Envelope-to: ged-emacs-devel@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 1tKNcj-0009YF-NP for ged-emacs-devel@m.gmane-mx.org; Sun, 08 Dec 2024 21:11:25 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tKNcX-0000LL-7Q; Sun, 08 Dec 2024 15:11:13 -0500 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 1tKNcT-0000LC-L0 for emacs-devel@gnu.org; Sun, 08 Dec 2024 15:11:09 -0500 Original-Received: from thaodan.de ([2a03:4000:4f:f15::1]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tKNcR-0006su-UI; Sun, 08 Dec 2024 15:11:09 -0500 Original-Received: from odin (dsl-trebng12-50dc7b-49.dhcp.inet.fi [80.220.123.49]) by thaodan.de (Postfix) with ESMTPSA id 39973D00030; Sun, 8 Dec 2024 22:11:00 +0200 (EET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=thaodan.de; s=mail; t=1733688660; bh=HaJ6VAZKb/XKbu5QMFv9dp3XAxfc0zyRCDKvDub5MJ4=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=cGONhb9MCCri6ig7qtoTf+0TZ/TCQQt7TxY9Bmg4ARCo8ts7q3ok34IhFZ/tt4CPq 60Yl/ldSt6PhPRoC65qOsp7l27jzEXMRyveFvmUYHuLz2UhkwojSxiZy231QCCsnEx rbXuVJsgCPDhx8HbItoEZP1OT7Lmlmmr0Q3UOcTbGySTNUDt+J+OmhcAOdNnqY5ByJ LSicdoZr/Ua19OThMdfkgKpZLiHuIyKerGTabfV5wLgir3dBeQ38ovdwz0QreMoAyt QycW5vGdUrFLwwlWZVTDlRwgBNRpxckYABh10k5PbOnZpH4i6TcHqubi9rGZLqY8nn QTdMc2g1vtwYfG3fwYjPgO2a9rQuHcyNivOqi4Z0nwBAQtO7kMvVLvJqAdCe4WalCl xTaJCAiidNopLEmnMMdSD/VIL3y2v8uR/tTbJEXA23gubQiMksjHe8hEFxipnsWXOb XUqo3rP0EWSnQpimVfRpX0CLWFvywcCwZ+/ZVkTTkkTptG+JlP/R8m/V7eCE2NVw1B 4ACvZNxHa9OHnC5AvsnjYlexJZk3VRV1Rvg1h/yl2HSolGuy2imMkyXQ837RaQtdvf QD+SViVg8Z4VlyjOLbmUGkCbNKtMoaoUvGT60ylOC8JR6Bn/DMNBCVfn0RMwP4HgWD F0VA0cSHKSPBU25v3tqkTD4o= In-Reply-To: <86ttbeflxg.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 08 Dec 2024 13:34:19 +0200") Autocrypt: addr=bjorn.bidar@thaodan.de; prefer-encrypt=nopreference; keydata= mDMEZNfpPhYJKwYBBAHaRw8BAQdACBEmr+0xwIIHZfIDlZmm7sa+lHHSb0g9FZrN6qE6ru60JUJq w7ZybiBCaWRhciA8Ympvcm4uYmlkYXJAdGhhb2Rhbi5kZT6IlgQTFgoAPgIbAwULCQgHAgIiAgYV CgkICwIEFgIDAQIeBwIXgBYhBFHxdut1RzAepymoq1wbdKFlHF9oBQJk1/YmAhkBAAoJEFwbdKFl HF9oB9cBAJoIIGQKXm4cpap+Flxc/EGnYl0123lcEyzuduqvlDT0AQC3OlFKm/OiqJ8IMTrzJRZ8 phFssTkSrrFXnM2jm5PYDoiTBBMWCgA7FiEEUfF263VHMB6nKairXBt0oWUcX2gFAmTX6T4CGwMF CwkIBwICIgIGFQoJCAsCBBYCAwECHgcCF4AACgkQXBt0oWUcX2hbCQEAtru7kvM8hi8zo6z9ux2h K+B5xViKuo7Z8K3IXuK5ugwA+wUfKzomzdBPhfxDsqLcEziGRxoyx0Q3ld9aermBUccHtBxCasO2 cm4gQmlkYXIgPG1lQHRoYW9kYW4uZGU+iJMEExYKADsCGwMFCwkIBwICIgIGFQoJCAsCBBYCAwEC HgcCF4AWIQRR8XbrdUcwHqcpqKtcG3ShZRxfaAUCZNf2FQAKCRBcG3ShZRxfaCzSAP4hZ7cSp0YN XYpcjHdsySh2MuBhhoPeLGXs+2kSiqBiOwD/TP8AgPEg/R+SI9GI9on7fBJJ0mp2IT8kZ2rhDOjg gA6IkwQTFgoAOxYhBFHxdut1RzAepymoq1wbdKFlH Received-SPF: pass client-ip=2a03:4000:4f:f15::1; envelope-from=bjorn.bidar@thaodan.de; helo=thaodan.de X-Spam_score_int: -14 X-Spam_score: -1.5 X-Spam_bar: - X-Spam_report: (-1.5 / 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, INVALID_MSGID=0.568, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:326212 Archived-At: Eli Zaretskii writes: >> From: James Thomas >> Date: Sun, 08 Dec 2024 13:43:58 +0530 >> >> Eli Zaretskii writes: >> >> >> One thing where Info is on-topic here are Emacs integrations. >> >> >> >> I remember how useful it was when I had texinfo links directly >> >> available in Emacs: >> >> https://www.draketo.de/light/english/free-software/read-your-python-module-documentation-emacs >> > >> > Sorry, I don't understand: info-look.el already supports "C-h S" for >> > Python code, assuming you have a Python manual in Info format >> > installed. >> >> Just wanna chime in that this is not perfect, for other reasons: For >> e.g. 'C-h S' on 'print' does not give the index item "* built-in >> function; print" because, as you can see, it's not named appropriately >> in Sphinx's generation. > > Please report that to whoever maintains the Python manual or Sphinx. > info-look.el can fix many problems in the manuals, but not all of > them. That's a good idea. I want to add to context that Sphinx plugins can break the Info output entirely. I think it would be worth from Gnu put resources into improving the Texinfo output in Sphinx as it is so wide used by many projects and thus can provide the most manuals outside the Gnu project right now.