Sunday, January 03, 2021

Re: Website - Missing kstat man page

Hi,

Daniel Jakots wrote on Sat, Jan 02, 2021 at 11:19:07PM -0500:
> On Sat, 2 Jan 2021 22:57:06 -0500, <tiredtech@gmail.com> wrote:

>> I came across a broken link during some pre-install research.
>>
>> While browsing URL https://www.openbsd.org/68.html,
>> I noticed URL link on the webpage for kstat(1) generates
>> a "No results found." message when pointing to its man page:
>>
>> https://man.openbsd.org/kstat
>>
>> Flagged as new, so I was curious about its general function.

> It looks like kstat isn't linked to the build so it's not built by
> default, therefore it's not present on the man.o.o server.

Correct. To explain why the link is not live yet, i added a sentence

The userland utility is not yet installed by default.

to the 68.html page.

I guess already having the link even though it is still dead is
intentional such that it springs to life as soon as the kstat(1) utility
will be installed by default. Otherwise, we would be likely to forget
as release pages from the past are not very actively maintained.

Yours,
Ingo


> The source is in src/usr.bin/kstat. If you don't have any src tree
> around, you can either read it on github [1] or you can fetch the raw
> version [2] and give it to mandoc(1)
>
> [1]: https://github.com/openbsd/src/blob/a09091e54b85e8cd86ccf4763998e3800065d5dc/usr.bin/kstat/kstat.1
> [2]: https://raw.githubusercontent.com/openbsd/src/a09091e54b85e8cd86ccf4763998e3800065d5dc/usr.bin/kstat/kstat.1
>
> (I could copy paste the resulting man page in this email, but you'd lose
> all the fancy markup :))
>
> Actually, mandoc(1) supports html output, here's what it gives
> https://static.chown.me/private/misc/kstat.html

No comments:

Post a Comment