Hi Matt, Matt <m...@excalamus.com> writes:
> ---- On Mon, 15 Apr 2024 14:58:50 +0200 pelzflorian (Florian Pelz) wrote > --- > > > Do you agree that I should commit your docs correction with @pxref? > > I believe it is an improvement over current “see @ref”, even though it > > looks different in the info reader. > > Yes, I agree and thank you for double checking. Sorry for not > answering you more clearly before! @pxref is the correct command to > use within parentheses. > > > I believe the Emacs errors are historical; looking at Emacs 29.3 as > > packaged in Guix, Emacs-Info displays xref properly as See. Display > > errors had existed, but in the past only. > > I reported it to emacs-devel (it's addressed now) and the issue isn't > technically @xrefs; it's the compilation of @xref and @ref, '*Note' > and '*note' respectively. Emacs looks at the context around these and > renders them as 'See' or 'see' according to what's nearby. The > trouble is that the Texinfo documentation intends to show '*Note' and > '*note' literally which is an exception to the Emacs logic. > > I looked it up and the related Emacs code had been there for like 18 > years...I have a knack for finding these kinds of dumb things. I > can't decide if it's a superpower or a super-curse. :) Awesome! Definitely a superpower in my book. Thanks for following it through with the Emacs folks! I'm sure I was bothered by that inconsistency before but couldn't put my finger on the culprit. -- Thanks, Maxim
