From 435d453b63d42d5b22244dc1f4e7764f4b8d9e1c Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Thu, 13 Oct 2022 11:57:09 +0100 Subject: [PATCH] lsof.adoc: correction and suggestions The manual page for lsof is in section 8, not 1. The + for a hard line break was superfluous, where the next line was blank. aims to raise awareness of macros such as package and man. Whilst the Link URL within this report is not part of a long sentence, the markup in this pull request might be good in the context of . Whilst here, a handful of suggested changes. --- 2022q3/lsof.adoc | 27 ++++++++++++--------------- 1 file changed, 12 insertions(+), 15 deletions(-) diff --git a/2022q3/lsof.adoc b/2022q3/lsof.adoc index d21ae2a1..13fdeaf5 100644 --- a/2022q3/lsof.adoc +++ b/2022q3/lsof.adoc @@ -1,22 +1,19 @@ === sysutils/lsof major upgrade -Links -link:https://github.com/lsof-org/lsof[lsof project repo] URL: link:https://github.com/lsof-org/lsof[https://github.com/lsof-org/lsof] + +Link: + +lsof project repo: -Contact: Larry Rosenman +Contact: + +Larry Rosenman -sysutils/lsof in ports has had a major upgrade to no longer go looking -in /dev/kmem for data and using the userland API. This has taken a long -time to hit the tree, but is finally done. This fixes lsof(1) to work with -ZFS again for the first time since 13.0-RELEASE. +pacakge:sysutils/lsof[] had a major upgrade to no longer look in `/dev/kmem` for data, and to use the userland API. +This took a long time to hit the tree, but is finally done. +It fixes man:lsof[8] to work with ZFS again for the first time since 13.0-RELEASE. -This will make the maintenance of sysutils/lsof much easier going forward. +This will make maintenance much easier going forward. -To the kernel folks: if you make changes that break lsof, please submit a -github PR to https://github.com/lsof-org/lsof. Please test any changes to -the interfaces that lsof uses and make sure they still work. These all should -be userland interfaces now, but please test. - -My thanks to Warner Losh , Mateusz Guzik , -and Ed Maste for help getting this major change landed. +To the kernel folks: if you make changes that break lsof, please submit a GitHub pull request to https://github.com/lsof-org/lsof. +Please test any changes to the interfaces that lsof uses and make sure they still work. +These all should be userland interfaces now, but please test. +My thanks to Warner Losh , Mateusz Guzik , and Ed Maste for help getting this major change landed.