emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: [External] : Re: Should Info-url-for-node support more than just "el


From: Drew Adams
Subject: RE: [External] : Re: Should Info-url-for-node support more than just "elisp" and "emacs" manuals?
Date: Wed, 29 Nov 2023 19:03:04 +0000

> https://urldefense.com/v3/__https://git.sv.gnu.org/cgit/emacs.git/tre
> e/lisp/info.el?h=7a5c91a2831602c3cd961158cf0b6a876852d7ac*n1806__;Iw!!ACWV
> 5N9M2RV99hQ!IoNpj_y2U6WUgX5Uy6rfbeaQohk_4vKgPazP62lX_hYvzNzdQwOWtpzOudmiSC
> ecJTj4iZZIsZZbFFWo$

Is this what you're looking for?

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/HTML-Xref-Node-Name-Expansion.html

I'm the one who provided `Info-goto-node-web' to Emacs.
In my info+.el code I have this comment:

;; See https://www.gnu.org/software/texinfo/manual/texinfo/html_node/
;;             HTML-Xref-Node-Name-Expansion.html
;;
;; 1. The standard ASCII letters (a-z and A-Z) are not modified. All
;;    other characters may be changed as specified below.
;;
;; 2. The standard ASCII numbers (0-9) are not modified except when a
;;    number is the first character of the node name. In that case, see
;;    below.
;;
;; 3. Multiple consecutive space, tab and newline characters are
;;    transformed into just one space. (It's not possible to have
;;    newlines in node names with the current implementation, but we
;;    specify it anyway, just in case.)
;;
;; 4. Leading and trailing spaces are removed.
;;
;; 5. After the above has been applied, each remaining space character is
;;    converted into a '-' character.
;;
;; 6. Other ASCII 7-bit characters are transformed into '_00xx', where xx
;;    is the ASCII character code in (lowercase) hexadecimal. This includes
;;    '_', which is mapped to '_005f'.
;;
;; 7. If the node name does not begin with a letter, the literal string
;;    'g_t' is prefixed to the result. (Due to the rules above, that
;;    string can never occur otherwise; it is an arbitrary choice,
;;    standing for "GNU Texinfo".) This is necessary because XHTML
;;    requires that identifiers begin with a letter.

I agree that allowing for more manuals would be
good.  Users should be able to use (MANUAL)NODE
to specify a MANUAL other than emacs and elisp. 

We should also have a defcustom for the list of
manuals they want to be able to choose from.  Its
default value should include all manuals currently
installed.
___

BTW, I just submitted bug #67531 for vanilla
Emacs `Info-goto-web'.  If you try to enter, say,
`(emacs)Glossary' or `(elisp)Records' you get an
error saying that only manuals Emacs and Elisp
are supported.  You apparently can't get to nodes
on the web that way - and the error message is no
good.  Apparently you're required to enter a bare
node name, not the usual (MANUAL)NODE alternative
accepted by `Info-goto-node' (bound to `g').



reply via email to

[Prev in Thread] Current Thread [Next in Thread]