From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 87833EB64D8 for ; Thu, 22 Jun 2023 07:06:14 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229990AbjFVHGO (ORCPT ); Thu, 22 Jun 2023 03:06:14 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33616 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229840AbjFVHGN (ORCPT ); Thu, 22 Jun 2023 03:06:13 -0400 Received: from mail-wm1-x331.google.com (mail-wm1-x331.google.com [IPv6:2a00:1450:4864:20::331]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3E2F51FCE for ; Thu, 22 Jun 2023 00:05:59 -0700 (PDT) Received: by mail-wm1-x331.google.com with SMTP id 5b1f17b1804b1-3f9c0abc8b1so15417005e9.1 for ; Thu, 22 Jun 2023 00:05:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=resnulli-us.20221208.gappssmtp.com; s=20221208; t=1687417557; x=1690009557; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=VIhSOYk52hVuqfcboW85OQLI0NHly7jy25hrkyJ2YAw=; b=WZQ2qdOUncD9AsxUeqky0Sv9plZI/2WtRmFLj/vUPrLspAKtFdJAjDNBfRiM90Wl6l Bu52No9UiIMeNp5vJfqV4tdzKNy4gqSSkZZgdTA2tEhX9UhJ0VFvTD1WUjcyZjBnxsqM CY6kI+W0r2aC0t58Ot4ae4EkJpbEUxEO+qU0IzQugmgTpIX9f4Vdc6bAsBsmzf0/VZPu oMD/OCT9ypK+CBaNDZaMdjjZbvVgK6KKjigdSYdUY6tPiNMyp/u8BcNpj7C6Q76VkPqd cFeXbCEhZGKbNKcefxvBWXoomyu9ZEWY69AGbsxFJ97j4shY74xka5Cdz8D7NjEiYYcZ YJOw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1687417557; x=1690009557; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=VIhSOYk52hVuqfcboW85OQLI0NHly7jy25hrkyJ2YAw=; b=T6RHkl4/xNC40ixIUck2wjZiZaVK7cNwYwgzBKevf+GBZv1kZfmcg1Um/r1TPb/BtF regnKQbVm7k1ef/gv0o8HTuubROW7X8njHYRMY3A6a8jwSIkwhcdIQ1QTn8Hm1dqU5/j iGIJDn8E2dvqyWM2M9WQojHPoV6j7MBmMLj33nGriKbs369iPNOd9Ajou1s3eAlGLQ6+ NXAzFUDXcDdalo59ppnUpZTaQNe6G4+ucFrPlp5ay3HSMeduYqrDGNwl4fWbepEPRa+C XKx6nzi2e4y+dJl5VA6fOSR6ucrjBSO424K7z7zW53b6WpMr4pdVC6M4TDNW5IzKx4J1 6bjQ== X-Gm-Message-State: AC+VfDzu7VMJ4YDRBLc1m23EcOow6eDL4QE+HrKYadgWCQC/i5OHCbu4 JcpjOO1/MTd10Zl6qb+1o6zsFQ== X-Google-Smtp-Source: ACHHUZ47nqUaHErWDVz/sLK5UcH8SW19SUG16keT/oe5Rk5/giZmsiFYSgziHOgHrlK6XzxNNrCLiA== X-Received: by 2002:a1c:7415:0:b0:3fa:77c8:6724 with SMTP id p21-20020a1c7415000000b003fa77c86724mr51349wmc.10.1687417557595; Thu, 22 Jun 2023 00:05:57 -0700 (PDT) Received: from localhost ([86.61.181.4]) by smtp.gmail.com with ESMTPSA id 17-20020a05600c231100b003f8ec58995fsm6919930wmo.6.2023.06.22.00.05.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 22 Jun 2023 00:05:57 -0700 (PDT) Date: Thu, 22 Jun 2023 09:05:56 +0200 From: Jiri Pirko To: "Kubalewski, Arkadiusz" Cc: "kuba@kernel.org" , "vadfed@meta.com" , "jonathan.lemon@gmail.com" , "pabeni@redhat.com" , "corbet@lwn.net" , "davem@davemloft.net" , "edumazet@google.com" , "vadfed@fb.com" , "Brandeburg, Jesse" , "Nguyen, Anthony L" , "M, Saeed" , "leon@kernel.org" , "richardcochran@gmail.com" , "sj@kernel.org" , "javierm@redhat.com" , "ricardo.canuelo@collabora.com" , "mst@redhat.com" , "tzimmermann@suse.de" , "Michalik, Michal" , "gregkh@linuxfoundation.org" , "jacek.lawrynowicz@linux.intel.com" , "airlied@redhat.com" , "ogabbay@kernel.org" , "arnd@arndb.de" , "nipun.gupta@amd.com" , "axboe@kernel.dk" , "linux@zary.sk" , "masahiroy@kernel.org" , "benjamin.tissoires@redhat.com" , "geert+renesas@glider.be" , "Olech, Milena" , "kuniyu@amazon.com" , "liuhangbin@gmail.com" , "hkallweit1@gmail.com" , "andy.ren@getcruise.com" , "razor@blackwall.org" , "idosch@nvidia.com" , "lucien.xin@gmail.com" , "nicolas.dichtel@6wind.com" , "phil@nwl.cc" , "claudiajkang@gmail.com" , "linux-doc@vger.kernel.org" , "linux-kernel@vger.kernel.org" , "netdev@vger.kernel.org" , "intel-wired-lan@lists.osuosl.org" , "linux-rdma@vger.kernel.org" , "linux-arm-kernel@lists.infradead.org" , poros , mschmidt , "linux-clk@vger.kernel.org" , "vadim.fedorenko@linux.dev" Subject: Re: [RFC PATCH v8 03/10] dpll: core: Add DPLL framework base functions Message-ID: References: <20230609121853.3607724-1-arkadiusz.kubalewski@intel.com> <20230609121853.3607724-4-arkadiusz.kubalewski@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: Precedence: bulk List-ID: X-Mailing-List: linux-clk@vger.kernel.org Wed, Jun 21, 2023 at 08:55:35PM CEST, arkadiusz.kubalewski@intel.com wrote: >>From: Jiri Pirko >>Sent: Saturday, June 10, 2023 7:38 PM >> >>Fri, Jun 09, 2023 at 02:18:46PM CEST, arkadiusz.kubalewski@intel.com wrote: >>>From: Vadim Fedorenko >>> >>>DPLL framework is used to represent and configure DPLL devices >>>in systems. Each device that has DPLL and can configure inputs >>>and outputs can use this framework. >>> >>>Implement core framework functions for further interactions >>>with device drivers implementing dpll subsystem, as well as for >>>interactions of DPLL netlink framework part with the subsystem >>>itself. >>> >>>Co-developed-by: Milena Olech >>>Signed-off-by: Milena Olech >>>Co-developed-by: Michal Michalik >>>Signed-off-by: Michal Michalik >>>Signed-off-by: Vadim Fedorenko >>>Co-developed-by: Arkadiusz Kubalewski >>>Signed-off-by: Arkadiusz Kubalewski >>>--- >>> drivers/dpll/dpll_core.c | 953 +++++++++++++++++++++++++++++++++++++++ >>> drivers/dpll/dpll_core.h | 104 +++++ >> >>Overall, looks very good! I pinpointed couple of nits below, nothing big. >>General question: Why do you put documentation comment to every static >>function? Does not make any sense to me. Even for non-exported functions >>I think it is overkill. Most of them (if not all) give the reader no >>additional information and only make the code a bit harder to read. >>Care to drop them? >> > >I forgot to respond here.. I would rather leave it, but if the others think >the same way, we could remove them. Could you explain what is the benefit of leaving them? What are they good for. From what I see, they are obvious and only add blank LOC.