linux-kernel - Re: [PATCH 1/2] PM: EM: fix kernel-doc comments

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <CAJZ5v0hSzzkVzO0CuP0sf16p70kppfr6oHU1VDjfuBqt_HVfSw@mail.gmail.com>
Date:   Tue, 7 Sep 2021 21:22:06 +0200
From:   "Rafael J. Wysocki" <rafael@...nel.org>
To:     Lukasz Luba <lukasz.luba@....com>
Cc:     Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
        Dietmar Eggemann <dietmar.eggemann@....com>,
        Quentin Perret <qperret@...gle.com>,
        Rafael Wysocki <rafael.j.wysocki@...el.com>,
        Linux PM <linux-pm@...r.kernel.org>,
        Vincent Donnefort <vincent.donnefort@....com>
Subject: Re: [PATCH 1/2] PM: EM: fix kernel-doc comments

On Mon, Sep 6, 2021 at 10:46 AM Lukasz Luba <lukasz.luba@....com> wrote:
>
> Fix the kernel-doc comments for the improved Energy Model documentation.
>
> Signed-off-by: Lukasz Luba <lukasz.luba@....com>
> ---
>  include/linux/energy_model.h | 8 ++++----
>  1 file changed, 4 insertions(+), 4 deletions(-)
>
> diff --git a/include/linux/energy_model.h b/include/linux/energy_model.h
> index 1834752c5617..39dcadd492b5 100644
> --- a/include/linux/energy_model.h
> +++ b/include/linux/energy_model.h
> @@ -11,7 +11,7 @@
>  #include <linux/types.h>
>
>  /**
> - * em_perf_state - Performance state of a performance domain
> + * struct em_perf_state - Performance state of a performance domain
>   * @frequency: The frequency in KHz, for consistency with CPUFreq
>   * @power:     The power consumed at this level (by 1 CPU or by a registered
>   *             device). It can be a total power: static and dynamic.
> @@ -25,7 +25,7 @@ struct em_perf_state {
>  };
>
>  /**
> - * em_perf_domain - Performance domain
> + * struct em_perf_domain - Performance domain
>   * @table:             List of performance states, in ascending order
>   * @nr_perf_states:    Number of performance states
>   * @milliwatts:                Flag indicating the power values are in milli-Watts
> @@ -103,12 +103,12 @@ void em_dev_unregister_perf_domain(struct device *dev);
>
>  /**
>   * em_cpu_energy() - Estimates the energy consumed by the CPUs of a
> -               performance domain
> + *             performance domain
>   * @pd         : performance domain for which energy has to be estimated
>   * @max_util   : highest utilization among CPUs of the domain
>   * @sum_util   : sum of the utilization of all CPUs in the domain
>   * @allowed_cpu_cap    : maximum allowed CPU capacity for the @pd, which
> -                         might reflect reduced frequency (due to thermal)
> + *                       might reflect reduced frequency (due to thermal)
>   *
>   * This function must be used only for CPU devices. There is no validation,
>   * i.e. if the EM is a CPU type and has cpumask allocated. It is called from
> --

Applied as 5.15-rc material along with the [2/2], thanks!