Re: Website - Missing kstat man page
On 3 January 2021 15:25:13 CET, Ingo Schwarze wrote: >Hi, > >Daniel Jakots wrote on Sat, Jan 02, 2021 at 11:19:07PM -0500: >> On Sat, 2 Jan 2021 22:57:06 -0500, 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. Indeed, pamela@ and me discussed this problem when she started to maintain plus.html. We figured it's best to have the dead link that's likely to appear at one point because nobody is going to remember to wander in and add links later. > >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 -- Sent from a mobile device. Please excuse poor formating.
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, 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
Re: Website - Missing kstat man page
On Sat, 2 Jan 2021 22:57:06 -0500, tiredtech 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. > > Regards > 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. 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 Cheers, Daniel
Website - Missing kstat man page
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. Regards
