lkml.org 
[lkml]   [2012]   [Aug]   [19]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
From
SubjectRe: awful kconfig help texts.
Date
>How about the patch below?

>[...]
>+ Generic Pulse-Width Modulation (PWM) support.
>+
>+ In Pulse-Width Modulation, a variation of the width of pulses
>+ in a rectangular pulse signal is used as a means to alter the
>+ average power of the signal. Applications include efficient
>+ power delivery and voltage regulation. In computer systems,
>+ PWMs are commonly used to control fans or the brightness of
>+ display backlights.
>+
>+ This framework provides a generic interface to PWM devices
>+ within the Linux kernel. On the driver side it provides an API
>+ to register and unregister a PWM chip, an abstraction of a PWM
>+ controller, that supports one or more PWM devices. Client
>+ drivers can request PWM devices and use the generic framework
>+ to configure as well as enable and disable them.
>+
>+ The new generic framework replaces the legacy PWM framework
>+ which allows only a single driver implementing the required
>+ API. Not all legacy implementations have been ported to the
>+ new framework yet. The new framework provides an API that is
>+ backward compatible with the legacy framework so that existing
>+ client drivers continue to work as expected.

Instead of writing "[Tt]he new framework", write "[Tt]his framework". In 4
years, this will no longer be so new. And when the next framework comes
along, this will look like it is referencing the new one instead of itself.




\
 
 \ /
  Last update: 2012-08-20 05:21    [W:0.071 / U:3.760 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site