This isn't as helpful a bug report as I would have liked.  I tried
understanding this problem, but for reasons I cannot quite grasp yet it
was too hard for me.

My understanding is that old versions of texinfo produce the warning

`.' or `,' must follow \@xref, not %s

when an @xref is followed, after its argument, by a space and then an
alphabetic character.

It appears this behavior was changed to permit ordinary text to follow
an @xref directly, without punctuation.

I'm an occasional Emacs developer and Emacs uses a wide variety of build
toolchains.  Some of them are old enough to produce the warning, but
some of them aren't.

Ideally, we would like to re-enable this warning when running new
versions of texinfo, so we can be sure not to break old builds, but I
haven't found a way to do so.

I understand the decision to drop the warning was deliberate, but
wouldn't it be possible to make it an optional warning, disabled by
default?  The warning could indicate which version of texinfo stopped
warning about this by default and when it was released, so there would
be an incentive to disable the option at a future point.

While I have written an Emacs Lisp program to find such situations, I
think it would be much better to rely on standard texinfo to provide
warnings in this case.

I'm open to other suggestions for how to avoid this problem.  There was
some confusion about whether this was a warning or an error, and whether
it was "build-breaking", but that's possibly not relevant.

Thanks for reading
Pip Cet


  • Cross-ref... Pip Cet via Bug reports for the GNU Texinfo documentation system
    • Re: ... Gavin Smith
      • ... Pip Cet via Bug reports for the GNU Texinfo documentation system
        • ... Gavin Smith
      • ... Eli Zaretskii
        • ... Gavin Smith
          • ... Eli Zaretskii
        • ... Patrice Dumas
          • ... Gavin Smith
          • ... Patrice Dumas
    • Re: ... Patrice Dumas

Reply via email to