From unknown Mon Jun 23 02:26:14 2025 X-Loop: help-debbugs@gnu.org Subject: bug#46082: (texinfo) @ref says something lisp/info.el do not respect by default Resent-From: Marco Munari Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 24 Jan 2021 18:31:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 46082 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 46082@debbugs.gnu.org Cc: "Kim F. Storm" X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.16115130144681 (code B ref -1); Sun, 24 Jan 2021 18:31:02 +0000 Received: (at submit) by debbugs.gnu.org; 24 Jan 2021 18:30:14 +0000 Received: from localhost ([127.0.0.1]:37226 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1l3k9N-0001DN-DE for submit@debbugs.gnu.org; Sun, 24 Jan 2021 13:30:14 -0500 Received: from lists.gnu.org ([209.51.188.17]:43256) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1l3iED-0002Mn-3V for submit@debbugs.gnu.org; Sun, 24 Jan 2021 11:27:05 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:33224) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1l3iEC-0006RA-SG for bug-gnu-emacs@gnu.org; Sun, 24 Jan 2021 11:27:04 -0500 Received: from fastcode.eu ([45.79.166.47]:27895 helo=nj1.fastcode.eu) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1l3iE9-0003Ml-Ay for bug-gnu-emacs@gnu.org; Sun, 24 Jan 2021 11:27:03 -0500 Received: from nb (127.10.132.1 [127.10.132.1]) by nj1.fastcode.eu (OpenSMTPD) with ESMTP id e7e34204; Sun, 24 Jan 2021 11:26:31 -0500 (EST) From: Marco Munari Face: iVBORw0KGgoAAAANSUhEUgAAABAAAAAOBAMAAADUAYG5AAAAMFBMVEVmLnCAgn+EhoOIioeNj4yRk5CYmpefoZ6jpaKpq6ivsa62uLS6vLnBw8DJy8h7fXrqFMmXAAAAAXRSTlMAQObYZgAAAAFiS0dEAIgFHUgAAABsSURBVAjXY2BgYODsZICAGeUQmntaAYRxOwxC8x4xgDDuOPHuaGBLZeC71nU7LKJiJsO7jvAlRuZlDQx3SyKVVMVLgWq3TZafVCTAwMCzK/DDSnmgpjPL7TkbPwAZd6c7lBuBjDnbytASAKQBe1ofD2Lqno4AAAAASUVORK5CYII= Date: Sun, 24 Jan 2021 17:26:57 +0100 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=45.79.166.47; envelope-from=mar21+dev.emacs.bugfix@allerta.it; helo=nj1.fastcode.eu X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Mailman-Approved-At: Sun, 24 Jan 2021 13:30:12 -0500 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 (--) --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi Kim, I'm writing in relation to defcustom Info-hide-note-references t in lisp= /info.el a9efebd0ba1 (Kim 2002-11-01 306) (defcustom Info-hide-note-references t because it's a bad default to proper info documentation as said in (texinfo) @ref documentation https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040ref.html ,-----------------------------------------------------------------------= ---- | 6.6 @ref | @ref is nearly the same as @xref except that it does not generate a = =E2=80=98See=E2=80=99 | in the printed output, just the reference itself. | This makes it useful as the last part of a sentence. | | For example, |=20 | For more information, @pxref{This}, and @ref{That}. | produces in Info: |=20 (*)| For more information, *note This::, and *note That::. | and in printed output: |=20 | For more information, see Section 1.1 [This], page 1, and Section 1.2 = [That], page 2. `-----------------------------------------------------------------------= ---- but with current info.el default in emacs shows (*)| For more information, see [This]., and see [That]. ( A part that with only two examples (texinfo) @ref it's not very clear that there are three cases: @ref @xref @pxref ) As I intended it, the second "see" should absolutely not be present, Info-hide-note-references is already customize-able to nil(=3Dcompliant) or hide(my preference), but the current default of t is(seem to me) not at all as designed in texinfo, for example python info documentation was plenty of misplaced ``See`` ... ``.`` (which is the reason I looked into the origin of the problem) and found it: @ref should have not a processing for info that add "See" as should while processing @xref, than the pxref is to distinguish printed rendering. I will not insist over this trivial change, if ever you disagree you can also ignore the request Cheers, Marco Munari --=20 x(t),y(t) =3D th(3t-34.5)*e^[-(3t-34.5)^2]/2-4.3+e^(-1.8/t^2)/(.8*atg(t- 3)+2)(t-1.8)-.3th(5t-42.5),(1.4e^[-(3t-34.5)^2]+1-sgn[|t-8.5|-.5]*1.5* |sin(pi*t)|^[2e^(-(t-11.5)^2)+.5+e^(-(.6t-3.3)^2)])/(.5+t)+1 ; 0 Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 27 Jan 2021 02:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 46082 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Marco Munari Cc: 46082@debbugs.gnu.org, "Kim F. Storm" Received: via spool by 46082-submit@debbugs.gnu.org id=B46082.161171622628160 (code B ref 46082); Wed, 27 Jan 2021 02:58:02 +0000 Received: (at 46082) by debbugs.gnu.org; 27 Jan 2021 02:57:06 +0000 Received: from localhost ([127.0.0.1]:43186 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1l4b10-0007K7-3H for submit@debbugs.gnu.org; Tue, 26 Jan 2021 21:57:06 -0500 Received: from quimby.gnus.org ([95.216.78.240]:35190) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1l4b0y-0007JX-6R for 46082@debbugs.gnu.org; Tue, 26 Jan 2021 21:57:04 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=g0ZrFuZ/NwhNbtldVRAluFD1Ap8X1QLoDKpnCaVacxs=; b=prPLuW/FgAZKpNiVjbB1ETbeW4 xt5DT7F4sVv1fhYNXyILM1whwBwlvBN7JV5narH127eWsBuTRdewN5+WCP14Lkq03vuMG/O+uRQrS LY6N6829lJUz3HFpzOsaKFcZzPT8lTEwmYUEcSLP5K3XdFzd+GN5tzhog+t9yQ4bEq4I=; Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1l4b0o-0008JK-3E; Wed, 27 Jan 2021 03:56:57 +0100 From: Lars Ingebrigtsen References: X-Now-Playing: Thompson Twins's _To The Outside Of Everything: A Story of UK Post Punk 1977-1981 (3)_: "Squares And Triangles" Date: Wed, 27 Jan 2021 03:56:52 +0100 In-Reply-To: (Marco Munari's message of "Sun, 24 Jan 2021 17:26:57 +0100") Message-ID: <87im7jdr4b.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Marco Munari writes: > for example python info documentation was plenty of misplaced > ``See`` ... ``.`` (which is the reason I looked into the origin of the > problem) and found it: @ref should have not a processing for [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) 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 (-) Marco Munari writes: > for example python info documentation was plenty of misplaced > ``See`` ... ``.`` (which is the reason I looked into the origin of the > problem) and found it: @ref should have not a processing for info that > add "See" as should while processing @xref, than the pxref is to > distinguish printed rendering. Do you have an example of how Emacs displays this Python documentation? -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Tue Jan 26 21:57:10 2021 Received: (at control) by debbugs.gnu.org; 27 Jan 2021 02:57:10 +0000 Received: from localhost ([127.0.0.1]:43189 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1l4b14-0007KP-C7 for submit@debbugs.gnu.org; Tue, 26 Jan 2021 21:57:10 -0500 Received: from quimby.gnus.org ([95.216.78.240]:35206) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1l4b12-0007Jx-Vx for control@debbugs.gnu.org; Tue, 26 Jan 2021 21:57:09 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=lL5z2C7wFW89Ji898UAfTgaU8nUN5NS5+WkA9OUAKts=; b=q409tfgAbohNObq7TMXxboDM6e kTLcdHja0CZhDhGtOcFlWd4XW8tTD8YzIF6TB5NBYmpwa/R/IelIAOiq5yjwgV5SHi78tv8/26z3G jAKJMjBco6zoopuhresgzjNudcPTQKInLS6+bEcEa0d32dB+irWIrEXFoaIROmVu28io=; Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1l4b0v-0008JT-Bs for control@debbugs.gnu.org; Wed, 27 Jan 2021 03:57:03 +0100 Date: Wed, 27 Jan 2021 03:57:00 +0100 Message-Id: <87h7n3dr43.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #46082 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 46082 + moreinfo quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control 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 (-) tags 46082 + moreinfo quit From unknown Mon Jun 23 02:26:14 2025 X-Loop: help-debbugs@gnu.org Subject: bug#46082: (texinfo) @ref says something lisp/info.el do not respect by default Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 01 Mar 2021 15:21:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 46082 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: moreinfo To: Marco Munari Cc: 46082@debbugs.gnu.org, "Kim F. Storm" Received: via spool by 46082-submit@debbugs.gnu.org id=B46082.161461205018046 (code B ref 46082); Mon, 01 Mar 2021 15:21:01 +0000 Received: (at 46082) by debbugs.gnu.org; 1 Mar 2021 15:20:50 +0000 Received: from localhost ([127.0.0.1]:50397 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGkLq-0004gz-AT for submit@debbugs.gnu.org; Mon, 01 Mar 2021 10:20:50 -0500 Received: from quimby.gnus.org ([95.216.78.240]:43990) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGkLo-0004gk-SJ for 46082@debbugs.gnu.org; Mon, 01 Mar 2021 10:20:49 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=pKWGK+3SSQZBgu2929ji9a5jw8XYfbvRBw5VFBrJX+8=; b=FWsgpQq37WLu/EO/VJhSBoenlt OwqmToUVGXzYWtDO0jog5g7D4CdvjuSS66Jk8fCcSA+yZDDTV0fbdB6sRvgYoqphQ6zC9WXTmwiO5 ydXxBe+vXuaFvSDSeCoXiblmwEHyFarmX0kHhLlOaHgocjFWc+46Yb4VgIn1fs0mv9Fc=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lGkLf-00035N-Tu; Mon, 01 Mar 2021 16:20:42 +0100 From: Lars Ingebrigtsen References: <87im7jdr4b.fsf@gnus.org> X-Now-Playing: Stephen Mallinder's _Um Dada_: "Satellite" Date: Mon, 01 Mar 2021 16:20:38 +0100 In-Reply-To: <87im7jdr4b.fsf@gnus.org> (Lars Ingebrigtsen's message of "Wed, 27 Jan 2021 03:56:52 +0100") Message-ID: <87ft1e6gu1.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Lars Ingebrigtsen writes: > Marco Munari writes: > >> for example python info documentation was plenty of misplaced >> ``See`` ... ``.`` (which is the reason I looked into the origin of the [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) 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 (-) Lars Ingebrigtsen writes: > Marco Munari writes: > >> for example python info documentation was plenty of misplaced >> ``See`` ... ``.`` (which is the reason I looked into the origin of the >> problem) and found it: @ref should have not a processing for info that >> add "See" as should while processing @xref, than the pxref is to >> distinguish printed rendering. > > Do you have an example of how Emacs displays this Python documentation? More information was requested, but no response was given within a month, so I'm closing this bug report. If the problem still exists, please respond to this email and we'll reopen the bug report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Mon Mar 01 10:20:55 2021 Received: (at control) by debbugs.gnu.org; 1 Mar 2021 15:20:55 +0000 Received: from localhost ([127.0.0.1]:50400 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGkLv-0004hJ-I1 for submit@debbugs.gnu.org; Mon, 01 Mar 2021 10:20:55 -0500 Received: from quimby.gnus.org ([95.216.78.240]:44004) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGkLt-0004gr-Ma for control@debbugs.gnu.org; Mon, 01 Mar 2021 10:20:53 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=WC2HiM+C6OkE4GSUGOPzdw+m/GywY5pEsFuc03tDqtY=; b=ZrH1xqHGnOy0beh1y+XlLC6Rnc y8K0WyvWLMsAT3qScesrnDRgK0nWvR3hFFQGFhMbLfkB0tmtiGNYn1xnRXmxmYvTISE2kjtAYUgb6 xP6zyrfoot9QHCTHKjka9sKLwkr3J3lOmSP7SqElsaix/VaG74QXsH9bYFo3N7SMJUys=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lGkLm-00035U-1f for control@debbugs.gnu.org; Mon, 01 Mar 2021 16:20:48 +0100 Date: Mon, 01 Mar 2021 16:20:44 +0100 Message-Id: <87eegy6gtv.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #46082 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: close 46082 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control 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 (-) close 46082 quit From unknown Mon Jun 23 02:26:14 2025 X-Loop: help-debbugs@gnu.org Subject: bug#46082: acknowledged by developer (control message for bug #46082) In-Reply-To: Resent-From: Marco Munari Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 01 Mar 2021 19:52:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 46082 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: moreinfo To: 46082@debbugs.gnu.org Received: via spool by 46082-submit@debbugs.gnu.org id=B46082.161462831911415 (code B ref 46082); Mon, 01 Mar 2021 19:52:01 +0000 Received: (at 46082) by debbugs.gnu.org; 1 Mar 2021 19:51:59 +0000 Received: from localhost ([127.0.0.1]:50887 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGoaE-0002y2-3K for submit@debbugs.gnu.org; Mon, 01 Mar 2021 14:51:59 -0500 Received: from fastcode.eu ([45.79.166.47]:3372 helo=nj1.fastcode.eu) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGo8M-0002Ex-2i for 46082@debbugs.gnu.org; Mon, 01 Mar 2021 14:23:11 -0500 Received: from nb (127.10.132.1 [127.10.132.1]) by nj1.fastcode.eu (OpenSMTPD) with ESMTP id f188eca8 for <46082@debbugs.gnu.org>; Mon, 1 Mar 2021 14:22:34 -0500 (EST) From: Marco Munari References: <87eegy6gtv.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Face: iVBORw0KGgoAAAANSUhEUgAAABAAAAAOBAMAAADUAYG5AAAAMFBMVEVmLnCAgn+EhoOIioeNj4yRk5CYmpefoZ6jpaKpq6ivsa62uLS6vLnBw8DJy8h7fXrqFMmXAAAAAXRSTlMAQObYZgAAAAFiS0dEAIgFHUgAAABsSURBVAjXY2BgYODsZICAGeUQmntaAYRxOwxC8x4xgDDuOPHuaGBLZeC71nU7LKJiJsO7jvAlRuZlDQx3SyKVVMVLgWq3TZafVCTAwMCzK/DDSnmgpjPL7TkbPwAZd6c7lBuBjDnbytASAKQBe1ofD2Lqno4AAAAASUVORK5CYII= Date: Mon, 01 Mar 2021 20:22:58 +0100 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Mailman-Approved-At: Mon, 01 Mar 2021 14:51:56 -0500 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 (-) I noticed only the bug close notification now, the mention of python info example was secondary, the rendering difform to specification emerges precisely with (texinfo) manual itself Repro steps: 1. launch emacs info C-h i 2. go to node g (texinfo)@ref read the rendered manual page with attention (I described at the beginning of the initial bug report the problem in the line marked with (*)) python and even perl info manuals uses a lot of @ref (according to the way texinfo does and describe its functionality) resulting a lot of inappropriate See making the references surrounded by nonsense "see ... dot(.)", but the problem emerges in the exact page of texinfo describing how @ref should work, showing that it doesnt. Anyway as required an example on how python manual looks, here there is a random section (Note the "see" are simply misleading. My fix removes the default misbehaviour for "see", but the dot(.) after the node description remains): =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D File: python.info, Node: Expression input, Prev: Interactive input, Up: = Top-level components 4.9.4 Expression input ---------------------- *note eval(). is used for expression input. It ignores leading whitespace. The string argument to *note eval(). must have the following form: eval_input ::=3D expression_list NEWLINE* =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D And here is an extract of `perlfunc` info manual: =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D File: perlfunc.info, Node: Top, Up: (dir) 1 NAME ****** perlfunc - Perl builtin functions 2 DESCRIPTION ************* ... 2.1 Perl Functions by Category =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D Here are Perl=E2=80=99s functions (including things that look like function= s, like some keywords and named operators) arranged by category. Some functions appear in more than one place. Any warnings, including those produced by keywords, are described in *note (perldiag):: and *note (warnings)::. Functions for SCALARs or strings *note =E2=80=98chomp=E2=80=99, *note =E2=80=98chop=E2=80=99, *note =E2=80=98chr=E2=80=99, *note =E2=80=98crypt=E2=80=99 *note =E2=80=98fc= =E2=80=99, *note =E2=80=98hex=E2=80=99, *note =E2=80=98index=E2=80=99, *note =E2=80=98lc=E2=80=99, *note =E2=80=98lcfirst=E2=80=99, *note =E2= =80=98length=E2=80=99, *note =E2=80=98oct=E2=80=99, *note =E2=80=98ord=E2=80=99, *note =E2=80=98pack=E2=80=99, *note =E2=80=98q/= /=E2=80=99, *note =E2=80=98qq//=E2=80=99, *note =E2=80=98reverse=E2=80=99, *note =E2=80=98rindex=E2=80=99, *note =E2=80=98sprintf=E2=80=99, *note= =E2=80=98substr=E2=80=99, *note =E2=80=98tr///=E2=80=99, *note =E2=80=98uc=E2=80=99, *note =E2=80=98ucfirst=E2=80=99, *note =E2= =80=98y///=E2=80=99. *note =E2=80=98fc=E2=80=99: fc EXPR. is available only if the *note = =E2=80=98"fc"=E2=80=99 feature: (feature)The 'fc' feature. is enabled or if it is prefixed with =E2=80=98CORE::=E2=80=99. The *note =E2=80=98"fc"=E2=80=99 feature: (= feature)The 'fc' feature. is enabled automatically with a =E2=80=98use v5.16=E2=80=99 (or higher) d= eclaration in the current scope. Regular expressions and pattern matching *note =E2=80=98m//=E2=80=99: m//, *note =E2=80=98pos=E2=80=99: pos SCA= LAR, *note =E2=80=98qr//=E2=80=99: qr/STRING/, *note =E2=80=98quotemeta=E2=80=99: quotemeta EXPR, *note = =E2=80=98s///=E2=80=99: s///, *note =E2=80=98split=E2=80=99: split /PATTERN/,EXPR,LIMIT, *note =E2= =80=98study=E2=80=99: study SCALAR. ... break Break out of a =E2=80=98given=E2=80=99 block. *note =E2=80=98break=E2=80=99. is available only if the *note =E2=80= =98"switch"=E2=80=99 feature(feature). is enabled or if it is prefixed with =E2=80=98CORE::=E2=80=99. The *note =E2=80=98"switch"= =E2=80=99 feature(feature). . is enabled automatically with a =E2=80=98use v5.10=E2=80=99 (or higher) declaration in the current scope. ... =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D From unknown Mon Jun 23 02:26:14 2025 X-Loop: help-debbugs@gnu.org Subject: bug#46082: acknowledged by developer (control message for bug #46082) Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 01 Mar 2021 20:11:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 46082 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: moreinfo To: Marco Munari Cc: 46082@debbugs.gnu.org Received: via spool by 46082-submit@debbugs.gnu.org id=B46082.161462941813361 (code B ref 46082); Mon, 01 Mar 2021 20:11:01 +0000 Received: (at 46082) by debbugs.gnu.org; 1 Mar 2021 20:10:18 +0000 Received: from localhost ([127.0.0.1]:50941 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGory-0003TR-9E for submit@debbugs.gnu.org; Mon, 01 Mar 2021 15:10:18 -0500 Received: from eggs.gnu.org ([209.51.188.92]:38196) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGorx-0003T8-7X for 46082@debbugs.gnu.org; Mon, 01 Mar 2021 15:10:17 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:53108) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lGorp-0001Ss-Pj; Mon, 01 Mar 2021 15:10:09 -0500 Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:2208 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lGorn-0002Ul-BY; Mon, 01 Mar 2021 15:10:08 -0500 Date: Mon, 01 Mar 2021 22:10:03 +0200 Message-Id: <83pn0i7i04.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: (message from Marco Munari on Mon, 01 Mar 2021 20:22:58 +0100) References: <87eegy6gtv.fsf@gnus.org> X-Spam-Score: -0.7 (/) 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 (-) > From: Marco Munari > Date: Mon, 01 Mar 2021 20:22:58 +0100 > > read the rendered manual page with attention > (I described at the beginning of the initial bug report > the problem in the line marked with (*)) > > python and even perl info manuals uses a lot of @ref (according > to the way texinfo does and describe its functionality) > resulting a lot of inappropriate See making the references surrounded > by nonsense "see ... dot(.)", but the problem emerges in the exact page > of texinfo describing how @ref should work, showing that it doesnt. > > Anyway as required an example on how python manual looks, > here there is a random section (Note the "see" are simply misleading. > My fix removes the default misbehaviour for "see", > but the dot(.) after the node description remains): I have difficulty understanding the problem, and thus the proposed solution. I think the difficulty stems from the fact that you didn't show the Texinfo source of the Info output which you posted. Without that, it's hard to decide whether the problem is with Emacs, or with Texinfo's 'makeinfo', or with the original Texinfo source as authored by whoever wrote those manuals (which are not Emacs manuals). So please show the Texinfo sources of these snippets. Thanks. From unknown Mon Jun 23 02:26:14 2025 X-Loop: help-debbugs@gnu.org Subject: bug#46082: acknowledged by developer (control message for bug #46082) In-Reply-To: Resent-From: Marco Munari Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 08 Mar 2021 07:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 46082 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: moreinfo To: Eli Zaretskii Cc: 46082@debbugs.gnu.org Received: via spool by 46082-submit@debbugs.gnu.org id=B46082.161518946530011 (code B ref 46082); Mon, 08 Mar 2021 07:45:01 +0000 Received: (at 46082) by debbugs.gnu.org; 8 Mar 2021 07:44:25 +0000 Received: from localhost ([127.0.0.1]:41992 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lJAYw-0007nv-EB for submit@debbugs.gnu.org; Mon, 08 Mar 2021 02:44:25 -0500 Received: from fastcode.eu ([45.79.166.47]:49120 helo=nj1.fastcode.eu) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lJ9WS-0006AB-Vy for 46082@debbugs.gnu.org; Mon, 08 Mar 2021 01:37:45 -0500 Received: from nb (127.10.132.1 [127.10.132.1]) by nj1.fastcode.eu (OpenSMTPD) with ESMTP id bd8aba1f; Mon, 8 Mar 2021 01:37:11 -0500 (EST) From: Marco Munari References: <87eegy6gtv.fsf@gnus.org> <83pn0i7i04.fsf@gnu.org> Face: iVBORw0KGgoAAAANSUhEUgAAABAAAAAOBAMAAADUAYG5AAAAMFBMVEVmLnCAgn+EhoOIioeNj4yRk5CYmpefoZ6jpaKpq6ivsa62uLS6vLnBw8DJy8h7fXrqFMmXAAAAAXRSTlMAQObYZgAAAAFiS0dEAIgFHUgAAABsSURBVAjXY2BgYODsZICAGeUQmntaAYRxOwxC8x4xgDDuOPHuaGBLZeC71nU7LKJiJsO7jvAlRuZlDQx3SyKVVMVLgWq3TZafVCTAwMCzK/DDSnmgpjPL7TkbPwAZd6c7lBuBjDnbytASAKQBe1ofD2Lqno4AAAAASUVORK5CYII= Date: Mon, 08 Mar 2021 07:37:33 +0100 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.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-Mailman-Approved-At: Mon, 08 Mar 2021 02:44:20 -0500 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 (-) On Mon, 01 Mar 2021 22:10:03 +0200, Eli Zaretskii said: >>From: Marco Munari >>Date: Mon, 01 Mar 2021 20:22:58 +0100 >> >>read the rendered manual page with attention >>(I described at the beginning of the initial bug report >>the problem in the line marked with (*)) >> >>python and even perl info manuals uses a lot of @ref (according >>to the way texinfo does and describe its functionality) >>resulting a lot of inappropriate See making the references surrounded >>by nonsense "see ... dot(.)", but the problem emerges in the exact page >>of texinfo describing how @ref should work, showing that it doesnt. >> >>Anyway as required an example on how python manual looks, >>here there is a random section (Note the "see" are simply misleading. >>My fix removes the default misbehaviour for "see", >>but the dot(.) after the node description remains): >I have difficulty understanding the problem, and thus the proposed >solution. I think the difficulty stems from the fact that you didn't >show the Texinfo source of the Info output which you posted. Without >that, it's hard to decide whether the problem is with Emacs, or with >Texinfo's 'makeinfo', or with the original Texinfo source as authored >by whoever wrote those manuals (which are not Emacs manuals). >So please show the Texinfo sources of these snippets. >Thanks. I noticed that when I copy and yank from an info buffer to gnus it keept showing what the info buffers shown, but it didn't remain the same on sending the email, so I didn't send previously the intended info rendering (which renders worse than what I sent out). Instead of "*note" (sent in the previous email) info shows "see" and adds a dot So for example (python)Expression input is rendered with info.el in user reading phase as: | See eval(). is used for expression input. It ignores leading | whitespace. The string argument to see eval(). must have the | following form: from the python.info source | *note eval(): ca8. is used for expression input. It ignores leading | whitespace. The string argument to *note eval(): ca8. must have the | following form: which is from the texi input from texinfo | @ref{ca8,,eval()} is used for expression input. It ignores leading white= space. The | string argument to @ref{ca8,,eval()} must have the following form: produced in cpython git source with the command sphinx-build -b texinfo -d build/doctrees . build/texinfo more details in https://www.emacswiki.org/emacs/ExternalDocumentation to see the source of texinfo add two repro steps (3 and 4) 1. info C-h i 2. got to node g (texinfo)@ref (now with the cursor in the buffer rendered by info of texinfo CWD is good) 3. open file from CWD C-x f 4. the texinfo source textinfo.info-1.gz (use tab, I had it here in (arch)linux) 5. search a piece C-s is nearly the same as and there are other source chunks for example, repored after my signature Cheers, MARco --=20 x(t),y(t) =3D th(3t-34.5)*e^[-(3t-34.5)^2]/2-4.3+e^(-1.8/t^2)/(.8*atg(t- 3)+2)(t-1.8)-.3th(5t-42.5),(1.4e^[-(3t-34.5)^2]+1-sgn[|t-8.5|-.5]*1.5* |sin(pi*t)|^[2e^(-(t-11.5)^2)+.5+e^(-(.6t-3.3)^2)])/(.5+t)+1 ; 0 Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 11 Mar 2021 14:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 46082 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: moreinfo To: Marco Munari Cc: 46082@debbugs.gnu.org Received: via spool by 46082-submit@debbugs.gnu.org id=B46082.161547280325743 (code B ref 46082); Thu, 11 Mar 2021 14:27:02 +0000 Received: (at 46082) by debbugs.gnu.org; 11 Mar 2021 14:26:43 +0000 Received: from localhost ([127.0.0.1]:52896 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lKMGw-0006h2-HX for submit@debbugs.gnu.org; Thu, 11 Mar 2021 09:26:43 -0500 Received: from eggs.gnu.org ([209.51.188.92]:45748) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lKMGu-0006gl-K4; Thu, 11 Mar 2021 09:26:41 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:40282) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lKMGn-0006V1-C0; Thu, 11 Mar 2021 09:26:33 -0500 Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:4941 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lKMGk-0008G8-S8; Thu, 11 Mar 2021 09:26:31 -0500 Date: Thu, 11 Mar 2021 16:26:30 +0200 Message-Id: <83k0qdn4vd.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: (message from Marco Munari on Mon, 08 Mar 2021 07:37:33 +0100) References: <87eegy6gtv.fsf@gnus.org> <83pn0i7i04.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -0.7 (/) 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 (-) tags 46082 notabug thanks > From: Marco Munari > Cc: 46082@debbugs.gnu.org > Date: Mon, 08 Mar 2021 07:37:33 +0100 > > I noticed that when I copy and yank from an info buffer to gnus > it keept showing what the info buffers shown, but it didn't remain > the same on sending the email, so I didn't send previously the intended > info rendering (which renders worse than what I sent out). > Instead of "*note" (sent in the previous email) info shows "see" and adds > a dot > > So for example (python)Expression input is rendered with info.el > in user reading phase as: > | See eval(). is used for expression input. It ignores leading > | whitespace. The string argument to see eval(). must have the > | following form: > > from the python.info source > > | *note eval(): ca8. is used for expression input. It ignores leading > | whitespace. The string argument to *note eval(): ca8. must have the > | following form: That's normal: info.el hides some of the text of the buffer or even displays replacement text instead of some of the text in the buffer, but when you copy/paste the text into another buffer, the hidden text and the replacements are undone, and you see what is actually in buffer text. > which is from the texi input from texinfo > > | @ref{ca8,,eval()} is used for expression input. It ignores leading whitespace. The > | string argument to @ref{ca8,,eval()} must have the following form: Btw, these two instances of @ref are invalid use of @ref, as I explain below. And that incorrect use of @ref is actually at the heart of the problem which bothers you. IOW, it isn't an Emacs problem, it's a problem with how the original Texinfo was written (or produced from some other markup, if that's its prodigy). More details below. > which is output of makeinfo from somehow the following (but the info > says discursively that @ref should not gegerate a 'see', and the > makeinfo output has @ref (right as intended), emacs info.el show a "see") > (I don't see in this case necesseray the following deeper texinfo source > describing ref from git.savannah.gnu.org/git/texinfo.git file doc/texinfo.texi): This is a partial misunderstanding. The "see" which the Texinfo manual says isn't generated is not the one you see in Emacs in Info mode. What the Texinfo manual alludes to is this: when you use @xref or @pxref in Texinfo, they produce "see *note REFERENCE" (@xref produces a capitalized "See" instead). By contrast, @ref produces just *note REFERENCE". That is the "see" which Texinfo alludes to when it says that @ref doesn't produce it. The "see" which you see in the Info buffers in Emacs is the replacement for "*note". So it's a different kind of "see". > Then the following correct use of @ref > > ============================================================================== > @node perlfunc Perl Functions by Category > @section Perl Functions by Category > @cindex function > > Here are Perl's functions (including things that look like > functions, like some keywords and named operators) > arranged by category. Some functions appear in more > than one place. Any warnings, including those produced by > keywords, are described in @ref{perldiag NAME} and @ref{,,, warnings}. > > @table @asis > @item Functions for SCALARs or strings > @anchor{perlfunc Functions for SCALARs or strings} > @cindex scalar > @cindex string > @cindex character > > @ref{perlfunc chomp VARIABLE, @code{chomp}, @code{chomp}}, @ref{perlfunc chop VARIABLE, @code{chop}, @code{chop}}, > @ref{perlfunc chr NUMBER, @code{chr}, @code{chr}}, @ref{perlfunc crypt PLAINTEXT@comma{}SALT, @code{crypt}, @code{crypt}}, > @ref{perlfunc fc EXPR, @code{fc}, @code{fc}}, @ref{perlfunc hex EXPR, @code{hex}, @code{hex}}, That isn't a correct use of @ref. @ref was never meant to be used like an HTML " produces with `makeinfo` the .info: > ... > | Functions for SCALARs or strings > | > | *note ‘chomp’: chomp VARIABLE, *note ‘chop’: chop VARIABLE, *note > | ‘chr’: chr NUMBER, *note ‘crypt’: crypt PLAINTEXT,SALT, *note ‘fc’: > | fc EXPR, *note ‘hex’: hex EXPR, *note ‘index’: index > | STR,SUBSTR,POSITION, *note ‘lc’: lc EXPR, *note ‘lcfirst’: lcfirst > | EXPR, *note ‘length’: length EXPR, *note ‘oct’: oct EXPR, *note > | ‘ord’: ord EXPR, *note ‘pack’: pack TEMPLATE,LIST, *note ‘q//’: > | q/STRING/, *note ‘qq//’: qq/STRING/, *note ‘reverse’: reverse LIST, > | *note ‘rindex’: rindex STR,SUBSTR,POSITION, *note ‘sprintf’: > | sprintf FORMAT, LIST, *note ‘substr’: substr > | EXPR,OFFSET,LENGTH,REPLACEMENT, *note ‘tr///’: tr///, *note ‘uc’: > | uc EXPR, *note ‘ucfirst’: ucfirst EXPR, *note ‘y///’: y///. > | > | *note ‘fc’: fc EXPR. is available only if the *note ‘"fc"’ feature: > | (feature)The 'fc' feature. is enabled or if it is prefixed with > | ‘CORE::’. The *note ‘"fc"’ feature: (feature)The 'fc' feature. is > | enabled automatically with a ‘use v5.16’ (or higher) declaration in > | the current scope. > > > which end up by default (before my change) being rendered in emacs as: > > | Here are Perl’s functions (including things that look like functions, > | like some keywords and named operators) arranged by category. Some > | functions appear in more than one place. Any warnings, including those > | produced by keywords, are described in see (perldiag) and see > | (warnings). > | > | Functions for SCALARs or strings > | > | See ‘chomp’ see ‘chop’ see > | ‘chr’ see ‘crypt’ see ‘fc’ > | see ‘hex’, see ‘index’ > | SUBSTR,POSIT, see ‘lc’ see ‘lcfirst’ > | see ‘length’ see ‘oct’ see > | ‘ord’, see ‘pack’ see ‘q//’ > | see ‘qq//’ see ‘reverse’ > | see ‘rindex’ see ‘sprintf’ > | see ‘substr’ > | OFFSET,LENGTH,REPLACEMENT, see ‘tr///’ see ‘uc’ > | see ‘ucfirst’ see ‘y///’. > | > | See ‘fc’. is available only if the see ‘"fc"’ feature > | (feature). is enabled or if it is prefixed with > | ‘CORE::’. The see ‘"fc"’ feature(feature). is > | enabled automatically with a ‘use v5.16’ (or higher) declaration in > | the current scope. That's expected. The problem is that whoever wrote that Texinfo expected to see just the names of the functions, displayed in a typeface suitable for hyperlinks. But that's not how @ref works. This is not a bug, not an Emacs bug, anyway. From unknown Mon Jun 23 02:26:14 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Marco Munari Subject: bug#46082: closed (Re: bug#46082: (texinfo) @ref says something lisp/info.el do not respect by default) Message-ID: References: X-Gnu-PR-Message: they-closed 46082 X-Gnu-PR-Package: emacs X-Gnu-PR-Keywords: notabug moreinfo Reply-To: 46082@debbugs.gnu.org Date: Fri, 09 Apr 2021 17:00:04 +0000 Content-Type: multipart/mixed; boundary="----------=_1617987604-5777-1" This is a multi-part message in MIME format... ------------=_1617987604-5777-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #46082: (texinfo) @ref says something lisp/info.el do not respect by de= fault which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 46082@debbugs.gnu.org. --=20 46082: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D46082 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1617987604-5777-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 46082-done) by debbugs.gnu.org; 9 Apr 2021 16:59:43 +0000 Received: from localhost ([127.0.0.1]:50780 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lUuTv-0001T7-BP for submit@debbugs.gnu.org; Fri, 09 Apr 2021 12:59:43 -0400 Received: from mail-pf1-f174.google.com ([209.85.210.174]:42818) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lUuTu-0001Su-68 for 46082-done@debbugs.gnu.org; Fri, 09 Apr 2021 12:59:42 -0400 Received: by mail-pf1-f174.google.com with SMTP id w8so1154982pfn.9 for <46082-done@debbugs.gnu.org>; Fri, 09 Apr 2021 09:59:42 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:in-reply-to:references:user-agent :mime-version:date:message-id:subject:to:cc; bh=qz0eAvFZpQ60w1VzE/tAuScj86PKSSKIeqvMzZP8OJc=; b=ssqddPkavMiSlvJ3Y/JSwfxT1+NRdfmYWywCwzRFHe1NLISSOTAHnLJ3CiBPYV0SiF MWD2LqBZCyO110pkXldwuZHD9ICPx70tfBEkXDwdPUIGbAEkPfao71VY3C+WqLFiaFt5 YfC43gCk1+3ghGrVRw24R8m6qlzfkbtoCzky8rgYfbwpqoEliTi+hbodHiz+AKsJ+gk1 ZW4BMAlYZbA/miKdE9V67R+PteP/uyQ8tc21zsakzzVhSkIWx+CMsUbO8sY/rBvN8481 ABZNWwzOS8EMyVct8BSLp3ERTu5GuW137lAZVCUtF54YZrI4XhzL3Yz95Rh1YEUka6zY 2S+g== X-Gm-Message-State: AOAM531cZYlZDYTj3SR88xIwF7yXm9qHzQC2TDwdlfg7RNCqEDMsdaP9 ZGoEemaJletXnkQ4M5xYRcguz+31HEPZ2T4/1xs= X-Google-Smtp-Source: ABdhPJzQkqwqGyL8DzGImOlwtUWfvAZH56P8QCPLXLH7zgw7+wHSwHThWZhl8NtUcHlnQDuc3NXNijJxZRBPt2XCvSM= X-Received: by 2002:a65:4046:: with SMTP id h6mr13932004pgp.345.1617987576549; Fri, 09 Apr 2021 09:59:36 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Fri, 9 Apr 2021 11:59:36 -0500 From: Stefan Kangas In-Reply-To: <83k0qdn4vd.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 11 Mar 2021 16:26:30 +0200") References: <87eegy6gtv.fsf@gnus.org> <83pn0i7i04.fsf@gnu.org> <83k0qdn4vd.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Date: Fri, 9 Apr 2021 11:59:36 -0500 Message-ID: Subject: Re: bug#46082: (texinfo) @ref says something lisp/info.el do not respect by default To: Eli Zaretskii Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 46082-done Cc: Marco Munari , 46082-done@debbugs.gnu.org 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.5 (/) Eli Zaretskii writes: > tags 46082 notabug > thanks [...] > This is not a bug, not an Emacs bug, anyway. I'm therefore closing this bug report. ------------=_1617987604-5777-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 24 Jan 2021 18:30:14 +0000 Received: from localhost ([127.0.0.1]:37226 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1l3k9N-0001DN-DE for submit@debbugs.gnu.org; Sun, 24 Jan 2021 13:30:14 -0500 Received: from lists.gnu.org ([209.51.188.17]:43256) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1l3iED-0002Mn-3V for submit@debbugs.gnu.org; Sun, 24 Jan 2021 11:27:05 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:33224) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1l3iEC-0006RA-SG for bug-gnu-emacs@gnu.org; Sun, 24 Jan 2021 11:27:04 -0500 Received: from fastcode.eu ([45.79.166.47]:27895 helo=nj1.fastcode.eu) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1l3iE9-0003Ml-Ay for bug-gnu-emacs@gnu.org; Sun, 24 Jan 2021 11:27:03 -0500 Received: from nb (127.10.132.1 [127.10.132.1]) by nj1.fastcode.eu (OpenSMTPD) with ESMTP id e7e34204; Sun, 24 Jan 2021 11:26:31 -0500 (EST) From: Marco Munari To: bug-gnu-emacs@gnu.org Subject: (texinfo) @ref says something lisp/info.el do not respect by default Face: iVBORw0KGgoAAAANSUhEUgAAABAAAAAOBAMAAADUAYG5AAAAMFBMVEVmLnCAgn+EhoOIioeNj4yRk5CYmpefoZ6jpaKpq6ivsa62uLS6vLnBw8DJy8h7fXrqFMmXAAAAAXRSTlMAQObYZgAAAAFiS0dEAIgFHUgAAABsSURBVAjXY2BgYODsZICAGeUQmntaAYRxOwxC8x4xgDDuOPHuaGBLZeC71nU7LKJiJsO7jvAlRuZlDQx3SyKVVMVLgWq3TZafVCTAwMCzK/DDSnmgpjPL7TkbPwAZd6c7lBuBjDnbytASAKQBe1ofD2Lqno4AAAAASUVORK5CYII= Date: Sun, 24 Jan 2021 17:26:57 +0100 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=45.79.166.47; envelope-from=mar21+dev.emacs.bugfix@allerta.it; helo=nj1.fastcode.eu X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Sun, 24 Jan 2021 13:30:12 -0500 Cc: "Kim F. Storm" 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 (--) --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi Kim, I'm writing in relation to defcustom Info-hide-note-references t in lisp= /info.el a9efebd0ba1 (Kim 2002-11-01 306) (defcustom Info-hide-note-references t because it's a bad default to proper info documentation as said in (texinfo) @ref documentation https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040ref.html ,-----------------------------------------------------------------------= ---- | 6.6 @ref | @ref is nearly the same as @xref except that it does not generate a = =E2=80=98See=E2=80=99 | in the printed output, just the reference itself. | This makes it useful as the last part of a sentence. | | For example, |=20 | For more information, @pxref{This}, and @ref{That}. | produces in Info: |=20 (*)| For more information, *note This::, and *note That::. | and in printed output: |=20 | For more information, see Section 1.1 [This], page 1, and Section 1.2 = [That], page 2. `-----------------------------------------------------------------------= ---- but with current info.el default in emacs shows (*)| For more information, see [This]., and see [That]. ( A part that with only two examples (texinfo) @ref it's not very clear that there are three cases: @ref @xref @pxref ) As I intended it, the second "see" should absolutely not be present, Info-hide-note-references is already customize-able to nil(=3Dcompliant) or hide(my preference), but the current default of t is(seem to me) not at all as designed in texinfo, for example python info documentation was plenty of misplaced ``See`` ... ``.`` (which is the reason I looked into the origin of the problem) and found it: @ref should have not a processing for info that add "See" as should while processing @xref, than the pxref is to distinguish printed rendering. I will not insist over this trivial change, if ever you disagree you can also ignore the request Cheers, Marco Munari --=20 x(t),y(t) =3D th(3t-34.5)*e^[-(3t-34.5)^2]/2-4.3+e^(-1.8/t^2)/(.8*atg(t- 3)+2)(t-1.8)-.3th(5t-42.5),(1.4e^[-(3t-34.5)^2]+1-sgn[|t-8.5|-.5]*1.5* |sin(pi*t)|^[2e^(-(t-11.5)^2)+.5+e^(-(.6t-3.3)^2)])/(.5+t)+1 ; 0