Bug 262583 - sysutils/nsysctl: nsysctl(8) HISTORY implies that the utility is a feature of FreeBSD
Summary: sysutils/nsysctl: nsysctl(8) HISTORY implies that the utility is a feature of...
Status: Open
Alias: None
Product: Ports & Packages
Classification: Unclassified
Component: Individual Port(s) (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Alfonso S. Siciliano
URL: https://gitlab.com/alfix/nsysctl/-/bl...
Keywords:
Depends on:
Blocks:
 
Reported: 2022-03-16 03:29 UTC by Graham Perrin
Modified: 2022-03-20 21:37 UTC (History)
1 user (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2022-03-16 03:29:22 UTC 
From <https://www.freebsd.org/cgi/man.cgi?query=nsysctl&sektion=8&manpath=FreeBSD-Ports#HISTORY> (the page for the port): 

> The nsysctl utility first appeared in FreeBSD 13.0.

I think, the line is wrong; <https://github.com/freebsd/freebsd-src/search?q=nsysctl> and <https://www.freebsd.org/cgi/man.cgi?query=nsysctl&sektion=8&manpath=FreeBSD+14.0-current> find nothing. 

It's a neat utility :-) however as far as I can tell, it is not integral to the operating system.
Comment 1 Bugzilla Automation freebsd_committer freebsd_triage 2022-03-16 03:29:22 UTC 
Maintainer informed via mail
Comment 2 Fernando Apesteguía freebsd_committer freebsd_triage 2022-03-17 08:44:57 UTC 
^Triage: assigning to maintainer, that is an src committer.
Comment 3 Alfonso S. Siciliano freebsd_committer freebsd_triage 2022-03-17 16:10:34 UTC 
Hi Graham and thank you for the report,

> The nsysctl utility first appeared in FreeBSD 13.0.

It is right

----
The link https://github.com/freebsd/freebsd-src/search?q=nsysctl finds nothing: it is correct.

Please note "freebsd-src" in the url, it is the BASE repository, nsysctl is in the PORTS repository. So the right link is:
https://github.com/freebsd/freebsd-ports/search?q=nsysctl

---
The link https://www.freebsd.org/cgi/man.cgi?query=nsysctl&sektion=8&manpath=FreeBSD+14.0-current finds nothing: it is correct.

Please note "FreeBSD+14.0-current" in the url, it is only for manuals in BASE.

You could select [*]"FreeBSD 13.0 RELEASE and Ports" in the vertical menu, the right link is:
https://www.freebsd.org/cgi/man.cgi?query=nsysctl&manpath=FreeBSD+13.0-RELEASE+and+Ports

[*] or "FreeBSD ports r13" in the vertical menu:
https://www.freebsd.org/cgi/man.cgi?query=nsysctl&manpath=FreeBSD+Ports+13.0
Comment 4 Alfonso S. Siciliano freebsd_committer freebsd_triage 2022-03-17 16:16:48 UTC 
In conclusion, man.freebsd.org shows only the manuals in BASE for the CURRENT version so for nsysctl we have to select "version 13" from the vertical menu.
Comment 5 Fernando Apesteguía freebsd_committer freebsd_triage 2022-03-17 16:25:01 UTC 
(In reply to Alfonso S. Siciliano from comment #4)
Hi Alfonso,

There is something I don't understand. When I see something like "foo first appeared in FreeBSD 13.0" I expect to install a FreeBSD 13.0 and have that foo.

However:

fernape@beastie:~$ uname -a
FreeBSD beastie 13.0-RELEASE-p4 FreeBSD 13.0-RELEASE-p4 #0: Tue Aug 24 07:33:27 UTC 2021     root@amd64-builder.daemonology.net:/usr/obj/usr/src/amd64.amd64/sys/GENERIC  amd64
fernape@beastie:~$ whereis nsysctl
nsysctl: /usr/ports/sysutils/nsysctl

It only exists as a port. It is not _in_ FreeBSD. I don't know if I'm misinterpreting that sentence.
Comment 6 Alfonso S. Siciliano freebsd_committer freebsd_triage 2022-03-17 17:22:13 UTC 
(In reply to Fernando Apesteguía from comment #5)

> When I see something like "foo first appeared in FreeBSD 13.0"
> I expect to install a FreeBSD 13.0 and have that foo.

Ok, probably I have now understood the problem.

I'm thinking about 2 possible solutions:
 * delete HISTORY
 * change HISTORY: "The nsysctl utility first appeared as port in FreeBSD 13.0."

Of course I' ll fix the manual in the next version.
Comment 7 Fernando Apesteguía freebsd_committer freebsd_triage 2022-03-18 07:03:43 UTC 
(In reply to Alfonso S. Siciliano from comment #6)

Although it is clearer, the thing is that base and ports are not related. The same port tree snapshot is now being used in 13.0, 12.2... so the correlation between FreeBSD releases and new ports is not clear. But it is up to you :-)