[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Texinfo command nesting and syntax checking: nested @ref
From: |
Patrice Dumas |
Subject: |
Re: Texinfo command nesting and syntax checking: nested @ref |
Date: |
Tue, 7 Feb 2023 10:36:03 +0100 |
On Fri, Feb 03, 2023 at 08:19:16PM +0000, Gavin Smith wrote:
>
> %contain_basic_inline_with_refs_commands
>
> This contains sectioning and heading commands, so that
>
> @section Changes in @ref{SubModule}
>
> is allowed. I found this mail in the archives with the rationale
> for allowing such usage:
>
> https://lists.gnu.org/archive/html/texinfo-devel/2012-03/msg00000.html
>
> It seems questionable to me, but it is allowed in the corresponding
> HTML and DocBook output.
>
> It would of course be much simpler
> to eliminate this separate class of commands and forbid @ref etc.
> inside @section and other commands. Could we consider this again?
I have not changed my mind, having refs in section names seems to be
used in some contexts for documentation writing, so I still think that
it is good to have. There was a recent case of
https://lists.gnu.org/archive/html/bug-texinfo/2022-11/msg00202.html
with a use case that was incorrect, but an expectation that refs in
section names could work.
--
Pat