Received: by 2002:a05:6a10:9e8c:0:0:0:0 with SMTP id y12csp121533pxx; Tue, 27 Oct 2020 23:38:09 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxhAGg/l4fq5p+arI0TGmS37VQJXVoKj9/vkwTVILCmRUAPV1k6x7HUTA+0wE/FsVpSNFs0 X-Received: by 2002:a17:906:f8d5:: with SMTP id lh21mr6077880ejb.38.1603867089242; Tue, 27 Oct 2020 23:38:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1603867089; cv=none; d=google.com; s=arc-20160816; b=ajjE86lHBOJrW6BEC6OzIvJJddH2C95TP4BOZ9dvN74eUESQJ5Ow7FHmh27Onrgn7S tgDt3ARtgm/I2AFEJ3bFDkXNG/9adkThnSxlQjVPk9gQDNt22bza9JpnexOEcs1necxW crnX+Z25ChalSciVNHE0nY3EnH1C/E8mDdL7OHCxTGP/RZ38ZUXpguL96Fx02v1rn5R3 F1S2wkZpN4AAO1u2wjrLbLZEAjihULM9mEXt5KWi24D9L2SI5Gd40hDXAtT20VzGMjhI r4pn3kv5kYrSMm3FbJPZ6+2yrxy8SwdX0ftmpvZDvJvnZaDKztXqhGzk3hez/faKfGkJ 2ftg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date:dkim-signature; bh=Wolut7a1c2zX7C+Xumd0b7oYYiNOd60jt9NVhVqZ7rs=; b=mCpJZC9O5WkRmqp/9wxk97bpG+yqshPioTYg4tiIjo7Xfh7dvHdQ3ZAVMVXQhy4n/f /iHYmEjvHMakChgb2K3g+NKesoBlq4ms1YQh5dphA0RlfodpDK2p67YM/peBYy05cpGU oEUKgBY8AW9q4tNi2a+x1no5wursIu9+rEol1FfH5NJ8JSEmzQw7pzgAM0/aLht0e8pd 0zA1/Q41vf1HsE5W++iQvUdzv9E9PIC/b35mb3cYOyeBWgfFLEPkGBK+8HlpjZj1/mU6 LhZC6KB6qS8ntnp+SOk/7/jBq7NPZVFyHG7XHfWoT9HBhJPInICKe7X8d52Z532+jye2 os8g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=ZkuzJ17Z; 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=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id n2si3177197edi.564.2020.10.27.23.37.47; Tue, 27 Oct 2020 23:38:09 -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; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=ZkuzJ17Z; 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=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2410956AbgJ0KEM (ORCPT + 99 others); Tue, 27 Oct 2020 06:04:12 -0400 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:52748 "EHLO us-smtp-delivery-124.mimecast.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1732066AbgJ0KEL (ORCPT ); Tue, 27 Oct 2020 06:04:11 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1603793050; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=Wolut7a1c2zX7C+Xumd0b7oYYiNOd60jt9NVhVqZ7rs=; b=ZkuzJ17ZHFMtmGFCAkwPSr0f3SqcerO/RR2Ux94edlpLRfLKq6QOAMw2GKVHsMwo0hg8VD A3QVfz/pQL1uXwL6EzjzZHmLdosr7rG2Gvfa//f4ASB7kxt6ENH7g1TdlgHen2b3r56+Di bW1jipIwl5bmzdnWvBaWyhYQfSiVAJM= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-593-V2zOweY_Oku_7mkWHoK9QQ-1; Tue, 27 Oct 2020 06:04:06 -0400 X-MC-Unique: V2zOweY_Oku_7mkWHoK9QQ-1 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id C649564085; Tue, 27 Oct 2020 10:04:03 +0000 (UTC) Received: from sirius.home.kraxel.org (ovpn-114-66.ams2.redhat.com [10.36.114.66]) by smtp.corp.redhat.com (Postfix) with ESMTP id D56DD5C1BB; Tue, 27 Oct 2020 10:04:02 +0000 (UTC) Received: by sirius.home.kraxel.org (Postfix, from userid 1000) id B769C9D0D; Tue, 27 Oct 2020 11:04:01 +0100 (CET) Date: Tue, 27 Oct 2020 11:04:01 +0100 From: Gerd Hoffmann To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Jonathan Corbet , Daniel Vetter , David Airlie , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v3 25/32] drm: kernel-doc: add description for a new function parameter Message-ID: <20201027100401.j5zmjzk7jwwwq5cn@sirius.home.kraxel.org> References: <9366f48e6e9c3ec2f31a3e68452a2b23a1089fce.1603791716.git.mchehab+huawei@kernel.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <9366f48e6e9c3ec2f31a3e68452a2b23a1089fce.1603791716.git.mchehab+huawei@kernel.org> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Oct 27, 2020 at 10:51:29AM +0100, Mauro Carvalho Chehab wrote: > As reported by "make htmldocs": > > ./drivers/gpu/drm/drm_prime.c:808: warning: Function parameter or member 'dev' not described in 'drm_prime_pages_to_sg' > > Add a description for the new parameter. > > Fixes: 707d561f77b5 ("drm: allow limiting the scatter list size.") > Signed-off-by: Mauro Carvalho Chehab Acked-by: Gerd Hoffmann > --- > drivers/gpu/drm/drm_prime.c | 1 + > 1 file changed, 1 insertion(+) > > diff --git a/drivers/gpu/drm/drm_prime.c b/drivers/gpu/drm/drm_prime.c > index d6808f678db5..9f955f2010c2 100644 > --- a/drivers/gpu/drm/drm_prime.c > +++ b/drivers/gpu/drm/drm_prime.c > @@ -794,6 +794,7 @@ static const struct dma_buf_ops drm_gem_prime_dmabuf_ops = { > > /** > * drm_prime_pages_to_sg - converts a page array into an sg list > + * @dev: DRM device > * @pages: pointer to the array of page pointers to convert > * @nr_pages: length of the page vector > * > -- > 2.26.2 >