From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii 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:46:39 +0200 Message-ID: <86o71lewcw.fsf@gnu.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> <87zfl60wbw.fsf@> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="2813"; mail-complaints-to="usenet@ciao.gmane.io" Cc: jimjoe@gmx.net, emacs-devel@gnu.org To: =?iso-8859-1?Q?Bj=F6rn?= Bidar Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Dec 08 21:47:20 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 1tKOBU-0000Zr-Oz for ged-emacs-devel@m.gmane-mx.org; Sun, 08 Dec 2024 21:47:20 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tKOAu-000210-RP; Sun, 08 Dec 2024 15:46:44 -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 1tKOAt-00020r-7b for emacs-devel@gnu.org; Sun, 08 Dec 2024 15:46:43 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tKOAs-0002Un-A3; Sun, 08 Dec 2024 15:46:42 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=yOB1IWCrdeGQ1jRj1dYT1GwGhnlOyNGQV3B3HzxaLnw=; b=YzVgGGV6bsoCckChkrMi eZ2Jdfn/3JCkjT7tzbBGk8qYHf8nsidC5OHycTjdwOLa9aUDEItYGRPIP3hMXCWsBtM4Cldzm2VEv F2rtaFD3XP2zuvyRFj+dIexmGSPZ0G/V7TTpdESzA89cEZH+TCkZ4Rs0NKySBoQHPqipnwz2pbGVT 5B1d3e9EoMOuBCZKkp4Amr1fldffLgI6O1H3b8rMXujzcBhXPy9YPwp6SBDJECkVx0wMGjuaQYmRD SHwzR7EBYncdmLQ4fQmqI6qppH6foy3zzHy2udovp1ZkovGnzsbBGfawkEuJp1eLXh1ApdXLSY/vn gCvLZtxTHpgPAQ==; In-Reply-To: <87zfl60wbw.fsf@> (message from =?iso-8859-1?Q?Bj=F6rn?= Bidar on Sun, 08 Dec 2024 22:10:59 +0200) 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:326216 Archived-At: > From: Björn Bidar > Cc: James Thomas , emacs-devel@gnu.org > Date: Sun, 08 Dec 2024 22:10:59 +0200 > > 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. This should be taken up with the Texinfo developers. Not sure they will be prepared to do that, but it's their call.