Re: [PATCH 1/2] docs: Use @pxref instead of @xref inside parenthesis

2023-08-21 Thread Glenn Washburn
On Sat, 19 Aug 2023 20:57:45 -0500 Oskari Pirhonen wrote: > On Sat, Aug 19, 2023 at 01:25:16 -0500, Glenn Washburn wrote: > > The @xref command is meant to be used at the beginning of a sentence > > because its expansion creates a "See " prefix. The @pxref expands with > > a prefix of "see " and

Re: [PATCH 1/2] docs: Use @pxref instead of @xref inside parenthesis

2023-08-19 Thread Oskari Pirhonen
On Sat, Aug 19, 2023 at 01:25:16 -0500, Glenn Washburn wrote: > The @xref command is meant to be used at the beginning of a sentence > because its expansion creates a "See " prefix. The @pxref expands with > a prefix of "see " and is meant to be used within parenthesis. This also > fixes an issue w

[PATCH 1/2] docs: Use @pxref instead of @xref inside parenthesis

2023-08-18 Thread Glenn Washburn
The @xref command is meant to be used at the beginning of a sentence because its expansion creates a "See " prefix. The @pxref expands with a prefix of "see " and is meant to be used within parenthesis. This also fixes an issue where there was a repeated "see" in the output. Reported-by: Olaf Heri