Hi Caspar,

Caspar Schutijser wrote on Wed, Sep 06, 2023 at 01:46:45PM +0200:

> The patch below marks up "NO_ARCH" consistently with the other
> variables. I noticed because on man.openbsd.org, NO_ARCH looks off
> compared to the others:
> https://man.openbsd.org/bsd.port.mk.5#MULTI_PACKAGES

Indeed, keeping markup correct and consistent is worthwhile.

Incorrect markup not only prevents consistent formatting across all
output devices but also harms search functionality.

For example, none of these currently works as expected:

 - typing ":t NO_ARCH" while in "man bsd.port.mk"
 - man -O tag=NO_ARCH bsd.port.mk
 - man -k Ev=NO_ARCH
 - man -k any=NO_ARCH
 - https://man.openbsd.org/bsd.port.mk#NO_ARCH

> Comments or OKs?

OK schwarze@
  Ingo

> Index: bsd.port.mk.5
> ===================================================================
> RCS file: /cvs/src/share/man/man5/bsd.port.mk.5,v
> retrieving revision 1.604
> diff -u -p -r1.604 bsd.port.mk.5
> --- bsd.port.mk.5     5 Sep 2023 23:45:53 -0000       1.604
> +++ bsd.port.mk.5     6 Sep 2023 11:44:22 -0000
> @@ -2447,7 +2447,7 @@ below.
>  Especially read the part about
>  .Ev ONLY_FOR_ARCHS
>  when some of the packages only exist for some architectures.
> -.It NO_ARCH
> +.It Ev NO_ARCH
>  Location for arch-independent packages.
>  Defaults to
>  .Sq no-arch .
> 

Reply via email to