bug-texinfo
[Top][All Lists]
Advanced

[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



reply via email to

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