diff options
author | Geert Uytterhoeven <geert+renesas@glider.be> | 2014-04-22 09:11:41 -0400 |
---|---|---|
committer | Mike Turquette <mturquette@linaro.org> | 2014-05-12 20:08:33 -0400 |
commit | 725b418b43d2ddcb94b413cd25c74c1175d1c5f0 (patch) | |
tree | 2703dcef719fb2273d42260fda3ce684f8dbca1f | |
parent | e07b2b59c98b79a116254ce61afa76d4702ea6c5 (diff) |
clk: Fixup spacing in comments
- Remove spaces in front of TABs,
- Correct indentation for some CLK_* flag descriptions.
Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
Signed-off-by: Mike Turquette <mturquette@linaro.org>
-rw-r--r-- | include/linux/clk-provider.h | 88 |
1 files changed, 44 insertions, 44 deletions
diff --git a/include/linux/clk-provider.h b/include/linux/clk-provider.h index 59e2eb58f555..397f98505bd4 100644 --- a/include/linux/clk-provider.h +++ b/include/linux/clk-provider.h | |||
@@ -40,14 +40,14 @@ struct dentry; | |||
40 | * through the clk_* api. | 40 | * through the clk_* api. |
41 | * | 41 | * |
42 | * @prepare: Prepare the clock for enabling. This must not return until | 42 | * @prepare: Prepare the clock for enabling. This must not return until |
43 | * the clock is fully prepared, and it's safe to call clk_enable. | 43 | * the clock is fully prepared, and it's safe to call clk_enable. |
44 | * This callback is intended to allow clock implementations to | 44 | * This callback is intended to allow clock implementations to |
45 | * do any initialisation that may sleep. Called with | 45 | * do any initialisation that may sleep. Called with |
46 | * prepare_lock held. | 46 | * prepare_lock held. |
47 | * | 47 | * |
48 | * @unprepare: Release the clock from its prepared state. This will typically | 48 | * @unprepare: Release the clock from its prepared state. This will typically |
49 | * undo any work done in the @prepare callback. Called with | 49 | * undo any work done in the @prepare callback. Called with |
50 | * prepare_lock held. | 50 | * prepare_lock held. |
51 | * | 51 | * |
52 | * @is_prepared: Queries the hardware to determine if the clock is prepared. | 52 | * @is_prepared: Queries the hardware to determine if the clock is prepared. |
53 | * This function is allowed to sleep. Optional, if this op is not | 53 | * This function is allowed to sleep. Optional, if this op is not |
@@ -58,16 +58,16 @@ struct dentry; | |||
58 | * Called with prepare mutex held. This function may sleep. | 58 | * Called with prepare mutex held. This function may sleep. |
59 | * | 59 | * |
60 | * @enable: Enable the clock atomically. This must not return until the | 60 | * @enable: Enable the clock atomically. This must not return until the |
61 | * clock is generating a valid clock signal, usable by consumer | 61 | * clock is generating a valid clock signal, usable by consumer |
62 | * devices. Called with enable_lock held. This function must not | 62 | * devices. Called with enable_lock held. This function must not |
63 | * sleep. | 63 | * sleep. |
64 | * | 64 | * |
65 | * @disable: Disable the clock atomically. Called with enable_lock held. | 65 | * @disable: Disable the clock atomically. Called with enable_lock held. |
66 | * This function must not sleep. | 66 | * This function must not sleep. |
67 | * | 67 | * |
68 | * @is_enabled: Queries the hardware to determine if the clock is enabled. | 68 | * @is_enabled: Queries the hardware to determine if the clock is enabled. |
69 | * This function must not sleep. Optional, if this op is not | 69 | * This function must not sleep. Optional, if this op is not |
70 | * set then the enable count will be used. | 70 | * set then the enable count will be used. |
71 | * | 71 | * |
72 | * @disable_unused: Disable the clock atomically. Only called from | 72 | * @disable_unused: Disable the clock atomically. Only called from |
73 | * clk_disable_unused for gate clocks with special needs. | 73 | * clk_disable_unused for gate clocks with special needs. |
@@ -75,34 +75,34 @@ struct dentry; | |||
75 | * sleep. | 75 | * sleep. |
76 | * | 76 | * |
77 | * @recalc_rate Recalculate the rate of this clock, by querying hardware. The | 77 | * @recalc_rate Recalculate the rate of this clock, by querying hardware. The |
78 | * parent rate is an input parameter. It is up to the caller to | 78 | * parent rate is an input parameter. It is up to the caller to |
79 | * ensure that the prepare_mutex is held across this call. | 79 | * ensure that the prepare_mutex is held across this call. |
80 | * Returns the calculated rate. Optional, but recommended - if | 80 | * Returns the calculated rate. Optional, but recommended - if |
81 | * this op is not set then clock rate will be initialized to 0. | 81 | * this op is not set then clock rate will be initialized to 0. |
82 | * | 82 | * |
83 | * @round_rate: Given a target rate as input, returns the closest rate actually | 83 | * @round_rate: Given a target rate as input, returns the closest rate actually |
84 | * supported by the clock. | 84 | * supported by the clock. |
85 | * | 85 | * |
86 | * @determine_rate: Given a target rate as input, returns the closest rate | 86 | * @determine_rate: Given a target rate as input, returns the closest rate |
87 | * actually supported by the clock, and optionally the parent clock | 87 | * actually supported by the clock, and optionally the parent clock |
88 | * that should be used to provide the clock rate. | 88 | * that should be used to provide the clock rate. |
89 | * | 89 | * |
90 | * @get_parent: Queries the hardware to determine the parent of a clock. The | 90 | * @get_parent: Queries the hardware to determine the parent of a clock. The |
91 | * return value is a u8 which specifies the index corresponding to | 91 | * return value is a u8 which specifies the index corresponding to |
92 | * the parent clock. This index can be applied to either the | 92 | * the parent clock. This index can be applied to either the |
93 | * .parent_names or .parents arrays. In short, this function | 93 | * .parent_names or .parents arrays. In short, this function |
94 | * translates the parent value read from hardware into an array | 94 | * translates the parent value read from hardware into an array |
95 | * index. Currently only called when the clock is initialized by | 95 | * index. Currently only called when the clock is initialized by |
96 | * __clk_init. This callback is mandatory for clocks with | 96 | * __clk_init. This callback is mandatory for clocks with |
97 | * multiple parents. It is optional (and unnecessary) for clocks | 97 | * multiple parents. It is optional (and unnecessary) for clocks |
98 | * with 0 or 1 parents. | 98 | * with 0 or 1 parents. |
99 | * | 99 | * |
100 | * @set_parent: Change the input source of this clock; for clocks with multiple | 100 | * @set_parent: Change the input source of this clock; for clocks with multiple |
101 | * possible parents specify a new parent by passing in the index | 101 | * possible parents specify a new parent by passing in the index |
102 | * as a u8 corresponding to the parent in either the .parent_names | 102 | * as a u8 corresponding to the parent in either the .parent_names |
103 | * or .parents arrays. This function in affect translates an | 103 | * or .parents arrays. This function in affect translates an |
104 | * array index into the value programmed into the hardware. | 104 | * array index into the value programmed into the hardware. |
105 | * Returns 0 on success, -EERROR otherwise. | 105 | * Returns 0 on success, -EERROR otherwise. |
106 | * | 106 | * |
107 | * @set_rate: Change the rate of this clock. The requested rate is specified | 107 | * @set_rate: Change the rate of this clock. The requested rate is specified |
108 | * by the second argument, which should typically be the return | 108 | * by the second argument, which should typically be the return |
@@ -254,12 +254,12 @@ void of_fixed_clk_setup(struct device_node *np); | |||
254 | * | 254 | * |
255 | * Flags: | 255 | * Flags: |
256 | * CLK_GATE_SET_TO_DISABLE - by default this clock sets the bit at bit_idx to | 256 | * CLK_GATE_SET_TO_DISABLE - by default this clock sets the bit at bit_idx to |
257 | * enable the clock. Setting this flag does the opposite: setting the bit | 257 | * enable the clock. Setting this flag does the opposite: setting the bit |
258 | * disable the clock and clearing it enables the clock | 258 | * disable the clock and clearing it enables the clock |
259 | * CLK_GATE_HIWORD_MASK - The gate settings are only in lower 16-bit | 259 | * CLK_GATE_HIWORD_MASK - The gate settings are only in lower 16-bit |
260 | * of this register, and mask of gate bits are in higher 16-bit of this | 260 | * of this register, and mask of gate bits are in higher 16-bit of this |
261 | * register. While setting the gate bits, higher 16-bit should also be | 261 | * register. While setting the gate bits, higher 16-bit should also be |
262 | * updated to indicate changing gate bits. | 262 | * updated to indicate changing gate bits. |
263 | */ | 263 | */ |
264 | struct clk_gate { | 264 | struct clk_gate { |
265 | struct clk_hw hw; | 265 | struct clk_hw hw; |
@@ -298,20 +298,20 @@ struct clk_div_table { | |||
298 | * | 298 | * |
299 | * Flags: | 299 | * Flags: |
300 | * CLK_DIVIDER_ONE_BASED - by default the divisor is the value read from the | 300 | * CLK_DIVIDER_ONE_BASED - by default the divisor is the value read from the |
301 | * register plus one. If CLK_DIVIDER_ONE_BASED is set then the divider is | 301 | * register plus one. If CLK_DIVIDER_ONE_BASED is set then the divider is |
302 | * the raw value read from the register, with the value of zero considered | 302 | * the raw value read from the register, with the value of zero considered |
303 | * invalid, unless CLK_DIVIDER_ALLOW_ZERO is set. | 303 | * invalid, unless CLK_DIVIDER_ALLOW_ZERO is set. |
304 | * CLK_DIVIDER_POWER_OF_TWO - clock divisor is 2 raised to the value read from | 304 | * CLK_DIVIDER_POWER_OF_TWO - clock divisor is 2 raised to the value read from |
305 | * the hardware register | 305 | * the hardware register |
306 | * CLK_DIVIDER_ALLOW_ZERO - Allow zero divisors. For dividers which have | 306 | * CLK_DIVIDER_ALLOW_ZERO - Allow zero divisors. For dividers which have |
307 | * CLK_DIVIDER_ONE_BASED set, it is possible to end up with a zero divisor. | 307 | * CLK_DIVIDER_ONE_BASED set, it is possible to end up with a zero divisor. |
308 | * Some hardware implementations gracefully handle this case and allow a | 308 | * Some hardware implementations gracefully handle this case and allow a |
309 | * zero divisor by not modifying their input clock | 309 | * zero divisor by not modifying their input clock |
310 | * (divide by one / bypass). | 310 | * (divide by one / bypass). |
311 | * CLK_DIVIDER_HIWORD_MASK - The divider settings are only in lower 16-bit | 311 | * CLK_DIVIDER_HIWORD_MASK - The divider settings are only in lower 16-bit |
312 | * of this register, and mask of divider bits are in higher 16-bit of this | 312 | * of this register, and mask of divider bits are in higher 16-bit of this |
313 | * register. While setting the divider bits, higher 16-bit should also be | 313 | * register. While setting the divider bits, higher 16-bit should also be |
314 | * updated to indicate changing divider bits. | 314 | * updated to indicate changing divider bits. |
315 | * CLK_DIVIDER_ROUND_CLOSEST - Makes the best calculated divider to be rounded | 315 | * CLK_DIVIDER_ROUND_CLOSEST - Makes the best calculated divider to be rounded |
316 | * to the closest integer instead of the up one. | 316 | * to the closest integer instead of the up one. |
317 | */ | 317 | */ |
@@ -359,9 +359,9 @@ struct clk *clk_register_divider_table(struct device *dev, const char *name, | |||
359 | * CLK_MUX_INDEX_ONE - register index starts at 1, not 0 | 359 | * CLK_MUX_INDEX_ONE - register index starts at 1, not 0 |
360 | * CLK_MUX_INDEX_BIT - register index is a single bit (power of two) | 360 | * CLK_MUX_INDEX_BIT - register index is a single bit (power of two) |
361 | * CLK_MUX_HIWORD_MASK - The mux settings are only in lower 16-bit of this | 361 | * CLK_MUX_HIWORD_MASK - The mux settings are only in lower 16-bit of this |
362 | * register, and mask of mux bits are in higher 16-bit of this register. | 362 | * register, and mask of mux bits are in higher 16-bit of this register. |
363 | * While setting the mux bits, higher 16-bit should also be updated to | 363 | * While setting the mux bits, higher 16-bit should also be updated to |
364 | * indicate changing mux bits. | 364 | * indicate changing mux bits. |
365 | */ | 365 | */ |
366 | struct clk_mux { | 366 | struct clk_mux { |
367 | struct clk_hw hw; | 367 | struct clk_hw hw; |