Re: [PATCH] time: Improve documentation of timekeeeping_adjust()

From: John Stultz
Date: Fri Oct 28 2011 - 03:02:33 EST


On Fri, 2011-10-28 at 08:05 +0200, Richard Cochran wrote:
> On Thu, Oct 27, 2011 at 06:12:42PM -0700, John Stultz wrote:
> > diff --git a/kernel/time/timekeeping.c b/kernel/time/timekeeping.c
> > index a5846a8..de8737e 100644
> > --- a/kernel/time/timekeeping.c
> > +++ b/kernel/time/timekeeping.c
> > @@ -802,14 +802,44 @@ static void timekeeping_adjust(s64 offset)
> > s64 error, interval = timekeeper.cycle_interval;
> > int adj;
> >
> > + /*
> > + * The point of this is to check if the error is greater then half
> > + * an interval.
> > + *
> > + * First we shift it down from NTP_SHIFT to clocksource->shifted nsecs.
> > + *
> > + * Note we subtract one in the shift, so that error is really error*2.
> > + * This "saves" dividing(shifting) intererval twice, but keeps the
> > + * (error > interval) comparision as still measuring if error is
> > + * larger then half an interval.
> > + *
> > + * Note: It does not "save" on aggrivation when reading the code.
>
> ... or on "aggravation" either :)

Sigh. I do need to start using an editor with built in spell checking.
I'm so poor of a speller (and a typist) its really amazing its not
worse.

Thanks for catching that.
-john


--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/