Received: by 2002:a05:7412:8d10:b0:f3:1519:9f41 with SMTP id bj16csp2267071rdb; Fri, 8 Dec 2023 03:24:55 -0800 (PST) X-Google-Smtp-Source: AGHT+IE1w8SSSs1VB91NneJ8LE/iOoIs6bfvoGBnFHWjuIONJnmvI0fl1LLzkBTkQESfWXYGmHJX X-Received: by 2002:a17:902:da91:b0:1d0:bcb2:b905 with SMTP id j17-20020a170902da9100b001d0bcb2b905mr4010144plx.121.1702034694735; Fri, 08 Dec 2023 03:24:54 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1702034694; cv=none; d=google.com; s=arc-20160816; b=Zn0j900hc5xygytD8mqrRkG41fK8umb3wiQGxOYrIsUwWdG+TuiJt+pjiEh7hW+49R tkUHiGqHBtns4/rq06AszywmeqP4Gi3B24YCb9dyX1ZmnaFYrrMCRoOfHAujGKnh9Vi4 gS2X7UucCRjaa1VdAK1Tse7dzAYql8wHph0GqdjhgSGXn5R6mDjIvMmBTUxEngofjju1 YvNvIhcsO0LOcJLLuBC/kwreHPPIllILn2Y7QUsnWVbCWL5FGydd7V4al+KMu8G4TlQe dADCNxHcZ5KkHzmagh/ZrxPbKxE5/nJN6o6CyUzXFxk86PpoimQveOZbgJHeqJgy1zXc xK4A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version:date :message-id:subject:references:in-reply-to:cc:to:from:dkim-signature; bh=jSEMdw1g8vnp6fEEBLan/xYEfOlF9t5Syosc6cWWVj0=; fh=lnMhsNxCG6vSg+3KaJ5aJquCCk4vWSNbrlaRXfoEZn4=; b=TmUf3TSGkBYqIYCgX0VdrrCjjvuKGdqEkicaxKEs3APBm+VZ1yzPPZaoQdAkVBLlAz DsRJmG9LSmbnWdo1RkdnhtkzzrqCUBS7/Isg8CxBSgE0Ow/u3dtquy4I+lkJSbyz4ANg hkD4wbyPZuf/j947BGhahb8yTfS66sRsE0udf7mLTG3R2Fx7qlmIWc4mUecdTK80lqWG OGC7MjVP6hxIUay9jur/ouFYXSE+d/EBxxMyq5sGRifeJozsR439uGg9bA0SYCY7ccg7 WqjxlP81cFh9q7mnfa0t37LiS0qk8mGcUr/ufy83eyDVz7hn9alrudNYoRgj9sstorm+ 8cmA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=CRpBkQa9; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.38 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Return-Path: Received: from fry.vger.email (fry.vger.email. [23.128.96.38]) by mx.google.com with ESMTPS id w13-20020a170902a70d00b001cfb4bd0b83si1432735plq.439.2023.12.08.03.24.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 08 Dec 2023 03:24:54 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.38 as permitted sender) client-ip=23.128.96.38; Authentication-Results: mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=CRpBkQa9; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.38 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by fry.vger.email (Postfix) with ESMTP id BB8E68116784; Fri, 8 Dec 2023 03:24:51 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at fry.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233322AbjLHLYi (ORCPT + 99 others); Fri, 8 Dec 2023 06:24:38 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33200 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232504AbjLHLYg (ORCPT ); Fri, 8 Dec 2023 06:24:36 -0500 Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.43]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 14F75171D; Fri, 8 Dec 2023 03:24:42 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1702034682; x=1733570682; h=from:to:cc:in-reply-to:references:subject:message-id: date:mime-version:content-transfer-encoding; bh=J7RKyZr5ol9duGiT81gLM1o4OL83UMlZmqvS+FpSDW0=; b=CRpBkQa9doG6NghHL3Ve0bvkxxyGzfPqqyXBRm/c1wEU9COHNzyTKsfK 0VCu1zpPB/mFTnUpMuGZeELd8RfHDl8O+neva+Wwg+qRYm7dqDobD6CeO DjByED+psYEg5bhDhckOHon8nTtRw36yMi5xq4E8hsU3U+tdPNT2l5PGM dk5OLBQsuzwwhuikZWZe29QAi7Qrx6efxmVbJF0orIQPjux+p61+keSCN KmrB2ShOG2YzLaRAkU3MTCDjM16wViHue4E3MPEt6aOQBygjJoo/gG8Wl 8dR/GxC85SYF30/g5ndHFQO99B5TXXedrnr8xXtn0KhihPqVPVcARdpss w==; X-IronPort-AV: E=McAfee;i="6600,9927,10917"; a="480588888" X-IronPort-AV: E=Sophos;i="6.04,260,1695711600"; d="scan'208";a="480588888" Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 08 Dec 2023 03:24:41 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10917"; a="772099007" X-IronPort-AV: E=Sophos;i="6.04,260,1695711600"; d="scan'208";a="772099007" Received: from ijarvine-desk1.ger.corp.intel.com (HELO localhost) ([10.246.49.180]) by orsmga002-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 08 Dec 2023 03:24:39 -0800 From: =?UTF-8?q?Ilpo=20J=C3=A4rvinen?= To: linux-kernel@vger.kernel.org, Randy Dunlap Cc: Hans de Goede , platform-driver-x86@vger.kernel.org In-Reply-To: <20231206060120.4816-1-rdunlap@infradead.org> References: <20231206060120.4816-1-rdunlap@infradead.org> Subject: Re: [PATCH] platform/x86: intel_ips: fix kernel-doc formatting Message-Id: <170203467391.2381.1940561088984223400.b4-ty@linux.intel.com> Date: Fri, 08 Dec 2023 13:24:33 +0200 MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit X-Mailer: b4 0.12.3 X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on fry.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (fry.vger.email [0.0.0.0]); Fri, 08 Dec 2023 03:24:52 -0800 (PST) On Tue, 05 Dec 2023 22:01:18 -0800, Randy Dunlap wrote: > Fix kernel-doc function notation and comment formatting to prevent > warnings from scripts/kernel-doc. > > for drivers/platform/x86/intel_ips.c: > 595: warning: No description found for return value of 'mcp_exceeded' > 624: warning: No description found for return value of 'cpu_exceeded' > 650: warning: No description found for return value of 'mch_exceeded' > 745: warning: bad line: cpu+ gpu+ cpu+gpu- cpu-gpu+ cpu-gpu- > 746: warning: bad line: cpu < gpu < cpu+gpu+ cpu+ gpu+ nothing > 753: warning: No description found for return value of 'ips_adjust' > 747: warning: bad line: cpu < gpu >= cpu+gpu-(mcp<) cpu+gpu-(mcp<) gpu- gpu- > 748: warning: bad line: cpu >= gpu < cpu-gpu+(mcp<) cpu- cpu-gpu+(mcp<) cpu- > 749: warning: bad line: cpu >= gpu >= cpu-gpu- cpu-gpu- cpu-gpu- cpu-gpu- > 945: warning: No description found for return value of 'ips_monitor' > 1151: warning: No description found for return value of 'ips_irq_handler' > 1301: warning: Function parameter or member 'ips' not described in 'ips_detect_cpu' > 1302: warning: No description found for return value of 'ips_detect_cpu' > 1358: warning: No description found for return value of 'ips_get_i915_syms' > > [...] Thank you for your contribution, it has been applied to my local review-ilpo branch. Note it will show up in the public platform-drivers-x86/review-ilpo branch only once I've pushed my local branch there, which might take a while. The list of commits applied: [1/1] platform/x86: intel_ips: fix kernel-doc formatting commit: 7bcd032370f88fd4022b6926d101403e96a86309 -- i.