[PATCH] ARM: Add further explaination for clk_get()
authorRussell King <rmk@dyn-67.arm.linux.org.uk>
Wed, 27 Apr 2005 17:19:55 +0000 (18:19 +0100)
committerRussell King <rmk@dyn-67.arm.linux.org.uk>
Wed, 27 Apr 2005 17:19:55 +0000 (18:19 +0100)
clk_get() comments can be confusing.  Add extra explaination of
the dev and id parameters to ensure correct usage.

Signed-off-by: Russell King <rmk@arm.linux.org.uk>
include/asm-arm/hardware/clock.h

index 4983449ff2c7fdf98708ea101fb26441f6393982..19da861e523d8dbbfe327e4b07d166c61544a623 100644 (file)
@@ -26,10 +26,13 @@ struct clk;
 /**
  * clk_get - lookup and obtain a reference to a clock producer.
  * @dev: device for clock "consumer"
- * @id: device ID
+ * @id: clock comsumer ID
  *
  * Returns a struct clk corresponding to the clock producer, or
- * valid IS_ERR() condition containing errno.
+ * valid IS_ERR() condition containing errno.  The implementation
+ * uses @dev and @id to determine the clock consumer, and thereby
+ * the clock producer.  (IOW, @id may be identical strings, but
+ * clk_get may return different clock producers depending on @dev.)
  */
 struct clk *clk_get(struct device *dev, const char *id);