From: "Anthony J. Bentley" <bentley@openbsd.org>
Subject: Re: flex.1: discontinue misuse of Aq macro
To: Evan Silberman <evan@jklol.net>
Cc: tech@openbsd.org
Date: Thu, 22 May 2025 01:31:31 -0600

Evan Silberman writes:
> quoth mdoc(7):
>
> 	Since Aq usually renders with non-ASCII characters in non-ASCII
> 	output modes, do not use it where the ASCII characters '<' and
> 	'>' are required as syntax elements.
>
> Thus this patch.

Thanks, I have committed this except one piece, see below.

>  will only be active when the scanner is in the start condition named
> -.Qq sc .
> +.Qq <sc> .

Adding <> here changes the text and is incorrect.

>  But the
> -.Sq Aq s ,
> +.Sq <s> ,
>  .Sq / ,
>  and
> -.Aq Aq EOF
> +.Sq <<EOF>>
>  operators cannot be used in a
>  .Nm
>  definition.

Adding '' to <<EOF>> here changes the text, but is correct, so I left it in.