Received: by 2002:a05:6a10:206:0:0:0:0 with SMTP id 6csp3424982pxj; Tue, 15 Jun 2021 00:10:58 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyRF9H74/z1H5uPpqr1KRPFijqpdgKPVyCrJTl3Svu2+xCLB9Iv1W5PmdpEl37NQJ9OSogC X-Received: by 2002:a6b:7d4b:: with SMTP id d11mr1258197ioq.161.1623741057927; Tue, 15 Jun 2021 00:10:57 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1623741057; cv=none; d=google.com; s=arc-20160816; b=iZWbgpnAMJcJZPdWBNKpHPpqxbhDXm4BML7cRA3p+ssqqBbwYngYl8nTz7kQIfFu+0 KGfgaHGp+A6gl6pSV8/OIj+wCSlhNpaq8TbA7c0WbENTgSTAkD9AU+9QarXpabpF4k7b SQORd/f2T9DG87Mo+qO/DEEHoF1rqQXT2G8FZbGw0Ra8QX22KOUTEtKEpjvWV0SXOISb kf+nuI3upPO6sJtoGXUgAFauFhHpl2j7c9/gKzIGzEoI5XNnOCNZpfxE36T3Xf75qRTS oaDXVJj64tDN4En0Qf7QvuilysEuQB8fO9GrF6L84bdlVw8+Qug9+rNGfs9AH8QxUHZH crEw== 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 :message-id:date:subject:cc:to:from; bh=f1MnbOvt3NtxbZ8xvyRaD0WCDbrD3SoDX0zejmctw4s=; b=IorIQsEjRooK701Zq+7SSjfA80rsDl6qE/PC6VMZTU3paOAONgkyTyF2JmyE71heOH QQPeiGqCz4Jg7MUS8Hp3s3nB0IuEci0FFekgqdSZl0Z1FdS/Ly9H05ERaXbd5QoHRL31 rqm3JSB5OVNq9IpwYYoTTQDEoLqptH7Q09ATfoK+Di1bex+MI4/3btHkFykbxrX4rhCV YBrQh2qDlQfBMuZ6+D6tQeXjgCi8f0BUL0Gn12GMcuVQS/+lBO87ztFgc3N2UKRtiPjd 19qcKqt+NAqA0AXwt8MuoEsUBqmlKdKr5W51EYXrLK6uikkqRG6bg5ptaJvBpyxq2TQx f5eQ== 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=huawei.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id p5si19110997ilq.16.2021.06.15.00.10.46; Tue, 15 Jun 2021 00:10:57 -0700 (PDT) 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=huawei.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229908AbhFOHMV (ORCPT + 99 others); Tue, 15 Jun 2021 03:12:21 -0400 Received: from szxga03-in.huawei.com ([45.249.212.189]:6370 "EHLO szxga03-in.huawei.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229488AbhFOHMV (ORCPT ); Tue, 15 Jun 2021 03:12:21 -0400 Received: from dggemv703-chm.china.huawei.com (unknown [172.30.72.55]) by szxga03-in.huawei.com (SkyGuard) with ESMTP id 4G3zr80FSRz62cd; Tue, 15 Jun 2021 15:06:16 +0800 (CST) Received: from dggpeml500020.china.huawei.com (7.185.36.88) by dggemv703-chm.china.huawei.com (10.3.19.46) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2176.2; Tue, 15 Jun 2021 15:10:13 +0800 Received: from huawei.com (10.175.127.227) by dggpeml500020.china.huawei.com (7.185.36.88) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2176.2; Tue, 15 Jun 2021 15:10:13 +0800 From: Baokun Li To: , , , CC: , , , , Subject: [PATCH -next v2] ACPI: sysfs: fix doc warnings in device_sysfs.c Date: Tue, 15 Jun 2021 15:19:14 +0800 Message-ID: <20210615071914.3067407-1-libaokun1@huawei.com> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 Content-Transfer-Encoding: 7BIT Content-Type: text/plain; charset=US-ASCII X-Originating-IP: [10.175.127.227] X-ClientProxiedBy: dggems705-chm.china.huawei.com (10.3.19.182) To dggpeml500020.china.huawei.com (7.185.36.88) X-CFilter-Loop: Reflected Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/acpi/device_sysfs.c:278: warning: Function parameter or member 'dev' not described in 'acpi_device_uevent_modalias' drivers/acpi/device_sysfs.c:278: warning: Function parameter or member 'env' not described in 'acpi_device_uevent_modalias' drivers/acpi/device_sysfs.c:323: warning: Function parameter or member 'dev' not described in 'acpi_device_modalias' drivers/acpi/device_sysfs.c:323: warning: Function parameter or member 'buf' not described in 'acpi_device_modalias' drivers/acpi/device_sysfs.c:323: warning: Function parameter or member 'size' not described in 'acpi_device_modalias' Signed-off-by: Baokun Li --- V1->V2: Make comments more appropriate drivers/acpi/device_sysfs.c | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/drivers/acpi/device_sysfs.c b/drivers/acpi/device_sysfs.c index a393e0e09381..d96e38b2a0d1 100644 --- a/drivers/acpi/device_sysfs.c +++ b/drivers/acpi/device_sysfs.c @@ -268,6 +268,8 @@ int __acpi_device_uevent_modalias(struct acpi_device *adev, /** * acpi_device_uevent_modalias - uevent modalias for ACPI-enumerated devices. + * @dev: Struct device to get acpi device node. + * @env: Environment variables of the kobject uevent. * * Create the uevent modalias field for ACPI-enumerated devices. * @@ -313,6 +315,9 @@ static int __acpi_device_modalias(struct acpi_device *adev, char *buf, int size) /** * acpi_device_modalias - modalias sysfs attribute for ACPI-enumerated devices. + * @dev: Struct device to get acpi device node. + * @buf: The buffer to save pnp_modalias and of_modalias. + * @size: Size of buffer. * * Create the modalias sysfs attribute for ACPI-enumerated devices. * -- 2.31.1