lkml.org 
[lkml]   [2017]   [Nov]   [22]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    /
    Date
    From
    SubjectRe: [v3, 09/12] hwmon (occ): Add sensor attributes and register hwmon device
    On Mon, Nov 20, 2017 at 05:53:38PM -0600, eajames@linux.vnet.ibm.com wrote:
    > From: "Edward A. James" <eajames@us.ibm.com>
    >
    > Setup the sensor attributes for every OCC sensor found by the first poll
    > response. Register the attributes with hwmon. Add hwmon documentation
    > for the driver.
    >
    > Signed-off-by: Edward A. James <eajames@us.ibm.com>
    > ---
    > drivers/hwmon/occ/common.c | 450 +++++++++++++++++++++++++++++++++++++++++++++
    > drivers/hwmon/occ/common.h | 15 ++

    I seem to be missing the documentation.

    Documentation/hwmon/submitting-patches:

    * Document the driver in Documentation/hwmon/<driver_name>.

    * Do not create non-standard attributes unless really needed. If you have to use
    non-standard attributes, or you believe you do, discuss it on the mailing list
    first. Either case, provide a detailed explanation why you need the
    non-standard attribute(s).
    Standard attributes are specified in Documentation/hwmon/sysfs-interface.

    I really would expect a detailed explanation and, even more so,
    documentation for all the non-standard attributes you are adding.

    power%d_update_time
    power%d_update_tag
    power%d_accumulator

    really need to be documented, you really need to explain the need for those
    attributes. To me they don't mean anything.

    Note that you'd probably be much better off using
    devm_register_hwmon_with_info() nowadays, but i'll leave that for you to
    decide.

    Guenter

    \
     
     \ /
      Last update: 2017-11-22 16:24    [W:2.888 / U:0.092 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site