Stefan Kangas <stefankangas@HIDDEN>
to control <at> debbugs.gnu.org.
Full text available.
Received: (at 75638) by debbugs.gnu.org; 19 Jan 2025 13:55:18 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Jan 19 08:55:18 2025
Received: from localhost ([127.0.0.1]:45304 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1tZVll-0002NO-8q
for submit <at> debbugs.gnu.org; Sun, 19 Jan 2025 08:55:17 -0500
Received: from thaodan.de ([185.216.177.71]:35000)
by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.84_2) (envelope-from <bjorn.bidar@HIDDEN>)
id 1tZVli-0002Lg-3N
for 75638 <at> debbugs.gnu.org; Sun, 19 Jan 2025 08:55:15 -0500
Received: from odin (dsl-trebng12-50dc7b-49.dhcp.inet.fi [80.220.123.49])
by thaodan.de (Postfix) with ESMTPSA id 4B27AD0009B;
Sun, 19 Jan 2025 15:55:01 +0200 (EET)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=thaodan.de; s=mail;
t=1737294901; bh=U1cLtJuXfEOHHu5h/9IQNVShA0pe0KxYYgGevHN+5io=;
h=From:To:Cc:Subject:In-Reply-To:References:Date;
b=dnKI5svaz2olbWEUqhnVuDcdB6IsKVLExbcQOKbBRb1RlFgmmXF40KMYZ3vyM+ii/
/ciYdf3IxZFplRNl2irOUCiRM2ZeZAsd3Ei099KOhVWmNh3D4UbDdq3425oD4Becrb
haBFmgdW4/w+12qjZCaV9mfpNVRI6t3d5BptRmqBD6wQ80Z6/BrMovJ9outOp1lKYF
Y6Z1D019Qg0Xr/LgXufaLfzFZ9bsgXCTX+CJxDjT4WQEFUAKafhkfqIFrh+iP+fkpy
95PG5/89MMOhOamTslnYxq6S7l2hsdeZ9Vo+EcHa3UwqmqK4dP9N+6hhWl2Ez0LSE2
bOqCv+7mubsz/uzgAGxSRKLPE2riwIQElFYorvV1sh794c72GR6xTqnp6Zp2fadTyY
uqTlgUefu55ccKRaZHG7szqblY3jibGG7QL8vAsivG10HGCUIbecBxl52grHsF7mDZ
ZI4bu7pRxKXptUEQnrpFN7dr+0/FStbKuqQ3kSxh4wLErqH5HKO9VxA+VosV5oNFzR
lQVzmK2Mk9mxjn23jq4A5Rp1Fu7GzzcQGQCOSA4rbdr73ZwoGAvMwLCxyDfCKfSfXy
EAgm6iOmWrA0X/Dm9ATM/otiina4BDeyyMvxOUTR9IMjvcqJWr5U5ci/b9u7cCTlF1
qASy5yOP/5dUFpNECnjRBw7c=
From: =?utf-8?Q?Bj=C3=B6rn?= Bidar <bjorn.bidar@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#75638: [PATCH] Include various GNU manuals in info-url-alist
In-Reply-To: <86wmer8j2u.fsf@HIDDEN> (Eli Zaretskii's message of "Sun, 19 Jan
2025 07:32:25 +0200")
References: <86ed10czdv.fsf@HIDDEN> <86bjw49lji.fsf@HIDDEN>
<86wmer8j2u.fsf@HIDDEN>
Autocrypt: addr=bjorn.bidar@HIDDEN; 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
gA6IkwQTFgoAOxYhBFHxdut1RzAepymoq1wbdKFlHF9oBQJk1+ntAhsDBQsJCAcCAiICBhUKCQgL
AgQWAgMBAh4HAheAAAoJEFwbdKFlHF9oBgwA/iQHwe0VL4Df4GGTYlNjMSHFlIkBmN4UfYGLYj3E
TrOUAQC51M+M3cjsL8WHdpBz6VAo6df9d+rVwhQ9vQuFHqevArg4BGTX6T4SCisGAQQBl1UBBQEB
B0Cbohc3JEfn005/cm0AOGjSsW1ZxAkgaoVNjbpqk4MgNAMBCAeIeAQYFgoAIBYhBFHxdut1RzAe
pymoq1wbdKFlHF9oBQJk1+k+AhsMAAoJEFwbdKFlHF9ooHABAKGmrGBic/Vys3BBrOQiRB3Z7izO
HwhqTRpAqFZtXS2nAQDZhp/5aYw1TZjTzkm1KVt9QiYnjd/MvxRE9iaY6x4mDbgzBGTX6T4WCSsG
AQQB2kcPAQEHQAgRJq/tMcCCB2XyA5WZpu7GvpRx0m9IPRWazeqhOq7uiO8EGBYKACAWIQRR8Xbr
dUcwHqcpqKtcG3ShZRxfaAUCZNf71AIbIgCBCRBcG3ShZRxfaHYgBBkWCgAdFiEEUfF263VHMB6n
KairXBt0oWUcX2gFAmTX+9QACgkQXBt0oWUcX2jeSwD6AtWn0cuo8IF35YRo4o3cDRJnUfJnbvJy
GxyCDThR+zYBAKG6/jdwmZkBQZKslnDAbMMd2WfiZZT5JW3IWC4EaKMO7HkBAKYPGZ3UbfkRvfFK
S+pQ9CgtNfkSJQBtT1Ob7Y6nsacgAQCpyXN7yppmhW/oBgivITPy9Lkg+V4NK9WZYZCU9Q7LBA==
Date: Sun, 19 Jan 2025 15:54:59 +0200
Message-ID: <87wmeq52oc.fsf@>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 1.2 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.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
the administrator of that system for details.
Content preview: Eli Zaretskii <eliz@HIDDEN> writes: >> From: Björn Bidar
<bjorn.bidar@HIDDEN> >> Cc: stefankangas@HIDDEN, acorallo@HIDDEN,
juri@HIDDEN, >> 75638 <at> debbugs.gnu.org >> Date: Sat, 18 Jan 2025 22:40:40
+0200 >> >> Eli Zaretskii < [...]
Content analysis details: (1.2 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
0.0 RCVD_IN_VALIDITY_RPBL_BLOCKED RBL: ADMINISTRATOR NOTICE: The
query to Validity was blocked. See
https://knowledge.validity.com/hc/en-us/articles/20961730681243
for more information.
[185.216.177.71 listed in bl.score.senderscore.com]
0.0 RCVD_IN_VALIDITY_CERTIFIED_BLOCKED RBL: ADMINISTRATOR NOTICE:
The query to Validity was blocked. See
https://knowledge.validity.com/hc/en-us/articles/20961730681243
for more information.
[185.216.177.71 listed in sa-accredit.habeas.com]
-0.0 SPF_HELO_PASS SPF: HELO matches SPF record
-0.0 SPF_PASS SPF: sender matches SPF record
1.2 INVALID_MSGID Message-Id is not valid, according to RFC 2822
X-Debbugs-Envelope-To: 75638
Cc: acorallo@HIDDEN, 75638 <at> debbugs.gnu.org, stefankangas@HIDDEN,
juri@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 0.2 (/)
Eli Zaretskii <eliz@HIDDEN> writes:
>> From: Bj=C3=B6rn Bidar <bjorn.bidar@HIDDEN>
>> Cc: stefankangas@HIDDEN, acorallo@HIDDEN, juri@HIDDEN,
>> 75638 <at> debbugs.gnu.org
>> Date: Sat, 18 Jan 2025 22:40:40 +0200
>>=20
>> Eli Zaretskii <eliz@HIDDEN> writes:
>>=20
>> >> From: Bj=C3=B6rn Bidar <bjorn.bidar@HIDDEN>
>> >> Cc: Stefan Kangas <stefankangas@HIDDEN>, Andrea Corallo
>> >> <acorallo@HIDDEN>, Juri Linkov <juri@HIDDEN>, 75638@HIDDEN=
nu.org
>> >> Date: Sat, 18 Jan 2025 16:23:33 +0200
>> >>=20
>> >> Eli Zaretskii <eliz@HIDDEN> writes:
>> >>=20
>> >> > The canonical place that associates Texinfo manuals with the URLs of
>> >> > their Web pages is the file util/htmlxref.cnf in the Texinfo source
>> >> > tree.
>> >>=20
>> >> If this file exists why do we not use it then?
>> >
>> > It was never needed before. The current code supports only the Emacs
>> > manuals, and for those we always know where they are kept, because we
>> > upload them there.
>> >
>>=20
>> I understand that it was never needed before but from the way you
>> explained it using htmlxef.cnf was from my point of view clearly the
>> correct approach.=20
>
> "Correct" in what sense? Supporting only Emacs manuals doesn't need
> it, so depending on it is an extra dependency (and/or extra code to
> process it) when the result is known in advance. So with the current
> code, use of that file is not justified: it has disadvantages, but no
> advantages.
Correct in that would be the technically intended way of referring to the
HTML version of a node in an Info manual.
Since the references have to be maintained in that file anyway
duplication would be reduce in any case that way.
>> >> To link to documentation for example. For example a project I'm worki=
ng
>> >> on uses Autoconf. To explain a change I've made I linked to the manual
>> >> on the GNU website. Linking to HTML version of the manual is the most
>> >> accessible in a editor neutral context.
>> >
>> > First, we have in Emacs a format for linking to Info documentation.
>> > The command 'w' in Info copies the link to the kill-ring, so you can
>> > later yank it into a different place. The link is in the form
>> > "(FILENAME) NODENAME", and the Info reader can interpret it.
>>=20
>> Sure that is nice but most people don't consume manuals this way. If I
>> want to link to a manual using a link is natural linking a manual in the
>> Info form isn't natural to people who don't frequently use it, i.e.
>> Emacs- or generally GNU-users.=20
>
> These links are more natural to Emacs and Info users than the links to
> HTML docs, because the node is explicitly named in exactly the same
> words as you'd type at the prompt of the 'g' command (as opposed to a
> URL, where the node's name can be modified due to HTML requirements).
> As for people who do not use Info, why is it not enough to tell them
> the name of the manual and the node?
It is possible that a user opens a terminal and calls info but
most users who dont use terminals or know of a graphical info viewer
such as Emacs or KDE Help Center/KHelpCenter likely gloss over such
instructions. Using a web link reduces the barrier of entry to read the
referenced node.=20
Web links are just the norm outside of Emacs.
As for Emacs users or Info users who use Emacs too: It should be
possible to install a browse-url handler to reverse the mapping using
htmlxref.cnf. Emacs users who use something else than Emacs can't use
Emacs to follow Info links in general unless the do so by themselves.
However that is offtopic.
>> Regarding the maintenance burden: is there already code to parse a file
>> like htmlxref.cnf?
>
> Not that I know of, no.
OK that's to bad but the file doesn't look to difficult to parse.=20
>> The maintenace burden of using this format which
>> seems to be the intentional file to read for this should be very low.
>
> That's true, but then this command will not work if the file is not
> installed on the user's machine. Alternatively, the Emacs maintainers
> will have to remember to run some command from time to time and update
> the database from its results, which is also an additional burden.
Maybe the Texinfo people know what is the best option for this. There is
also the option to keep a copy of the file as the fallback but that
brings other issues I know.
>> >> I would like to link to Info manuals so they can be opened with Info =
but
>> >> there is no such a thing.
>> >
>> > When using Info for accessing the linked manual, there is: see above.
>>=20
>> That is not a link. A link wouldb be an uri that can be recognized by
>> the OS and then handled. Yes most Emacs modes can understand the the
>> syntax e.g. when I write (info "(emacs) Entering Emacs") then Gnus
>> understands the format and will follow the reference correctly.
>
> So you agree that, as long as the user stays in Emacs, these links do
> work.
Yes I do, at least most of the time. However Emacs users not only stay
in Emacs and even if staying in Emacs the link part doesn't work
everywhere as the linkification (don't know the right work) is only done
in some modes by themselves e.g. in Gnus articles. However that's a
different topic I think.=20
>> The function isn't called Info-goto-node-web-emacs yes the default
>> setting is to open manuals on the gnu.org server but it doesn't have to =
be.
>
> The name of a command isn't supposed (and cannot, in practice) to say
> everything about what the command does and doesn't do. That's what
> the doc string is for. Having command names that are not too long is
> also an advantage.
Sure it can't say everything, which is why I think it should be generic
to cover the general functionality and not only the default setting.
> Anyway, it's clear that we disagree about this, so let's wait for
> others to chime in and state their opinions.
No problem, no offense taken. Just replying to your comments, not
arguing to try to not disagree on this.=20
bug-gnu-emacs@HIDDEN:bug#75638; Package emacs.
Full text available.Received: (at 75638) by debbugs.gnu.org; 19 Jan 2025 05:32:39 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Jan 19 00:32:39 2025 Received: from localhost ([127.0.0.1]:44519 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1tZNvL-0007pv-70 for submit <at> debbugs.gnu.org; Sun, 19 Jan 2025 00:32:39 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:45564) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1tZNvJ-0007pj-1b for 75638 <at> debbugs.gnu.org; Sun, 19 Jan 2025 00:32:38 -0500 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 <eliz@HIDDEN>) id 1tZNvB-0001NE-Oe; Sun, 19 Jan 2025 00:32:29 -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=/1Iit3OuRxMEqjWfLw70IPnQ2CnNRbMBHSOPy4IxMxs=; b=GgdChahQWDbf1THN/gsA XHdsLC30wtbloGiE8Q2YN+tOfKSFmabKeEVwhdP0ZjW4Ve0vy0BB7DcbBtpjzEkJ2aHjhizGD6qwq 3m1jmcD0W/cCCDpoxVKiE16bU0i9+JWEQgUwRlk8BSlZvN2W5eOkIX3UGVUKEeH4ueyQTXFl5s4Ar pqgVz4OiMdXgsP8tekYiTepakXkRIHBnbyMibRkNuyDehwCCzj2PA7uy8LsZpoKqzj6/g8B9Dyxz2 JDI8U0O5la+Pma3Tot60DxOMLu1nOmXd5xiDeJQmFjwnV7oS6kwxUKnOMbbFQTbGZHRw1O80CqFd5 OT5APjCf33gE0Q==; Date: Sun, 19 Jan 2025 07:32:25 +0200 Message-Id: <86wmer8j2u.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: =?utf-8?Q?Bj=C3=B6rn?= Bidar <bjorn.bidar@HIDDEN> In-Reply-To: <87ed0z6ek7.fsf@> (message from =?utf-8?Q?Bj=C3=B6rn?= Bidar on Sat, 18 Jan 2025 22:40:40 +0200) Subject: Re: bug#75638: [PATCH] Include various GNU manuals in info-url-alist References: <86ed10czdv.fsf@HIDDEN> <86bjw49lji.fsf@HIDDEN> <87ed0z6ek7.fsf@> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 75638 Cc: acorallo@HIDDEN, 75638 <at> debbugs.gnu.org, stefankangas@HIDDEN, juri@HIDDEN X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > From: Björn Bidar <bjorn.bidar@HIDDEN> > Cc: stefankangas@HIDDEN, acorallo@HIDDEN, juri@HIDDEN, > 75638 <at> debbugs.gnu.org > Date: Sat, 18 Jan 2025 22:40:40 +0200 > > Eli Zaretskii <eliz@HIDDEN> writes: > > >> From: Björn Bidar <bjorn.bidar@HIDDEN> > >> Cc: Stefan Kangas <stefankangas@HIDDEN>, Andrea Corallo > >> <acorallo@HIDDEN>, Juri Linkov <juri@HIDDEN>, 75638 <at> debbugs.gnu.org > >> Date: Sat, 18 Jan 2025 16:23:33 +0200 > >> > >> Eli Zaretskii <eliz@HIDDEN> writes: > >> > >> > The canonical place that associates Texinfo manuals with the URLs of > >> > their Web pages is the file util/htmlxref.cnf in the Texinfo source > >> > tree. > >> > >> If this file exists why do we not use it then? > > > > It was never needed before. The current code supports only the Emacs > > manuals, and for those we always know where they are kept, because we > > upload them there. > > > > I understand that it was never needed before but from the way you > explained it using htmlxef.cnf was from my point of view clearly the > correct approach. "Correct" in what sense? Supporting only Emacs manuals doesn't need it, so depending on it is an extra dependency (and/or extra code to process it) when the result is known in advance. So with the current code, use of that file is not justified: it has disadvantages, but no advantages. > >> To link to documentation for example. For example a project I'm working > >> on uses Autoconf. To explain a change I've made I linked to the manual > >> on the GNU website. Linking to HTML version of the manual is the most > >> accessible in a editor neutral context. > > > > First, we have in Emacs a format for linking to Info documentation. > > The command 'w' in Info copies the link to the kill-ring, so you can > > later yank it into a different place. The link is in the form > > "(FILENAME) NODENAME", and the Info reader can interpret it. > > Sure that is nice but most people don't consume manuals this way. If I > want to link to a manual using a link is natural linking a manual in the > Info form isn't natural to people who don't frequently use it, i.e. > Emacs- or generally GNU-users. These links are more natural to Emacs and Info users than the links to HTML docs, because the node is explicitly named in exactly the same words as you'd type at the prompt of the 'g' command (as opposed to a URL, where the node's name can be modified due to HTML requirements). As for people who do not use Info, why is it not enough to tell them the name of the manual and the node? > Regarding the maintenance burden: is there already code to parse a file > like htmlxref.cnf? Not that I know of, no. > The maintenace burden of using this format which > seems to be the intentional file to read for this should be very low. That's true, but then this command will not work if the file is not installed on the user's machine. Alternatively, the Emacs maintainers will have to remember to run some command from time to time and update the database from its results, which is also an additional burden. > >> I would like to link to Info manuals so they can be opened with Info but > >> there is no such a thing. > > > > When using Info for accessing the linked manual, there is: see above. > > That is not a link. A link wouldb be an uri that can be recognized by > the OS and then handled. Yes most Emacs modes can understand the the > syntax e.g. when I write (info "(emacs) Entering Emacs") then Gnus > understands the format and will follow the reference correctly. So you agree that, as long as the user stays in Emacs, these links do work. > The function isn't called Info-goto-node-web-emacs yes the default > setting is to open manuals on the gnu.org server but it doesn't have to be. The name of a command isn't supposed (and cannot, in practice) to say everything about what the command does and doesn't do. That's what the doc string is for. Having command names that are not too long is also an advantage. Anyway, it's clear that we disagree about this, so let's wait for others to chime in and state their opinions.
bug-gnu-emacs@HIDDEN:bug#75638; Package emacs.
Full text available.
Received: (at 75638) by debbugs.gnu.org; 18 Jan 2025 20:40:55 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jan 18 15:40:55 2025
Received: from localhost ([127.0.0.1]:43906 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1tZFck-0003PM-JJ
for submit <at> debbugs.gnu.org; Sat, 18 Jan 2025 15:40:55 -0500
Received: from thaodan.de ([2a03:4000:4f:f15::1]:39074)
by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.84_2) (envelope-from <bjorn.bidar@HIDDEN>)
id 1tZFce-0003Op-Jq
for 75638 <at> debbugs.gnu.org; Sat, 18 Jan 2025 15:40:49 -0500
Received: from odin (dsl-trebng12-50dc7b-49.dhcp.inet.fi [80.220.123.49])
by thaodan.de (Postfix) with ESMTPSA id C16B4D00030;
Sat, 18 Jan 2025 22:40:40 +0200 (EET)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=thaodan.de; s=mail;
t=1737232841; bh=l4S0uNqXMeG/XY9wsCo4PhRHXXeOH6GBHBAIjkO+FF8=;
h=From:To:Cc:Subject:In-Reply-To:References:Date;
b=yRr/EUIVeGEubNtz7fSLKNR44nUIbZz0WhoBS1HNaPoQa/ttZXgiI3YRR41MN3Tbe
ALzPYnnmbSHI8lDGcc9w1jny5v3l5InkAIj24bDpV/L/jSe6iT6NxahJj4l8NF/XoJ
QCiTaZ3fJ9iXmlomH7X+lM1/TrH0PJiFeLRSvNxe7tusHse3rlX8wXVNSQNQ+AokJN
r6FfROwCDxUsBv/ellNqFK6i87HJQDuatmo/6GAC9jUvciXUtGyinegnBU3fHq55ax
FeGnnuR/NsxYmiY1LHiQHvdZSLwX4J3elVEYfVzoZ1MwcAvnZLO952n80EHyg6jyYX
YE3qeQsvPue5hzNi9FTRWi1SqIUriSc0v+Jh63SnHsld5X/rjV3OqoH0504B2tD+dS
qPezl6OPH18u2XjdQArFWSBeCybxWG/cGjMvtUQ9V6rewnmtQXccP5+ovnE8coY7Xd
GjmgSDiV8xDf+/84fr+3FR3pwPYjgw7aKK8yIif6tHi4jWXlerjcG/aBIgqMpXSPOP
QK6Kwm9xkg18C3vY8N2HPmftjWXOHUzPbN45xpsQov6kur9nrz5dU5Lj53Uv6ZweHU
OcqPCEcOJQA8dAqLY9RAiojIU7PidwV1ShZJVw60G6tnLkWFTQXswt1EN8Z9wu2kLF
t8kd4u9PvLutUwxGNgL/Fb/g=
From: =?utf-8?Q?Bj=C3=B6rn?= Bidar <bjorn.bidar@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#75638: [PATCH] Include various GNU manuals in info-url-alist
In-Reply-To: <86bjw49lji.fsf@HIDDEN> (Eli Zaretskii's message of "Sat, 18 Jan
2025 17:41:37 +0200")
References: <86ed10czdv.fsf@HIDDEN> <86bjw49lji.fsf@HIDDEN>
Autocrypt: addr=bjorn.bidar@HIDDEN; 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
gA6IkwQTFgoAOxYhBFHxdut1RzAepymoq1wbdKFlHF9oBQJk1+ntAhsDBQsJCAcCAiICBhUKCQgL
AgQWAgMBAh4HAheAAAoJEFwbdKFlHF9oBgwA/iQHwe0VL4Df4GGTYlNjMSHFlIkBmN4UfYGLYj3E
TrOUAQC51M+M3cjsL8WHdpBz6VAo6df9d+rVwhQ9vQuFHqevArg4BGTX6T4SCisGAQQBl1UBBQEB
B0Cbohc3JEfn005/cm0AOGjSsW1ZxAkgaoVNjbpqk4MgNAMBCAeIeAQYFgoAIBYhBFHxdut1RzAe
pymoq1wbdKFlHF9oBQJk1+k+AhsMAAoJEFwbdKFlHF9ooHABAKGmrGBic/Vys3BBrOQiRB3Z7izO
HwhqTRpAqFZtXS2nAQDZhp/5aYw1TZjTzkm1KVt9QiYnjd/MvxRE9iaY6x4mDbgzBGTX6T4WCSsG
AQQB2kcPAQEHQAgRJq/tMcCCB2XyA5WZpu7GvpRx0m9IPRWazeqhOq7uiO8EGBYKACAWIQRR8Xbr
dUcwHqcpqKtcG3ShZRxfaAUCZNf71AIbIgCBCRBcG3ShZRxfaHYgBBkWCgAdFiEEUfF263VHMB6n
KairXBt0oWUcX2gFAmTX+9QACgkQXBt0oWUcX2jeSwD6AtWn0cuo8IF35YRo4o3cDRJnUfJnbvJy
GxyCDThR+zYBAKG6/jdwmZkBQZKslnDAbMMd2WfiZZT5JW3IWC4EaKMO7HkBAKYPGZ3UbfkRvfFK
S+pQ9CgtNfkSJQBtT1Ob7Y6nsacgAQCpyXN7yppmhW/oBgivITPy9Lkg+V4NK9WZYZCU9Q7LBA==
Date: Sat, 18 Jan 2025 22:40:40 +0200
Message-ID: <87ed0z6ek7.fsf@>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 1.2 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.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
the administrator of that system for details.
Content preview: Eli Zaretskii <eliz@HIDDEN> writes: >> From: Björn Bidar
<bjorn.bidar@HIDDEN> >> Cc: Stefan Kangas <stefankangas@HIDDEN>, Andrea
Corallo >> <acorallo@HIDDEN>, Juri Linkov <juri@HIDDEN>, 75638 <at> debbugs.gnu.org
>> Date: Sat, 1 [...]
Content analysis details: (1.2 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
-0.0 SPF_HELO_PASS SPF: HELO matches SPF record
-0.0 SPF_PASS SPF: sender matches SPF record
1.2 INVALID_MSGID Message-Id is not valid, according to RFC 2822
X-Debbugs-Envelope-To: 75638
Cc: acorallo@HIDDEN, 75638 <at> debbugs.gnu.org, stefankangas@HIDDEN,
juri@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 0.2 (/)
Eli Zaretskii <eliz@HIDDEN> writes:
>> From: Bj=C3=B6rn Bidar <bjorn.bidar@HIDDEN>
>> Cc: Stefan Kangas <stefankangas@HIDDEN>, Andrea Corallo
>> <acorallo@HIDDEN>, Juri Linkov <juri@HIDDEN>, 75638@HIDDEN=
org
>> Date: Sat, 18 Jan 2025 16:23:33 +0200
>>=20
>> Eli Zaretskii <eliz@HIDDEN> writes:
>>=20
>> > The canonical place that associates Texinfo manuals with the URLs of
>> > their Web pages is the file util/htmlxref.cnf in the Texinfo source
>> > tree.
>>=20
>> If this file exists why do we not use it then?
>
> It was never needed before. The current code supports only the Emacs
> manuals, and for those we always know where they are kept, because we
> upload them there.
>
I understand that it was never needed before but from the way you
explained it using htmlxef.cnf was from my point of view clearly the
correct approach.=20
>> > I'm not sure I like this direction of extending Info-goto-node-web.
>> > It was designed to support the Emacs manuals.
>>=20
>> Info is for reading info Texinfo manuals not just Emacs manuals right?
>> If so the command isn't just specific to Emacs manuals.=20
>
> I'm not talking about Info in general, I'm talking about this
> particular command.
I understand that you were talking about this command, I thought that
was implied, I was also talking about that command. The command does not
read like it is purely intended for the use with Emacs related manuals
but to browse the web version of manuals in general. I don't see how the
original intend of the function is a blocker to expand the command in
general.=20
>> > Adding all this stuff to it takes us very far from that goal, and
>> > I'm not sure why would we want that.
>>=20
>> To link to documentation for example. For example a project I'm working
>> on uses Autoconf. To explain a change I've made I linked to the manual
>> on the GNU website. Linking to HTML version of the manual is the most
>> accessible in a editor neutral context.
>
> First, we have in Emacs a format for linking to Info documentation.
> The command 'w' in Info copies the link to the kill-ring, so you can
> later yank it into a different place. The link is in the form
> "(FILENAME) NODENAME", and the Info reader can interpret it.
Sure that is nice but most people don't consume manuals this way. If I
want to link to a manual using a link is natural linking a manual in the
Info form isn't natural to people who don't frequently use it, i.e.
Emacs- or generally GNU-users.=20
=20
> And second, the use case you describe sounds like a weak justification
> for such a significant change and future maintenance burden. I'm
> interested to hear the opinions of the other maintainers.
Weak justification? To interact with users outside of users who don't
frequently use Info? Linking the manual specific to the relevant topic
e.g. as mentioned to fix an issue in a autoconf script is a good thing
to expose users to these manuals. First because the burden to open them
is low and second because learning that there is worthwhile
documentation in Info could motivate them to open the Info reader of
their choice.
Please try to put yourself in the shoes of the target audience. I now
that for long time Emacs users even the current version of the command
isn't really relevant.
Regarding the maintenance burden: is there already code to parse a file
like htmlxref.cnf? The maintenace burden of using this format which
seems to be the intentional file to read for this should be very low.
>> > Proliferating use of HTML docs on the Web (as opposed to
>> > local Info manuals) is not a goal I'd like us to pursue.
>> >
>> I would like to link to Info manuals so they can be opened with Info but
>> there is no such a thing.
>
> When using Info for accessing the linked manual, there is: see above.
That is not a link. A link wouldb be an uri that can be recognized by
the OS and then handled. Yes most Emacs modes can understand the the
syntax e.g. when I write (info "(emacs) Entering Emacs") then Gnus
understands the format and will follow the reference correctly.
>> > In any case, if this is installed, the doc string of
>> > Info-goto-node-web should also be updated, as it no longer goes only
>> > to gnu.org Web server. A NEWS entry is probably also warranted.
>>=20
>> That does make sense. IMHO it is a little confusing that the function
>> refers to gnu.org when the server isn't the only one hosting Info manual=
s.
>
> The doc string is pertinent for the Emacs manuals, which are hosted on
> the gnu.org server.
The function isn't called Info-goto-node-web-emacs yes the default
setting is to open manuals on the gnu.org server but it doesn't have to be.
bug-gnu-emacs@HIDDEN:bug#75638; Package emacs.
Full text available.Received: (at 75638) by debbugs.gnu.org; 18 Jan 2025 15:41:50 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jan 18 10:41:50 2025 Received: from localhost ([127.0.0.1]:43417 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1tZAxK-0006WP-8T for submit <at> debbugs.gnu.org; Sat, 18 Jan 2025 10:41:50 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:35856) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1tZAxH-0006W9-AQ for 75638 <at> debbugs.gnu.org; Sat, 18 Jan 2025 10:41:48 -0500 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 <eliz@HIDDEN>) id 1tZAxA-0000IV-W8; Sat, 18 Jan 2025 10:41:41 -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=r3WZ535BRwZg4QwQGN/827+1avj/1/HBLFPoeybLoo4=; b=U03w+FiXeM5IDQrU0fDZ ZTYjJZE0r2kmTKjW2WRot73J7hi3uo9J4eTYtXjMnYwr2mbTPp1URI+ymgXkoPdVvcKIK2eaVAy6e vR/fySNYbz+el0NS2R8M1uhAs88gBpTZfN5IyjlA4y9c6ulwucupktiBc9Gddjzg2IIXLGDFGFjcq VwyxQLxn6qFJtLsQ37dsKpm01uWCdMtY6dv8lW+KrcGcF/J5+wSumJWOvw4COUHVoTV7ByGwAahz5 IyuNdANHY8NM9uu8GwW5e9LbJejPBLqyAvHP8TuFlBwWeTHUJPs0WgWubhyc3kCN76TVZKHip7V2Y 9O9VURj+XtjE8Q==; Date: Sat, 18 Jan 2025 17:41:37 +0200 Message-Id: <86bjw49lji.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: =?utf-8?Q?Bj=C3=B6rn?= Bidar <bjorn.bidar@HIDDEN> In-Reply-To: <8734hgdwuy.fsf@> (message from =?utf-8?Q?Bj=C3=B6rn?= Bidar on Sat, 18 Jan 2025 16:23:33 +0200) Subject: Re: bug#75638: [PATCH] Include various GNU manuals in info-url-alist References: <86ed10czdv.fsf@HIDDEN> <8734hgdwuy.fsf@> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 75638 Cc: acorallo@HIDDEN, 75638 <at> debbugs.gnu.org, stefankangas@HIDDEN, juri@HIDDEN X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > From: Björn Bidar <bjorn.bidar@HIDDEN> > Cc: Stefan Kangas <stefankangas@HIDDEN>, Andrea Corallo > <acorallo@HIDDEN>, Juri Linkov <juri@HIDDEN>, 75638 <at> debbugs.gnu.org > Date: Sat, 18 Jan 2025 16:23:33 +0200 > > Eli Zaretskii <eliz@HIDDEN> writes: > > > The canonical place that associates Texinfo manuals with the URLs of > > their Web pages is the file util/htmlxref.cnf in the Texinfo source > > tree. > > If this file exists why do we not use it then? It was never needed before. The current code supports only the Emacs manuals, and for those we always know where they are kept, because we upload them there. > > I'm not sure I like this direction of extending Info-goto-node-web. > > It was designed to support the Emacs manuals. > > Info is for reading info Texinfo manuals not just Emacs manuals right? > If so the command isn't just specific to Emacs manuals. I'm not talking about Info in general, I'm talking about this particular command. > > Adding all this stuff to it takes us very far from that goal, and > > I'm not sure why would we want that. > > To link to documentation for example. For example a project I'm working > on uses Autoconf. To explain a change I've made I linked to the manual > on the GNU website. Linking to HTML version of the manual is the most > accessible in a editor neutral context. First, we have in Emacs a format for linking to Info documentation. The command 'w' in Info copies the link to the kill-ring, so you can later yank it into a different place. The link is in the form "(FILENAME) NODENAME", and the Info reader can interpret it. And second, the use case you describe sounds like a weak justification for such a significant change and future maintenance burden. I'm interested to hear the opinions of the other maintainers. > > Proliferating use of HTML docs on the Web (as opposed to > > local Info manuals) is not a goal I'd like us to pursue. > > > I would like to link to Info manuals so they can be opened with Info but > there is no such a thing. When using Info for accessing the linked manual, there is: see above. > > In any case, if this is installed, the doc string of > > Info-goto-node-web should also be updated, as it no longer goes only > > to gnu.org Web server. A NEWS entry is probably also warranted. > > That does make sense. IMHO it is a little confusing that the function > refers to gnu.org when the server isn't the only one hosting Info manuals. The doc string is pertinent for the Emacs manuals, which are hosted on the gnu.org server.
bug-gnu-emacs@HIDDEN:bug#75638; Package emacs.
Full text available.
Received: (at 75638) by debbugs.gnu.org; 18 Jan 2025 14:23:44 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jan 18 09:23:44 2025
Received: from localhost ([127.0.0.1]:40789 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1tZ9jk-0002EG-6k
for submit <at> debbugs.gnu.org; Sat, 18 Jan 2025 09:23:44 -0500
Received: from thaodan.de ([2a03:4000:4f:f15::1]:36814)
by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.84_2) (envelope-from <bjorn.bidar@HIDDEN>)
id 1tZ9ji-0002Dw-B0
for 75638 <at> debbugs.gnu.org; Sat, 18 Jan 2025 09:23:42 -0500
Received: from odin (dsl-trebng12-50dc7b-49.dhcp.inet.fi [80.220.123.49])
by thaodan.de (Postfix) with ESMTPSA id 604CFD00076;
Sat, 18 Jan 2025 16:23:35 +0200 (EET)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=thaodan.de; s=mail;
t=1737210215; bh=p5TUaqXww6ulocDjiua6MqnGfd6j9bo0vUOJjv/D9wo=;
h=From:To:Cc:Subject:In-Reply-To:References:Date;
b=mLo+2oBoel4+hxQEI5dNgz1W8Tg8Aw94QGOQb46uB84DAC3O4Jsge/WijZBX+FaW2
9Vlz4dYe7h39xVH2LGYwmte/92g0okVSVVsjV5Kn4QR3zl54ufhNkRxEAC08V9YlzE
2RKxNwjX50cipBtkpn4p4BiYUjRA1HL57G9Xql2yqFXwcJ3pQLpJ/Emqo+a+DGF44v
xuaxDAZecBjNLlC4NNTQfgFF1yXXmieo15y57Q+nhbIFywF1oCrWuzZMy+ahWNRVT2
qpgP0EZazmC35rU6CbR528vtd/rcnM9mY1TymmBwXHSssiglQ7tJ2V/YkjIMwSa68S
ayD4Nc7gw8x8bKzoczsL5H/gdznqbS5ZcNrgr3kp9UUH8EUCwPGU3lujJ7391BO1oJ
YZzGPNdgnDdGmyrGqLks+wO9Az5nEL6q26KIlUgxoN+IaHpZxqcJNVq+XrecY0inDY
FYtQpuqVNiFH1iwhjmhpzHnDU/otdRtI0l2uOhh/CkcIKuxppdZa27Bm5kufGAjX35
w+J5US9egW7CbV1afr4KZnbn+VCUHPngBr+54oIFYWeY+7ftgaWUeKD9EusdB+7/DC
sJr4dJ/Cn13uxGLi/EZsq2igOyZvykHjTkBwLMlm8/4caLY+nPMqG2jslyno+akGd5
S0Ny85vjVeehBxxWx7UhJ+zk=
From: =?utf-8?Q?Bj=C3=B6rn?= Bidar <bjorn.bidar@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#75638: [PATCH] Include various GNU manuals in info-url-alist
In-Reply-To: <86ed10czdv.fsf@HIDDEN> (Eli Zaretskii's message of "Sat, 18 Jan
2025 10:14:20 +0200")
References: <86ed10czdv.fsf@HIDDEN>
Autocrypt: addr=bjorn.bidar@HIDDEN; 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
gA6IkwQTFgoAOxYhBFHxdut1RzAepymoq1wbdKFlHF9oBQJk1+ntAhsDBQsJCAcCAiICBhUKCQgL
AgQWAgMBAh4HAheAAAoJEFwbdKFlHF9oBgwA/iQHwe0VL4Df4GGTYlNjMSHFlIkBmN4UfYGLYj3E
TrOUAQC51M+M3cjsL8WHdpBz6VAo6df9d+rVwhQ9vQuFHqevArg4BGTX6T4SCisGAQQBl1UBBQEB
B0Cbohc3JEfn005/cm0AOGjSsW1ZxAkgaoVNjbpqk4MgNAMBCAeIeAQYFgoAIBYhBFHxdut1RzAe
pymoq1wbdKFlHF9oBQJk1+k+AhsMAAoJEFwbdKFlHF9ooHABAKGmrGBic/Vys3BBrOQiRB3Z7izO
HwhqTRpAqFZtXS2nAQDZhp/5aYw1TZjTzkm1KVt9QiYnjd/MvxRE9iaY6x4mDbgzBGTX6T4WCSsG
AQQB2kcPAQEHQAgRJq/tMcCCB2XyA5WZpu7GvpRx0m9IPRWazeqhOq7uiO8EGBYKACAWIQRR8Xbr
dUcwHqcpqKtcG3ShZRxfaAUCZNf71AIbIgCBCRBcG3ShZRxfaHYgBBkWCgAdFiEEUfF263VHMB6n
KairXBt0oWUcX2gFAmTX+9QACgkQXBt0oWUcX2jeSwD6AtWn0cuo8IF35YRo4o3cDRJnUfJnbvJy
GxyCDThR+zYBAKG6/jdwmZkBQZKslnDAbMMd2WfiZZT5JW3IWC4EaKMO7HkBAKYPGZ3UbfkRvfFK
S+pQ9CgtNfkSJQBtT1Ob7Y6nsacgAQCpyXN7yppmhW/oBgivITPy9Lkg+V4NK9WZYZCU9Q7LBA==
Date: Sat, 18 Jan 2025 16:23:33 +0200
Message-ID: <8734hgdwuy.fsf@>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 1.2 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.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
the administrator of that system for details.
Content preview: Eli Zaretskii <eliz@HIDDEN> writes: >> Date: Sat, 18 Jan
2025 04:45:50 +0200 >> From: Björn Bidar via "Bug reports for GNU Emacs,
>> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> >> >> The
patch adds various GNU manuals [...]
Content analysis details: (1.2 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
-0.0 SPF_PASS SPF: sender matches SPF record
-0.0 SPF_HELO_PASS SPF: HELO matches SPF record
1.2 INVALID_MSGID Message-Id is not valid, according to RFC 2822
X-Debbugs-Envelope-To: 75638
Cc: Andrea Corallo <acorallo@HIDDEN>, 75638 <at> debbugs.gnu.org,
Stefan Kangas <stefankangas@HIDDEN>, Juri Linkov <juri@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 0.2 (/)
Eli Zaretskii <eliz@HIDDEN> writes:
>> Date: Sat, 18 Jan 2025 04:45:50 +0200
>> From: Bj=C3=B6rn Bidar via "Bug reports for GNU Emacs,
>> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
>>=20
>> The patch adds various GNU manuals to the default value of
>> Info-url-alist.
>> I scanned https://www.gnu.org/manual/ for the manuals which could go
>> into this list.
>
> The canonical place that associates Texinfo manuals with the URLs of
> their Web pages is the file util/htmlxref.cnf in the Texinfo source
> tree.
If this file exists why do we not use it then?
> I'm not sure I like this direction of extending Info-goto-node-web.
> It was designed to support the Emacs manuals.
Info is for reading info Texinfo manuals not just Emacs manuals right?
If so the command isn't just specific to Emacs manuals.=20
> Adding all this stuff to it takes us very far from that goal, and
> I'm not sure why would we want that.
To link to documentation for example. For example a project I'm working
on uses Autoconf. To explain a change I've made I linked to the manual
on the GNU website. Linking to HTML version of the manual is the most
accessible in a editor neutral context.
> Proliferating use of HTML docs on the Web (as opposed to
> local Info manuals) is not a goal I'd like us to pursue.
>
I would like to link to Info manuals so they can be opened with Info but
there is no such a thing. If such functionality is ok with Emacs related
manuals it should be ok with all manuals. If we want to increase the
users of these manuals the accessibility of the manuals needs to be
improved being able to link to all the manuals is a step into that directio=
n.=20
> This also makes us responsible for keeping this list up-to-date, which
> means we'd need to track the Texinfo's htmlxref.cnf file from now on.
> A slightly better change would be to add a command that will process
> htmlxref.cnf file (if it's installed in /usr/share/texinfo/) and
> augment the value of Info-url-alist with the URLs found there.
Why wasn't this file used in the first place?
> I've added Stefan, Andrea and Juri to this discussion, and would be
> interested to hear their opinions on this change.
>
> In any case, if this is installed, the doc string of
> Info-goto-node-web should also be updated, as it no longer goes only
> to gnu.org Web server. A NEWS entry is probably also warranted.
That does make sense. IMHO it is a little confusing that the function
refers to gnu.org when the server isn't the only one hosting Info manuals.
bug-gnu-emacs@HIDDEN:bug#75638; Package emacs.
Full text available.Received: (at 75638) by debbugs.gnu.org; 18 Jan 2025 08:14:37 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jan 18 03:14:37 2025 Received: from localhost ([127.0.0.1]:39946 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1tZ3yX-0006LR-53 for submit <at> debbugs.gnu.org; Sat, 18 Jan 2025 03:14:37 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:57904) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1tZ3yV-0006LF-DE for 75638 <at> debbugs.gnu.org; Sat, 18 Jan 2025 03:14:35 -0500 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 <eliz@HIDDEN>) id 1tZ3yN-0001MF-TA; Sat, 18 Jan 2025 03:14:27 -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=hdU5gZCYpigLvcJ8/7K7YjF62QIReiUPCVFmIHAOgm8=; b=add/8t/X+Epglb2bM/Lb EpQ2ZX6276IVQw3qDQD89nIWq5o57z1geJIQPAHWLlOotKV1u3QS3EahXYV0YgUCycP0Nwnhtg3Hi A0AHVrmh24WbfORX1zzUnfJllJgCboVoj5vU0sXnkxk2oU7PYGaz8ur0ANkhrufDoc4R4bp723BUc PrvVddlecCiBwco1n5ZKbgfUMihQfD65RTiODmbdWQ0tWVVxJWV+xTdJlvLsNc7sWEfvZGhMNmDFZ 70fjEqSA84Dkj7iPZP+72GjSuWlAMkawT+U4XMKyy7m7LQQryQjFsjIn3O+S4jsnmmTXzbLbRxFRX igQEETcqkVwKyA==; Date: Sat, 18 Jan 2025 10:14:20 +0200 Message-Id: <86ed10czdv.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: =?iso-8859-1?Q?Bj=F6rn?= Bidar <bjorn.bidar@HIDDEN>, Stefan Kangas <stefankangas@HIDDEN>, Andrea Corallo <acorallo@HIDDEN>, Juri Linkov <juri@HIDDEN> In-Reply-To: <87plkket5t.fsf@> (bug-gnu-emacs@HIDDEN) Subject: Re: bug#75638: [PATCH] Include various GNU manuals in info-url-alist References: <87plkket5t.fsf@> MIME-version: 1.0 Content-type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 75638 Cc: 75638 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > Date: Sat, 18 Jan 2025 04:45:50 +0200 > From: Björn Bidar via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> > > The patch adds various GNU manuals to the default value of > Info-url-alist. > I scanned https://www.gnu.org/manual/ for the manuals which could go > into this list. The canonical place that associates Texinfo manuals with the URLs of their Web pages is the file util/htmlxref.cnf in the Texinfo source tree. I'm not sure I like this direction of extending Info-goto-node-web. It was designed to support the Emacs manuals. Adding all this stuff to it takes us very far from that goal, and I'm not sure why would we want that. Proliferating use of HTML docs on the Web (as opposed to local Info manuals) is not a goal I'd like us to pursue. This also makes us responsible for keeping this list up-to-date, which means we'd need to track the Texinfo's htmlxref.cnf file from now on. A slightly better change would be to add a command that will process htmlxref.cnf file (if it's installed in /usr/share/texinfo/) and augment the value of Info-url-alist with the URLs found there. I've added Stefan, Andrea and Juri to this discussion, and would be interested to hear their opinions on this change. In any case, if this is installed, the doc string of Info-goto-node-web should also be updated, as it no longer goes only to gnu.org Web server. A NEWS entry is probably also warranted. Thanks.
bug-gnu-emacs@HIDDEN:bug#75638; Package emacs.
Full text available.
Received: (at submit) by debbugs.gnu.org; 18 Jan 2025 02:46:24 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Jan 17 21:46:24 2025
Received: from localhost ([127.0.0.1]:39501 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1tYyqk-0007Bg-OF
for submit <at> debbugs.gnu.org; Fri, 17 Jan 2025 21:46:24 -0500
Received: from lists.gnu.org ([2001:470:142::17]:60834)
by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.84_2) (envelope-from <bjorn.bidar@HIDDEN>)
id 1tYyqf-0007BM-GE
for submit <at> debbugs.gnu.org; Fri, 17 Jan 2025 21:46:12 -0500
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 <bjorn.bidar@HIDDEN>)
id 1tYyqY-0000bU-1B
for bug-gnu-emacs@HIDDEN; Fri, 17 Jan 2025 21:46:02 -0500
Received: from thaodan.de ([185.216.177.71])
by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.90_1) (envelope-from <bjorn.bidar@HIDDEN>)
id 1tYyqT-0007ev-Ii
for bug-gnu-emacs@HIDDEN; Fri, 17 Jan 2025 21:46:01 -0500
Received: from odin (dsl-trebng12-50dc7b-49.dhcp.inet.fi [80.220.123.49])
by thaodan.de (Postfix) with ESMTPSA id 784A5D0004F
for <bug-gnu-emacs@HIDDEN>; Sat, 18 Jan 2025 04:45:51 +0200 (EET)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=thaodan.de; s=mail;
t=1737168351; bh=q0ung0KpeBTlql9Qk3fWoCeg6rWfXDiHZnSbWaoh4/c=;
h=From:To:Subject:Date;
b=tyMtNMSPNfUSFhhQZDf+HlS0Uok0gAUTlYOxzSO74ba3Xt/cF3Iz2/kqUNxvJa46+
Z+KzXlwl47efJpPycXUmCYZ1jUsHbSzyn87mYhJtoYzkuX4BAynSzaQeuMCgBnjibE
cicx4vJjmyTLmCYi5nH9IUUNsbSNfxd5HR8Ba4vXps76vRvd8T9APA2pLr+oXxuHpM
TiQ3PmQ8Sj6F+ABZcmBMuq9+JMjtSYxXpL8fEivU04WZba/MCURa+K/ZwIfHPddO9B
dFOSOoPc2T6YM5Gv+7kmv+8AMp7tk6PNDVzzSPtr0c8lQr11ZTjU+teuJB6us7jvjB
XfvRfCfJqD0zqXQM4Pg1Tn/v/lkHWsCbQj+Oge7kLi197+3kvGlX4Wh8z22zNnAjs6
kCvoXf9J/yn5kqrqOCGjQj9l5awE0mv850Su+C+sLdqadbDRN6BVFj3J6c09YuwLma
lQHaDQRyJ3L5jrRgB7sEeukpxnkyi3KNXIeL64SR49vKy5Lq8dRgS08oqJMyadL2WM
W5MssSRzup2F6gC5RALUDoVUlgJUIygrZLC1Niwivcb82xt0GhAq13fSWo6J8/hVjl
5/WqawYS6Qx5JA02bS32U6hqMuJ9SeCFHdsTw6kdFocZlqqlxHfSOKr+cc06JCL8VT
ho8HoHiZqN9/068b/NWE9u7s=
From: =?utf-8?Q?Bj=C3=B6rn?= Bidar <bjorn.bidar@HIDDEN>
To: bug-gnu-emacs@HIDDEN
Subject: [PATCH] Include various GNU manuals in info-url-alist
X-Debbugs-Cc:
Autocrypt: addr=bjorn.bidar@HIDDEN; 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
gA6IkwQTFgoAOxYhBFHxdut1RzAepymoq1wbdKFlHF9oBQJk1+ntAhsDBQsJCAcCAiICBhUKCQgL
AgQWAgMBAh4HAheAAAoJEFwbdKFlHF9oBgwA/iQHwe0VL4Df4GGTYlNjMSHFlIkBmN4UfYGLYj3E
TrOUAQC51M+M3cjsL8WHdpBz6VAo6df9d+rVwhQ9vQuFHqevArg4BGTX6T4SCisGAQQBl1UBBQEB
B0Cbohc3JEfn005/cm0AOGjSsW1ZxAkgaoVNjbpqk4MgNAMBCAeIeAQYFgoAIBYhBFHxdut1RzAe
pymoq1wbdKFlHF9oBQJk1+k+AhsMAAoJEFwbdKFlHF9ooHABAKGmrGBic/Vys3BBrOQiRB3Z7izO
HwhqTRpAqFZtXS2nAQDZhp/5aYw1TZjTzkm1KVt9QiYnjd/MvxRE9iaY6x4mDbgzBGTX6T4WCSsG
AQQB2kcPAQEHQAgRJq/tMcCCB2XyA5WZpu7GvpRx0m9IPRWazeqhOq7uiO8EGBYKACAWIQRR8Xbr
dUcwHqcpqKtcG3ShZRxfaAUCZNf71AIbIgCBCRBcG3ShZRxfaHYgBBkWCgAdFiEEUfF263VHMB6n
KairXBt0oWUcX2gFAmTX+9QACgkQXBt0oWUcX2jeSwD6AtWn0cuo8IF35YRo4o3cDRJnUfJnbvJy
GxyCDThR+zYBAKG6/jdwmZkBQZKslnDAbMMd2WfiZZT5JW3IWC4EaKMO7HkBAKYPGZ3UbfkRvfFK
S+pQ9CgtNfkSJQBtT1Ob7Y6nsacgAQCpyXN7yppmhW/oBgivITPy9Lkg+V4NK9WZYZCU9Q7LBA==
Date: Sat, 18 Jan 2025 04:45:50 +0200
Message-ID: <87plkket5t.fsf@>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
Received-SPF: pass client-ip=185.216.177.71;
envelope-from=bjorn.bidar@HIDDEN; 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,
RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001,
SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 2.1 (++)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.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
the administrator of that system for details.
Content preview: Tags: patch The patch adds various GNU manuals to the default
value of Info-url-alist. I scanned https://www.gnu.org/manual/ for the manuals
which could go into this list. The change affects all users which have [...]
Content analysis details: (2.1 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
1.0 SPF_SOFTFAIL SPF: sender does not match SPF record (softfail)
-0.0 SPF_HELO_PASS SPF: HELO matches SPF record
-0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/,
no trust [2001:470:142:0:0:0:0:17 listed in] [list.dnswl.org]
1.2 INVALID_MSGID Message-Id is not valid, according to RFC 2822
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 1.1 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.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
the administrator of that system for details.
Content preview: Tags: patch The patch adds various GNU manuals to the default
value of Info-url-alist. I scanned https://www.gnu.org/manual/ for the manuals
which could go into this list. The change affects all users which have [...]
Content analysis details: (1.1 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
1.0 SPF_SOFTFAIL SPF: sender does not match SPF record (softfail)
-0.0 SPF_HELO_PASS SPF: HELO matches SPF record
1.2 INVALID_MSGID Message-Id is not valid, according to RFC 2822
-1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list
manager
--=-=-=
Content-Type: text/plain
Tags: patch
The patch adds various GNU manuals to the default value of
Info-url-alist.
I scanned https://www.gnu.org/manual/ for the manuals which could go
into this list. The change affects all users which have those manuals
installed so that Info can browse these by default.
The patch would be a little simpler if there would be a specifier
that doesn't include the HTML extension. However if the lambda
function isn't an issue that's fine.
The remaining issue is that the c-intro-and-ref manual is called c when
using building it with make, similarly the glibc manual is called libc.
Either the manual installed with the wrong name or the GNU website is wrong.
In GNU Emacs 31.0.50 (build 1, x86_64-suse-linux-gnu, GTK+ Version
3.24.43, cairo version 1.18.2)
Repository revision: eaf5bf736e1dd5eb977a16a3f1b3dfd3da3c4612
Repository branch: master
Windowing system distributor 'The X.Org Foundation', version 11.0.12101014
System Description: openSUSE Tumbleweed
Configured using:
'configure --disable-build-details --without-pop --with-mailutils
--without-hesiod --with-gameuser=:games --with-kerberos
--with-kerberos5 --with-file-notification=inotify --with-modules
--enable-autodepend --enable-link-time-optimization --prefix=/usr
--mandir=/usr/share/man --infodir=/usr/share/info --datadir=/usr/share
--localstatedir=/var --sharedstatedir=/var/lib
--libexecdir=/usr/libexec --with-file-notification=yes
--libdir=/usr/lib64 --with-native-compilation=aot
--enable-locallisppath=/usr/share/emacs/31.0.50/site-lisp:/usr/share/emacs/site-lisp
--with-x --with-xim --with-sound --with-xpm --with-jpeg --with-tiff
--with-gif --with-png --with-rsvg --with-dbus --with-xft --without-gpm
--with-tree-sitter --with-x-toolkit=gtk --without-pgtk
--with-toolkit-scroll-bars --x-includes=/usr/include
--x-libraries=/usr/lib64 --with-libotf --with-m17n-flt --with-cairo
--build=x86_64-suse-linux --with-dumping=pdumper
build_alias=x86_64-suse-linux 'CC=sccache cc' 'CFLAGS=-O2 -Wall
-U_FORTIFY_SOURCE -D_FORTIFY_SOURCE=3 -fstack-protector-strong
-funwind-tables -fasynchronous-unwind-tables -fstack-clash-protection
-Werror=return-type -flto=auto -march=znver3 -mmmx -mpopcnt -msse
-msse2 -msse3 -mssse3 -msse4.1 -msse4.2 -mavx -mavx2 -msse4a -mno-fma4
-mno-xop -mfma -mbmi -mbmi2 -maes -mpclmul -mno-gfni -mvpclmulqdq
-mno-3dnow -madx -mabm -mno-cldemote -mclflushopt -mclwb -mclzero
-mcx16 -mno-enqcmd -mf16c -mfsgsbase -mfxsr -mno-hle -msahf -mno-lwp
-mlzcnt -mmovbe -mno-movdir64b -mno-movdiri -mmwaitx -mno-pconfig -mpku
-mprfchw -mno-ptwrite -mrdpid -mrdrnd -mrdseed -mno-rtm -mno-serialize
-mno-sgx -msha -mshstk -mno-tbm -mno-tsxldtrk -mvaes -mno-waitpkg
-mwbnoinvd -mxsave -mxsavec -mxsaveopt -mxsaves -mno-amx-tile
-mno-amx-int8 -mno-amx-bf16 -mno-uintr -mno-hreset -mno-kl -mno-widekl
-mno-avxvnni -mno-avxifma -mno-avxvnniint8 -mno-avxneconvert
-mno-cmpccxadd -mno-amx-fp16 -mno-prefetchi -mno-raoint
-mno-amx-complex --param l1-cache-size=32 --param l1-cache-line-size=64
--param l2-cache-size=512 -mtune=znver3 -fno-optimize-sibling-calls -O2
-Wall -U_FORTIFY_SOURCE -D_FORTIFY_SOURCE=3 -fstack-protector-strong
-funwind-tables -fasynchronous-unwind-tables -fstack-clash-protection
-Werror=return-type -flto=auto -g -D_GNU_SOURCE
-DGDK_DISABLE_DEPRECATION_WARNINGS -DGLIB_DISABLE_DEPRECATION_WARNINGS
-pipe -Wno-pointer-sign -Wno-unused-variable -Wno-unused-label
-DPDMP_BASE='\''"emacs-gtk"'\''' LDFLAGS=-Wl,-O2 'CXX=sccache c++'
PKG_CONFIG_PATH=:/usr/lib64/pkgconfig:/usr/share/pkgconfig'
--=-=-=
Content-Type: text/patch
Content-Disposition: attachment;
filename=0001-Include-various-GNU-manuals-in-info-url-alist.patch
From f0b1a884003ef26d2243620aca4cf643e762b58f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bj=C3=B6rn=20Bidar?= <bjorn.bidar@HIDDEN>
Date: Sat, 18 Jan 2025 04:30:08 +0200
Subject: [PATCH] Include various GNU manuals in info-url-alist
* lisp/info.el (Info-url-alist): Include various
GNU manuals in default value. Update documentation
string accordingly.
---
lisp/info.el | 231 +++++++++++++++++++++++++++++++++++++++++++++++----
1 file changed, 217 insertions(+), 14 deletions(-)
diff --git a/lisp/info.el b/lisp/info.el
index 69f699894c2..198641799cb 100644
--- a/lisp/info.el
+++ b/lisp/info.el
@@ -220,7 +220,8 @@ Info-additional-directory-list
:type '(repeat directory))
(defcustom Info-url-alist
- '((("auth" "autotype" "bovine" "calc" "ccmode" "cl" "dbus" "dired-x"
+ '((;; Emacs specific manuals
+ ("auth" "autotype" "bovine" "calc" "ccmode" "cl" "dbus" "dired-x"
"ebrowse" "ede" "ediff" "edt" "efaq" "efaq-w32" "eglot" "eieio"
"eintr" "elisp" "emacs" "emacs-gnutls" "emacs-mime" "epa" "erc"
"ert" "eshell" "eudc" "eww" "flymake" "forms" "gnus"
@@ -230,7 +231,209 @@ Info-url-alist
"semantic" "ses" "sieve" "smtpmail" "speedbar" "srecode"
"todo-mode" "tramp" "transient" "url" "use-package" "vhdl-mode"
"viper" "vtable" "widget" "wisent" "woman") .
- "https://www.gnu.org/software/emacs/manual/html_node/%m/%e"))
+ "https://www.gnu.org/software/emacs/manual/html_node/%m/%e")
+ ;; GNU software where each has one manual
+ ((;; Archiving
+ "cpio" "gzip" "sharutils" "tar"
+ ;; Audio
+ "ccd2cue" "gmediaserver" "guile-sdl"
+ ;; Business and productivity
+ "gcal" "libextractor" "gdbm"
+ ;; Database
+ "recutils" "sqltutor"
+ ;; Education
+ "mdk"
+ ;; Fonts
+ "fontopia"
+ ;; Games
+ "acm" "chess" "gnubik" "gnushogi" "liquidwar6" "motti" "xboard"
+ ;; Graphics
+ "guile-opengl"
+ ;; Interface
+ "g-golf" "gnuit" "guile-ncurses" "remotecontrol"
+ ;; Internet applications
+ "alive" "artanis" "inetutils" "librejs" "proxyknife"
+ "websocket4j" "wget"
+ ;; Localization
+ "gettext"
+ ;; Mathematics
+ "aris" "datamash" "mpria" "pspp"
+ ;; Printing
+ "a2ps" "gv"
+ ;; Science
+ "gama" "gnuastro" "libredwg" "units"
+ ;; Security
+ "gnu-pw-mgr" "libtasn1" "radius"
+ ;; Software development
+ "autoconf" "autogen" "automake" "bash" "bison" "cflow" "complexity"
+ "coreutils" "findutils" "c-intro-and-ref" "gnulib" "gperf" "guile"
+ "guile-rpc" "idutils" "make" "diffutils" "rush" "screen"
+ "smalltalk" "teseq"
+ ;; Software libraries
+ "8sync" "gsasl" "guile-cv" "glibc" "libidn" "libmicrohttpd"
+ "libtool" "libunistring" "lightning"
+ ;; System administration
+ "acct" "grub" "gsrc" "mcron" "mes" "parted" "serveez"
+ "shepherd" "stow"
+ ;; Text creation and manipulation
+ "auctex" "combine" "diffutils" "gawk" "grep" "m4"
+ "orgadoc" "sed" "wdiff"
+ ;; Version control
+ "rcs" "vc-dwim"
+ ;; Web authoring
+ "emacs-muse") .
+ "https://www.gnu.org/software/%m/manual/html_node/%e")
+ ;; GNU software manuals where the path doesn't contain html_node
+ (( ;; Security
+ "gnu-crypto"
+ ;; Software development
+ "autoconf-archive" "dejagnu" "indent"
+ ;; Version control
+ "cssc") .
+ "https://www.gnu.org/software/%m/manual/%e")
+ ;; GNU software manuals where manuals in other languages than
+ ;; English exists
+ (("fisicalab"
+ ;; Graphics
+ "plotutils") .
+ "https://www.gnu.org/software/%m/manual/en/%m/%e")
+ ;; Various misc documentation for coding standards and maintainer
+ ;; manuals
+ (("standards" "maintain" ) .
+ "https://www.gnu.org/prep/%m/html_node/%e")
+ ;; GNU software where the exact address differs to the other above
+ ;; e.g. because the websites are hosted on a different server
+ (("mailutils" ) . "https://mailutils.org/manual/html_node/%e")
+ (;; Mathematics
+ ("gmplib") . "https://gmplib.org/manual/%e")
+ (("jacal") . "https://people.csail.mit.edu/jaffer/jacal/%e")
+ (("octave") . "https://docs.octave.org/latest/%e")
+ ((;; Dictionaries
+ "dico"
+ ;; Software development
+ "pies"
+ ;; System administration
+ "direvent") .
+ "https://www.gnu.org.ua/software/%m/manual/%e")
+ ;; GnuDOS
+ (("gnudos" "mino" "prime") .
+ "https://www.gnu.org/software/gnudos/%m/html_node/%e")
+ ;; Security
+ (;; Manuals hosted on gnupg.org
+ ("asuan" "dirmngr" "gcrypt" "gnupg" "gpgme" "ksba") .
+ "https://www.gnupg.org/documentation/manuals/%m/%e")
+ ;; Software development
+ (;; Manuals hosted on sourceware.org
+ ;; binutils
+ ("as" "bfd" "binutils" "gprof" "grofng" "ld") .
+ "https://sourceware.org/binutils/docs/%m/%e")
+ ;; gdb
+ (("gdb" "stabs") .
+ "https://sourceware.org/gdb/current/onlinedocs/%m/%e")
+ (;; GCC and related
+ ("cpp" "cppinternals" "gcc" "gccint" "gfc-internals" "gfortran"
+ "gnat-style" "gnat_rm" "gnat_ugn" "libgomp" "liberty"
+ "libstdc++") .
+ "https://gcc.gnu.org/onlinedoc/%m/%e")
+ ;; GForth
+ (("gforth") .
+ "https://www.complang.tuwien.ac.at/forth/gforth/Docs-html/%e")
+ (;; MIT/GNU Scheme
+ ("mit-scheme-imail" "mit-scheme-ref" "mit-scheme-sos"
+ "mit-scheme-user") .
+ "https://www.gnu.org/software/mit-scheme/documentation/stable/%m/%e")
+ (("groff") . "https://www.gnu.org/software/groff/manual/groff.html.node/%e")
+ (("reftex") . "https://www.gnu.org/software/auctex/manual/reftex/%e")
+ ((;; Manuals hosted at Jaffer
+ "scm" "slib" "wb") .
+ "https://people.csail.mit.edu/jaffer/%m/%e")
+ (;; GNU Pascal
+ ("gpc") . "https://www.gnu-pascal.de/%m/%e")
+ ;; Software libraries
+ (("libavl") . "https://adtinfo.org/libavl.html/%e")
+ (("gnutls") . "https://www.gnutls.org/manual/html_node/%e")
+ (("guixwl") . "https://guixwl.org/manual/html_node/%e")
+ ;; Specific cases where the manual is only provided online
+ ;; in a single package document with various paths.
+ (("emms") .
+ (lambda (manual-name node-name _url-encoded-node-name)
+ ;; One page manual index#<node-name>
+ (format "https://www.gnu.org/software/%s/manual/index#%s"
+ manual-name (string-replace "\s" "-" node-name))))
+ ((;; Editors
+ "moe"
+ ;; System administration
+ "ddrescue"
+ ;; Text creation and manipulation
+ "ed" "ocrad") .
+ (lambda (manual-name node-name _url-encoded-node-name)
+ ;; One page manual index#<node-name>
+ (format "https://www.gnu.org/software/%s/manual/%m_manual.html#%s"
+ manual-name (string-replace "\s" "-" node-name))))
+ ((;; Audio
+ "libcdio"
+ ;; Games
+ "gnubg"
+ ;; Internet applications
+ "shishi"
+ ;; Mathematics
+ "mcsim"
+ ;; Software development
+ "gengen" "gengetopt" "global"
+ ;; Software libraries
+ "libjit"
+ ;; Web authoring
+ "easejs") .
+ (lambda (manual-name node-name _url-encoded-node-name)
+ ;; One page manual manual#<node-name>
+ (format "https://www.gnu.org/software/%s/%s.html#%s"
+ manual-name manual-name (string-replace "\s" "-"
+ node-name))))
+ (;; System administration
+ ("mtools" "rottlog") .
+ (lambda (manual-name node-name _url-encoded-node-name)
+ ;; One page manual manual#<node-name>
+ (format "https://www.gnu.org/software/%s/manual/%s.html#%s"
+ manual-name manual-name (string-replace "\s" "-"
+ node-name))))
+ ((;; Software development
+ "ddd") .
+ (lambda (manual-name node-name _url-encoded-node-name)
+ ;; One page manual manual#<node-name>
+ (format "https://www.gnu.org/software/%s/manual/html_mono/%s.html#%s"
+ manual-name manual-name (string-replace "\s" "-"
+ node-name))))
+ (("hyperbole") .
+ (lambda (manual-name node-name _url-encoded-node-name)
+ ;; One page manual manual#<node-name>
+ (format "https://www.gnu.org/software/%s/man/%s.html#%s"
+ manual-name manual-name (string-replace "\s" "-"
+ node-name))))
+ (("mpfr") .
+ (lambda (manual-name node-name _url-encoded-node-name)
+ ;; One page manual manual#<node-name>
+ (format "https://www.mpfr.org/mpfr-current/mpfr.html#%s"
+ (string-replace "\s" "-" node-name))))
+ (("R-intro" "R-data" "R-admin" "R-ext" "R-lang" "R-ints") .
+ (lambda (manual-name node-name _url-encoded-node-name)
+ ;; One page manual manual#<node-name>
+ (format
+ "https://cran.r-project.org/doc/manuals/r-release/%s.html#%s"
+ manual-name (string-replace "\s" "-" node-name))))
+ ;; Software libraries
+ (("libidn2") .
+ (lambda (_manual-name node-name _url-encoded-node-name)
+ ;; One page manual manual#<node-name>
+ (format
+ "https://libidn.gitlab.io/libidn2/manual/libidn2.html#%s"
+ (string-replace "\s" "-" node-name))))
+ ;; Editors
+ (("readline") .
+ (lambda (manual-name node-name _url-encoded-node-name)
+ ;; One page manual manual#<node-name>
+ (format "https://tiswww.cwru.edu/php/chet/%s/%s.html#%s"
+ manual-name manual-name (string-replace "\s" "-"
+ node-name)))))
"Alist telling `Info-mode' where manuals are accessible online.
Each element of this list has the form (MANUALs . URL-SPEC).
@@ -251,21 +454,21 @@ Info-url-alist
The default value of this variable refers to the official,
HTTPS-accessible HTML-representations of all manuals that Emacs
-includes. These URLs refer to the most recently released version
-of Emacs, disregarding the version of the running Emacs. In
-other words, the content of your local Info node and the
+includes and some additional GNU manuals that maybe installed on your computer.
+These URLs refer to the most recently released version of the software.
+In other words, the content of your local Info node and the
associated online node may differ. The resource represented by
the generated URL may even be not found by the gnu.org server."
- :version "30.1"
+ :version "31.1"
:type '(alist
- :tag "Mapping from manual-name(s) to URL-specification"
- :key-type (choice
- (string :tag "A single manual-name")
- (repeat :tag "List of manual-names" string))
- :value-type (choice
- (string :tag "URL-specification string")
- (function
- :tag "URL-specification function"))))
+ :tag "Mapping from manual-name(s) to URL-specification"
+ :key-type (choice
+ (string :tag "A single manual-name")
+ (repeat :tag "List of manual-names" string))
+ :value-type (choice
+ (string :tag "URL-specification string")
+ (function
+ :tag "URL-specification function"))))
(defcustom Info-scroll-prefer-subnodes nil
"If non-nil, \\<Info-mode-map>\\[Info-scroll-up] in a menu visits subnodes.
--
2.45.2
--=-=-=--
Björn Bidar <bjorn.bidar@HIDDEN>:bug-gnu-emacs@HIDDEN.
Full text available.bug-gnu-emacs@HIDDEN:bug#75638; Package emacs.
Full text available.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.