Re: [RFC PATCH 2/2] irqtop: add filter support

Op 07-03-2025 om 03:52 schreef Joe Jin:
> --- a/sys-utils/irqtop.1.adoc
> +++ b/sys-utils/irqtop.1.adoc
> @@ -12,7 +12,7 @@ irqtop - utility to display kernel interrupt information
>   
>   == SYNOPSIS
>   
> -*irqtop* [options]
> +*irqtop* [options]... [IRQ] [PATTERN] ...

Oh -- I failed to notice that this change is for the man page,
not for the usage help text.

In a man page, the convention is to put placeholder words in
lowercase italics.  That is: mark them with underscores:

   *irqtop* [options] [_irq_] [_pattern_] ...

If, however, it is possible to specify multiple irq numbers and
irq names, and one can mix them, then I would write:

   *irqtop* [options] [_irq_|_pattern_]...


> +Displays interrupt counter information only for the specified _IRQ_ or for irqnames matching _PATTERN_ when given.

Here, lowercase the underscored words, and "irq names" is better
as two separate words.


Benno

-----BEGIN PGP SIGNATURE-----

wsF5BAABCAAjFiEEFo5vQpe/16ea/USWUUu+Lrjhlh8FAmfNffQFAwAAAAAACgkQUUu+Lrjhlh+M
KA//QKvL95/uyyzNokRopHCcqid6s+YCNWPv4HGoXKYursDOGtmPMmLqNyEq4ZiRAFlAzCbLtgck
PhF5GjV9EySfU100Iu6znEp6sHYg7runqIkwGMCcT/U2vf94Y+Jqji1Agqfi84uGQZO+DzfJycKT
8FTBZUvzS+0wWsE8E1uz2d8u/eeLgy600CCjKTXY2w7AtNfL3VWmox+uuNm+ik3YmUOAiIesYxvJ
PdJNmxl+64YtGgoFa90f4KKjSQrnQ7KB2GRO/KafULbPbGpUuxD2chu0iLfqqcItZXCj9E4YzPx1
HH/zmXPjmE/f7P+pzRFOk0DmVhSQluIgv65GzBB+CyPW4xfoXI3WlAo2+5aJDd19BJpaA3eMXPYP
93xywzeUZM6J/vsPHqG9smkmWxifPm1mBEvjEBLBNJiInD7wFmFupUKT5KqvfrX3qn0yFEeIPh1Q
TiUmK785DKw2qWbGqENH4gK/+WGA3r1hpiUV35EVDVDeK7jGBpF282iHM620trTKzObhTH+tPhA8
ysNxTZn4Ci9KgRwUjqKRao141UBZSr3VkE3qLNJYY3N1QAKXdYqPBxabzoT7Vz+Rq5gctzd7oa2I
D+416K+EhYWHXJ+D/Xt6aMIxjnoukvcJMUQlhPTIpfnjYHoQf1jEYzRtcv0TQdmxD3R/c0SpzQO1
r7k=
=rsTr
-----END PGP SIGNATURE-----