Re: CVS commit: src/sys/kern

[Taylor R Campbell <campbell+netbsd-source-changes-d%mumble.net@localhost>]

> Date: Fri, 28 Jul 2023 23:40:40 +0900
> From: Izumi Tsutsui <tsutsui%ceres.dti.ne.jp@localhost>
> 
> > Module Name:	src
> > Committed By:	riastradh
> > Date:		Fri Jul 28 10:37:28 UTC 2023
> > 
> > Modified Files:
> > 	src/sys/kern: kern_tc.c
> > 
> > Log Message:
> > timecounter(9): Link to phk's timecounter paper for reference.
> 
> Maybe it's better to refer our timecounter(9) man page?
> https://man.netbsd.org/timecounter.9

That's fine to add, but the man page is about the interface, not about
the algorithm.  The paper is a critical reference for obscure details
of the algorithm that are not obvious from the interface.

The man page should perhaps also mention more of the API contract,
like the relation between tc_frequency, tc_counter_mask, and hz.

> (that refers http://phk.freebsd.dk/pubs/timecounter.pdf though)

No opinion on which URL to use as long as it goes to the right paper
(and preferably https).