Received: by 2002:a25:c205:0:0:0:0:0 with SMTP id s5csp4657808ybf; Wed, 4 Mar 2020 08:10:09 -0800 (PST) X-Google-Smtp-Source: ADFU+vt1MEnGPkVFQKdBXSF6iyzEfwpXIDKu37BXujH/px38IW2FcV1BCkgxXbQKwPwKTkOv5ncn X-Received: by 2002:aca:3d7:: with SMTP id 206mr2275352oid.98.1583338209460; Wed, 04 Mar 2020 08:10:09 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1583338209; cv=none; d=google.com; s=arc-20160816; b=AL55S3sLIXMLRAycRTx67mPntOcrDaa1vO6raqlESH+2SCsX6UGxQ//OL8K9enzcZI CuA9MO13V+nNalLMkbS/H48B+chME0EkLzI/3jRlfAAmsyYOsPsJgwE3XAWDVWn36b1L 24xHoYF6+xJR9fy2uCBuFADSDfOGDv3aMtUHVUOkyI1hov6PZm2Ik0Va+QhE/zU6oiEm OFS3Fgj8Z+7NrLd0Uez1UmlitstWpL5j3XQUPYmcdq0na9u2FP9I2zLGea/7ci17x3M7 QeWAwwGUj2XGd2uGqHIfaZyVffy+1B+ZAPz+EfO+Qk1/VAoob55Xoar1/xSiwzFwV7B6 /8AA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:dkim-signature; bh=O1TPPQdcdHvad52oa9e1eaBSfICW/64mgOwAr43XQg4=; b=XkDJq9I7cUgPoIK1iafLi0eYeERBx0SsEPyBk9TRaiKEmaSa2wgq8V+k1yCEGrrod2 qP8Aic3bmjGXda9MDb+r9I0RUOhHTT7W9ufvWYq6QMaparAMnGkpafO5fr1pLJ7aXz3f cztxFOi5PWg6awP8/pd2Z4OmyTDEjpYikEkQKzBS46HsV5+rUlUKO4HKaf45+eIbRIT0 wCyilLHUps3mcpKDxUsauQxcJaOVRKypEErT06na8nRbb4hs3MCWAOaEKtRHD4YSmlHz vAF9nRECj/EngJa9wRbaRfF1Xbr6sJ//Evi5NjUDF6eznwc4jUwXVmfCcH+GRAKy8z63 ktAw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=b0Bm2nns; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id a22si1374003otp.84.2020.03.04.08.09.56; Wed, 04 Mar 2020 08:10:09 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=b0Bm2nns; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729879AbgCDQIc (ORCPT + 99 others); Wed, 4 Mar 2020 11:08:32 -0500 Received: from mail-vk1-f193.google.com ([209.85.221.193]:35524 "EHLO mail-vk1-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728278AbgCDQIc (ORCPT ); Wed, 4 Mar 2020 11:08:32 -0500 Received: by mail-vk1-f193.google.com with SMTP id r5so715011vkf.2 for ; Wed, 04 Mar 2020 08:08:31 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=O1TPPQdcdHvad52oa9e1eaBSfICW/64mgOwAr43XQg4=; b=b0Bm2nnsjkT2KC7lNWy0bvOY7WZB9B5kjiGTGYB/UftpLH0F+BrFQhzmGsQ6ZFX4Cr fHVZdc71lS2P8koutRJRnvZ9U9wvn/+IH/Osw4Ic7VRZfiNb12rmKZFRUhvq27VVHvZm HCqvxHWu2Q5dsvdfVb1rsHrHOd9ILczUbDPCbKFvlr3xkc+xkM/5J3rEPi3sqfr0VFK6 OUQBVRooKCC4ieXUuaEz8ssSa+zhx7qSdj9rvqhrie7AMwO5gpRB7UPYPXGQhLafgBwk NieAFPB3KtCnxthjnEqdEIXzx2YOa9U/gCQ2fDDiR795wCf3QDeC4Y2E5yetJOhl+9wq fjrQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=O1TPPQdcdHvad52oa9e1eaBSfICW/64mgOwAr43XQg4=; b=lHDTfhWxvxMmJYkwpFZ0eIwdk0Yc+dgHRvdpWNaakDgIKR+2DgSOZroLBRj0klnun1 LKl4zDtDnCxpymeFrpMvJD3/OJgwbK/LxRm9BbgfC0Vm3WaN7Z1ssWINNUmZK53/gaAu t2OVv/IMkKzYCsskVqPS2RbjuGEVvwang+qwQb6TZgjtb477IDmojaVAyRqz1zlSfL+v J6sNRIyBv1o2OW+qKFGe7H8Xylx1K0eV+boRi9DN5F7FO3urED3M5+SmFi4ofGWQNPNj bKWemcyG2sKFU23VQg1xVFeJ2em/O/coQ+l0Xow+npn7YLSzit1LdTUZnFOiVhfKJ89s qK2g== X-Gm-Message-State: ANhLgQ2Sh7QTHs599Zkvfr0k/i/OF+475GWw/+xb2PkOBso04xFgUKZc qrH5r69tnGX79BGLtzUBk3i+8zPSqIJm0NYqx0o= X-Received: by 2002:a1f:9d16:: with SMTP id g22mr1793743vke.22.1583338111113; Wed, 04 Mar 2020 08:08:31 -0800 (PST) MIME-Version: 1.0 References: <20200131092147.32063-1-benjamin.gaignard@st.com> In-Reply-To: <20200131092147.32063-1-benjamin.gaignard@st.com> From: Emil Velikov Date: Wed, 4 Mar 2020 16:07:55 +0000 Message-ID: Subject: Re: [PATCH] gpu: drm: context: Clean up documentation To: Benjamin Gaignard Cc: Maarten Lankhorst , Maxime Ripard , Dave Airlie , Daniel Vetter , "Linux-Kernel@Vger. Kernel. Org" , ML dri-devel Content-Type: text/plain; charset="UTF-8" Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, 3 Feb 2020 at 08:11, Benjamin Gaignard wrote: > > Fix kernel doc comments to avoid warnings when compiling with W=1. > > Signed-off-by: Benjamin Gaignard > --- > drivers/gpu/drm/drm_context.c | 145 ++++++++++++++++++------------------------ > 1 file changed, 61 insertions(+), 84 deletions(-) > Since we're talking about legacy, aka user mode-setting code, I think a wiser solution is to simply remove the documentation. It is _not_ something we should encourage people to read, let alone use. Nit: prefix should be "drm:" -Emil