GNU bug report logs - #68970
30.0.50; Info.el: Info-url-alist should support format-sequence that encodes "Top" node as "index"

Previous Next

Full log

View this message in rfc822 format

From: Mekeor Melire <mekeor <at> posteo.de>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 68970 <at> debbugs.gnu.org
Subject: bug#68970: 30.0.50; Info.el: Info-url-alist should support format-sequence that encodes "Top" node as "index"
Date: Wed, 07 Feb 2024 19:52:15 +0000

2024-02-07 16:51 eliz <at> gnu.org:

> Sorry, I don't think I understand: "https://example.com/" stands for
> "https://example.com/index.html", AFAIK.  This is why %e produces an
> empty string for the Top node.  So why would users want to specify
> "https://example.com/%e.html" instead of just "https://example.com/%e"?
>
> IOW, I don't see why users will need to use the .html extension in the
> alist, it works without the extension.
>
> What am I missing?

Let's assume we have a manual with "Top" node as well as a node called
"Foo". Let's further assume the webserver is configured so that
example.com/Foo does not resolve to example.com/Foo.html but rather
results in "not found". This is why the user must choose to use
example.com/%e.html as URL-specification currently. But then they have
the problem that the "Top" node is translated to example.com/.html.

I suggested to add another format-sequence, %i, that translates the
"Top" node as "index". Thus, example.com/%i.html would translate to
example.com/index.html in case of "Top".

We could also instead provide a format-sequence, %s, that includes the
".html" suffix -- except in case of the "Top" node which would be
translated to the empty string. Thus, the user would use example.com/%s.
"Foo" would be translated to example.com/Foo.html; and "Top" would be
translated to "example.com/".

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.