From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: James Thomas 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 14:08:25 +0530 Message-ID: <86wmgatvr2.fsf@gmx.net> References: <87ser8c230.fsf@jeremybryant.net> <87cyicuk25.fsf@melete.silentflame.com> <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> Mime-Version: 1.0 Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="35878"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Dec 08 09:39:15 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 1tKCot-00098r-FQ for ged-emacs-devel@m.gmane-mx.org; Sun, 08 Dec 2024 09:39:15 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tKCoH-0006KP-6F; Sun, 08 Dec 2024 03:38:37 -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 1tKCoE-0006KB-8t for emacs-devel@gnu.org; Sun, 08 Dec 2024 03:38:35 -0500 Original-Received: from mout.gmx.net ([212.227.17.20]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tKCoC-0008Gk-GD for emacs-devel@gnu.org; Sun, 08 Dec 2024 03:38:34 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net; s=s31663417; t=1733647110; x=1734251910; i=jimjoe@gmx.net; bh=4ecrNgOP9dLZu1UigYXM36NIJQzBsSuRcwBnsE7tu04=; h=X-UI-Sender-Class:From:To:Subject:In-Reply-To:References:Date: Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:cc: content-transfer-encoding:content-type:date:from:message-id: mime-version:reply-to:subject:to; b=Za9W9unYRk+qZqu08VZpQZaTz3dGZ+eVbacrXcLUZnnBJEd1I8IAwkWHtStW5sgk dHsjCRETk8n4bjqBGGhjpdGdnzDvbKmwy6gKnymRuvrd1iYQ5nxd+P+3xa0R8jwPf FjEASw1+vGgrRvSyzuLXRDzcRjbe3jyXxbOwsKAMaZgfc/Vlq9qS3CRO9bW1jVGJy GHPQ+0Lenubb1P9s7oXBiwDZS4S3IC3rntdMabzxwKHggJ3VXjfJ6OUtmD6cI2jdL 0hB23RBf4J97j4Jc3x1tg2XjqsmbgsM/LDkKrPi5h20drhXgLSVQc0ap7tQO7usO3 /ln1AAxz4OgpuiStvg== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Original-Received: from user-Inspiron-3493 ([42.108.27.129]) by mail.gmx.net (mrgmx105 [212.227.17.174]) with ESMTPSA (Nemesis) id 1N0XD2-1tWMTZ0svk-00viE3 for ; Sun, 08 Dec 2024 09:38:30 +0100 In-Reply-To: <865xnuvbg9.fsf@gmx.net> (James Thomas's message of "Sun, 08 Dec 2024 13:43:58 +0530") X-Provags-ID: V03:K1:ZSCLBJIw9VUYE/akYQxMsY18JGrfREB77ISp0UpMux++lc9GDyH FuCVaw7dDr2tCGDEAcIsXCyAYB9oEPgjqXoeYNAuybXQuH1y+185shANLUBKIoqGfJNQcWm o1uQUj6/gi4xV2aQJh+iW7F3eASL+WTkB56XcVvc2CqdnnqUOgmjwfEUwAIF5IsUqCTPlN4 V4GhR3slidcfW75/O3hUg== UI-OutboundReport: notjunk:1;M01:P0:9U7CyUA0IFc=;g4QSDq32ycA3XFtabeZ4IXwsDTW dsuSiUC80hUk13jShyR0RfdSHBJQFSlti3DFN+f4YEoDKmR0cXf6/YHup4mXeUnd2ZM6v9R6A yeLM0fQ7OoY8pkkS1ZtwPtwEfo+I5f8Pt9r6jyhNKVI5rBbBub8WHfUpsYlapHNytDSXNifdi qk7h8fxCt2gmlaM7Dwjm88m30fnmMNdQXgZ4gVVI2CW4C5FzMD+A9tyrhWCztkOB/G4R7Rp+p KWs93qGeEQBAW9CuqdPcLhR7ib6Qi3LgBeCa9vSbmQw4BQKbVOOasXcGT87DjockH67lWzHji iJhe5l5hZeStUvcYbWgWFiikO81TCGW/hY4EfRf8WWWuYLpM3hSdH1Zj+pCzMWgQwVEkA+FKe BGth84ZvYQc5u0l73cYkZ3+vDOlmItUfMy+QZ4zZtUqtoCQkQv0QzV9A4EheJzL+oM+8YVNSU GFpMaQ6YY4MPfJBUFW1zfPhtvwzpxoLjBKBc0HC8p/N8QtEbinFU9y4EwvLCpxxNHLHXbDd65 znMkMRDYmDkceFgTDlzCvalnVuA8dZcrHFZmLHjWfuNXdIZY63tMlJfJ0nlg7C+koK7F34nib Fn6q0AytqbmitM/uNjkFbw6/RcwhXCBSNbQBsJGPXzI6P3ZRLxFfOid7njOT6HRScW/O/2Kmx GHi6zPq3Ldgo/ES8itXIOWuI198f8etpa8S4fZ8hTl1MLKy6sJApbBwLRPbMglbGzF+1+hTaQ nQVhUKlwxstqMdRWAHN9xCY/zaXdo8aa4SQyogoMQ3uTBCZrGpV5kps4IoWH1LObMUD+mA3d Received-SPF: pass client-ip=212.227.17.20; envelope-from=jimjoe@gmx.net; helo=mout.gmx.net 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham 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:326185 Archived-At: James Thomas writes: > 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-mo= dule-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. > >> What other GNU programming packages which have Info manuals and >> suitable Emacs major modes are not supported by info-look.el? > > Speaking about python, many libraries (such as PyTorch & NumPy) use > Sphinx, but the info generation has bug when it uses 'numpydoc' that > requires a little manual fixing of the .texi. And a PSA for anyone who wants to use these: Set 'Info-hide-note-references' to 'hide' to get rid of the "see" before every link. =2D-