Re: [PATCH v2 10/10] Revise the documentation of simple calendar time.

[Paul Eggert <eggert at cs dot ucla dot edu>]

> > This function uses a clock close to the clocks of @w{@samp{clock_gettime
> > (CLOCK_REALTIME)}} and of @code{gettimeofday} (see below), but the three clocks
> > are not necessarily in lock-step, and precise timestamp comparison is reliable
> > only when timestamps come from the same clock.

> I think it's good to add a cautionary note *like  this, but I'm
> worried that your suggested text might confuse readers into thinking
> that these clocks might use different epochs or could be set
> independently.  I'll think about how to put it better.

Yes, the wording "close to" was my attempt to prevent that conclusion. 
The wording could be expanded -- though when I tried to expand it 
myself, I found that the expansion was not clearer enough to be worth 
the extra words.