[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').