---- On Tue, 16 Apr 2024 08:43:23 +0200 pelzflorian (Florian Pelz) wrote ---
> Hi Matt. When triple checking, I read in “info "(texinfo)@pxref"”:
>
> In past versions of Texinfo, it was not allowed to write punctuation
> after a '@pxref', so it could be used _only_ before a right parenthesis.
> This is no longer the case. The effect of '@pxref{NODE-NAME}' is
> similar to that of 'see @ref{NODE-NAME}'. However, in many circumstance
> the latter is preferrable, as this makes it clear in the Info output
> that the word "see" should be present.
>
> Because of this last sentence, my tendency would now be to use @pxref
> only for parentheses. (Texinfo is really confusing.) Should I just cut
> these changes:
>
> (Linux Services): Use @pxref to start phrase.
> (Configuring the Shell): Use @pxref to start phrase.
Yes, I agree that cutting those, and using the original "see @ref{}", is what
the Texinfo manual says is correct. We should also cut this change:
(Setting Up the Daemon): use @xref to start sentence.
The original was also correct.
The only change that should remain is:
(Build Systems): capitalize "python" and start parenthesized reference with
@pxref.
Thanks for checking that. I had it wrong and I learned something!
