mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: Satoru Takeuchi <takeuchi_satoru@jp.fujitsu.com>
To: Linux Kernel <linux-kernel@vger.kernel.org>
Cc: Thomas Gleixner <tglx@linutronix.de>, Ingo Molnar <mingo@elte.hu>
Subject: [PATCH] fix hrtimers documentation
Date: Fri, 27 Apr 2007 13:39:14 +0900	[thread overview]
Message-ID: <877irysa6l.wl%takeuchi_satoru@jp.fujitsu.com> (raw)

Fix hrtimers documentation.

- The word `patch' is used to indicate hrtimers subsystem implementation.
  However this subsystem has already been in ustream kernel, so convert
  them into appropriate phrases.
- Some minor cleanups.

Signed-off-by: Satoru Takeuchi <takeuchi_satoru@jp.fujitsu.com>

Index: linux-2.6.21/Documentation/hrtimers/hrtimers.txt
===================================================================
--- linux-2.6.21.orig/Documentation/hrtimers/hrtimers.txt	2007-04-27 12:45:56.000000000 +0900
+++ linux-2.6.21/Documentation/hrtimers/hrtimers.txt	2007-04-27 13:24:22.000000000 +0900
@@ -1,8 +1,9 @@
 
 hrtimers - subsystem for high-resolution kernel timers
-----------------------------------------------------
+------------------------------------------------------
 
-This patch introduces a new subsystem for high-resolution kernel timers.
+This document describes hrtimers, a new subsystem for high-resolution
+kernel timers.
 
 One might ask the question: we already have a timer subsystem
 (kernel/timers.c), why do we need two timer subsystems? After a lot of
@@ -78,7 +79,7 @@ from 250 Hz to 100 HZ (or even smaller).
 hrtimer subsystem implementation details
 ----------------------------------------
 
-the basic design considerations were:
+The basic design considerations were:
 
 - simplicity
 
@@ -87,7 +88,7 @@ the basic design considerations were:
 
 - simplification of existing, timing related kernel code
 
-another basic requirement was the immediate enqueueing and ordering of
+Another basic requirement was the immediate enqueueing and ordering of
 timers at activation time. After looking at several possible solutions
 such as radix trees and hashes, we chose the red black tree as the basic
 data structure. Rbtrees are available as a library in the kernel and are
@@ -138,23 +139,22 @@ details.)
 hrtimers - rounding of timer values
 -----------------------------------
 
-the hrtimer code will round timer events to lower-resolution clocks
+The hrtimer code will round timer events to lower-resolution clocks
 because it has to. Otherwise it will do no artificial rounding at all.
 
-one question is, what resolution value should be returned to the user by
+One question is, what resolution value should be returned to the user by
 the clock_getres() interface. This will return whatever real resolution
 a given clock has - be it low-res, high-res, or artificially-low-res.
 
 hrtimers - testing and verification
-----------------------------------
+-----------------------------------
 
-We used the high-resolution clock subsystem ontop of hrtimers to verify
+We used the high-resolution clock subsystem on top of hrtimers to verify
 the hrtimer implementation details in praxis, and we also ran the posix
 timer tests in order to ensure specification compliance. We also ran
 tests on low-resolution clocks.
 
-The hrtimer patch converts the following kernel functionality to use
-hrtimers:
+hrtimers converts the following kernel functionality to use it:
 
  - nanosleep
  - itimers

                 reply	other threads:[~2007-04-27  4:41 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=877irysa6l.wl%takeuchi_satoru@jp.fujitsu.com \
    --to=takeuchi_satoru@jp.fujitsu.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mingo@elte.hu \
    --cc=tglx@linutronix.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®