Received: by 2002:a05:6a10:16a7:0:0:0:0 with SMTP id gp39csp19383pxb; Wed, 4 Nov 2020 13:13:00 -0800 (PST) X-Google-Smtp-Source: ABdhPJz+zWsrzZkggzrHR9ptfaI/b8y9VdouOW+RvDiSNA6On9aweynzKsv+uI9+1l/wO9z8FLMZ X-Received: by 2002:aa7:c9cb:: with SMTP id i11mr19180060edt.100.1604524380038; Wed, 04 Nov 2020 13:13:00 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1604524380; cv=none; d=google.com; s=arc-20160816; b=MQhuGjtyzGNlyct2wIjLoqcXkcPUSKVdNvh4uG8LxMQQqvN6stMsLq1pXLyXS/v6iP rHLbS8uLvLRxc53CAX7oQ1gAYXEUpmYPfH1IJer4bg3mrKRw7Y1+5rfhc8RbzvlDGH0b 5VFQXNSQK1Mltl5EJd9ZZBvt5VxKFg6La7sffqG2dVroEZNh67o0dAnhsfVT29bKTPUZ y8MmkiZ7wJaXHXbf1lJZp2wB8r1ZsgAi8DGz2JnEJH66DQzfVE7KY7TUo3f8LPeTfGfl olH4L8EVauXRUP0JAGdwzupmI+yH/Xf6vuxOvMGaHgPmkpJ4sgha6348oeNU0OAgY8Sb ZS/g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:content-language :in-reply-to:mime-version:user-agent:date:message-id:organization :references:to:from:subject:dkim-filter; bh=xQPw7tsg65KiQ2zubbrLs5w2fEqqwg2ZqoxCufQkwHk=; b=vOcsqd5UQiNrCvQgtLyY+k3j4GrEWaSjNmdXI8k4P2BsVDqLPKViSKvO9HosSqw75W JPH9TMQL+2AeYn0oRoMp25sRJACHmY2Ky4J9K/QtDr0Ei/s81XPj3JQNrFcsUN5iPgSz fK2MAtG/B/8gQnkv8KCxiz58v9eWAm9OUnEHEiSCwBMKzMqGFc9YhNbCKaXpY34wEGcr xMz/Ad/1msbVoyN5mlM4rFI43XOxapkyO5MkENWrDWwD+pXN9Y27rLIAjERLGCCZvMPe fOQInpHbZAYfZvlsC22ESVUYZnM9PLkUpIBrQKyu/ccZhIzVLO/wPisaPEkDqOlVCXjN 7G8Q== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=omprussia.ru Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id p25si2470750ejc.412.2020.11.04.13.12.37; Wed, 04 Nov 2020 13:13:00 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=omprussia.ru Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729883AbgKDUfy (ORCPT + 99 others); Wed, 4 Nov 2020 15:35:54 -0500 Received: from mxout04.lancloud.ru ([89.108.124.63]:39994 "EHLO mxout04.lancloud.ru" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726777AbgKDUfy (ORCPT ); Wed, 4 Nov 2020 15:35:54 -0500 Received: from LanCloud DKIM-Filter: OpenDKIM Filter v2.11.0 mxout04.lancloud.ru 548DB20510B0 Received: from LanCloud Received: from LanCloud Received: from LanCloud Subject: [PATCH 2/2] module: add more 'kernel-doc' comments From: Sergey Shtylyov To: Jessica Yu , References: <8fe9a7be-9f32-6724-a20f-9659b418f184@omprussia.ru> Organization: Open Mobile Platform, LLC Message-ID: <8e1e5391-c6ef-a403-a4c7-573cff9e8984@omprussia.ru> Date: Wed, 4 Nov 2020 23:35:51 +0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.3.1 MIME-Version: 1.0 In-Reply-To: <8fe9a7be-9f32-6724-a20f-9659b418f184@omprussia.ru> Content-Type: text/plain; charset="utf-8" Content-Language: en-US Content-Transfer-Encoding: 7bit X-Originating-IP: [213.87.161.212] X-ClientProxiedBy: LFEXT01.lancloud.ru (fd00:f066::141) To LFEX1908.lancloud.ru (fd00:f066::208) Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Some functions have the proper 'kernel-doc' comments but these don't start with proper /** -- fix that, along with adding () to the function name on the following lines to fully comply with the 'kernel-doc' format. Signed-off-by: Sergey Shtylyov --- kernel/module.c | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) Index: linux/kernel/module.c =================================================================== --- linux.orig/kernel/module.c +++ linux/kernel/module.c @@ -4491,8 +4491,8 @@ out: return e; } -/* - * is_module_address - is this address inside a module? +/** + * is_module_address() - is this address inside a module? * @addr: the address to check. * * See is_module_text_address() if you simply want to see if the address @@ -4509,8 +4509,8 @@ bool is_module_address(unsigned long add return ret; } -/* - * __module_address - get the module which contains an address. +/** + * __module_address() - get the module which contains an address. * @addr: the address. * * Must be called with preempt disabled or module mutex held so that @@ -4534,8 +4534,8 @@ struct module *__module_address(unsigned return mod; } -/* - * is_module_text_address - is this address inside module code? +/** + * is_module_text_address() - is this address inside module code? * @addr: the address to check. * * See is_module_address() if you simply want to see if the address is @@ -4553,8 +4553,8 @@ bool is_module_text_address(unsigned lon return ret; } -/* - * __module_text_address - get the module whose code contains an address. +/** + * __module_text_address() - get the module whose code contains an address. * @addr: the address. * * Must be called with preempt disabled or module mutex held so that