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

Reply via email to