On 2026-02-22 09:06, Ihor Radchenko wrote:
> Applied, onto main, after amending the ORG-NEWS. I moved the headings
> under Version 10.0.
> https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=8e2c28d1b

Thanks!  I’ve rebased my other WIPs to match.

> I am not sure about this one.

Yeah ignore that patch, it avoids the problem instead of fixing it.

> Honestly, this texinfo warning looks like Texinfo bug.
> Why is it not allowed to have commas in heading? That makes no sense
> from user perspective.

I think you might be right about it being a Texinfo bug or limitation.
Org seems to correctly escape the commas in the ‘.texi’ file, e.g,

  # file.org
  * Heading, Test

  # > file.texi
  @node Heading@comma{} Test
  @chapter Heading@comma{} Test

but ‘makeinfo’ is still not happy:

  > makeinfo file.texi
  file.texi:31: warning: @node name should not contain `,': Heading, Test

  # file.info
  File: test.info,  Node: Heading, Test,  Prev: Top,  Up: Top

According to the [info file spec], nodes use commas as separators and
I guess some escaping isn’t being done:

> Node names containing periods, commas, colons or parentheses can
> confuse Info readers. If it is necessary to refer to a node whose
> name contains any of these, the <nodename> should be surrounded by a
> pair of DEL characters (‘CTRL-?’, character number 127). makeinfo
> adds these characters when needed in the default case. Note that not
> all Info readers recognize this syntax. See Info Node Names
> Constraints.

[info file spec]
<https://www.gnu.org/software/texinfo/manual/texinfo/html_node/Info-Format-Regular-Nodes.html>

-- 
Jacob S. Gordon
[email protected]
Please don’t send me HTML emails or MS Office/Apple iWork documents.
https://useplaintext.email/#etiquette
https://www.fsf.org/campaigns/opendocument

Reply via email to