From patchwork Mon Jul 17 21:00:42 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 108031 Delivered-To: patch@linaro.org Received: by 10.140.101.44 with SMTP id t41csp5011678qge; Mon, 17 Jul 2017 14:01:54 -0700 (PDT) X-Received: by 10.84.231.140 with SMTP id g12mr32703174plk.256.1500325314707; Mon, 17 Jul 2017 14:01:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1500325314; cv=none; d=google.com; s=arc-20160816; b=Y+I/uClFEbDUoX4DTTHnr5spkzD7iD6bDPnm8O0JmGq4feFMB7D3jj19XorgnZFHlX NgYRTLv8cCVQR2NzrAZnWMYeWmkmluWfb7rJEQ3+49jlWrojRrrMIrVi7ubW5qgjhyOt 6ea+2Blrdh0VuiattQeDGCI1lU/++uibRAJGALlWmba16iffhem+nve0k4kJAHBRTt8K yE2HLTaQZ0H4n2X5YLB38w1cqgsGl+xlC+BT3EzNCb1Q5xZ66RyEa7G6K51Wi7qHOJvp 2pxvhyKYPexwOrRysUP+RCIMGwfc988GpZ4zdt3vmE0C60UPWvLx4Bjit9AM05XT9BQR ZYuQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:cc:references:in-reply-to:message-id:date :subject:to:from:delivered-to:arc-authentication-results; bh=Y15PrsCUHAan547sCQB7vrzCSd8bB2Ycqf+1AUBy4WE=; b=UVAplRUOXq/1vbhLktMDx2xkrbtW1BFDYs7VqrHXG3/QB8XEmjnTiFqnq4FN0Fi3Bb eeZL2tNKZSgg2b2Kta+GQ0vj/dPAHVnu0SwBG/VhEE/NjcgjpuRE8C6bO9aSo9TggBKd vNwsutGw6rZa32P52hMjGQ6v1NH5mCvbnwOjJepOicsKzWucN9coqAnLDhYyoUnG8xJS GlvXQwNgMl8E4Z+b0PBbUJlSHVT0HrvYwDqct8rSCNI7CmC7XerUeQNdavpispXRV78M KqK5Vgbb8X8iWg690VgQmSZIKR1M4Dd6D9PzPjHq9TcMuvvvpoNZfyW8/8g83p8rwQAQ uVXg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Return-Path: Received: from gabe.freedesktop.org (gabe.freedesktop.org. [131.252.210.177]) by mx.google.com with ESMTPS id f15si180890pfj.33.2017.07.17.14.01.54 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 17 Jul 2017 14:01:54 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) client-ip=131.252.210.177; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 5E3576E29E; Mon, 17 Jul 2017 21:01:22 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by gabe.freedesktop.org (Postfix) with ESMTPS id C17A86E297 for ; Mon, 17 Jul 2017 21:01:20 +0000 (UTC) Received: from tpad.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id 614DA2B9; Mon, 17 Jul 2017 21:01:20 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Subject: [PATCH 1/7] docs: Get module_init() docs from module.h Date: Mon, 17 Jul 2017 15:00:42 -0600 Message-Id: <20170717210048.16400-2-corbet@lwn.net> X-Mailer: git-send-email 2.9.4 In-Reply-To: <20170717210048.16400-1-corbet@lwn.net> References: <20170717210048.16400-1-corbet@lwn.net> Cc: linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Jonathan Corbet X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" The docs build complains: ./include/linux/init.h:1: warning: no structured comments found The problem is that the comments in question were moved to module.h in commit 0fd972a7d91d (module: relocate module_init from init.h to module.h). Fix basics.rst to match. Signed-off-by: Jonathan Corbet --- Documentation/driver-api/basics.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/driver-api/basics.rst b/Documentation/driver-api/basics.rst index ab82250c7727..cbfb5a825077 100644 --- a/Documentation/driver-api/basics.rst +++ b/Documentation/driver-api/basics.rst @@ -4,7 +4,7 @@ Driver Basics Driver Entry and Exit points ---------------------------- -.. kernel-doc:: include/linux/init.h +.. kernel-doc:: include/linux/module.h :internal: Driver device table From patchwork Mon Jul 17 21:00:43 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 108026 Delivered-To: patch@linaro.org Received: by 10.140.101.44 with SMTP id t41csp5011053qge; Mon, 17 Jul 2017 14:01:23 -0700 (PDT) X-Received: by 10.101.90.3 with SMTP id y3mr30568123pgs.185.1500325283144; Mon, 17 Jul 2017 14:01:23 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1500325283; cv=none; d=google.com; s=arc-20160816; b=HcolRWzv3PZjTAyaeqpMx9X/9xPFfgklSqjfiAzoCM6t8mGBrvL68dgDlqpLEOcXb0 vcdCV/iMzRdC2vskJQqLTxxi45KRpvojJZ9Fs2Lde2xbhdlbqiak0QvmFf5zGROZkWjK oCM1VN93qdCc+5EVw8Yxfdv4/QIUE8LJ7LmfqQDkSGvEioqEc/giP+DdcoK30s+3x4YW DNzjsY5IWb0c6Ail1gD0hqQzp0dFYpxx+22q1XLbK8Q0bD16tYNaQSpbaUqH/FfDjVEF 3XO9PqnUn7/8iWG89jJepKCdX+4atzNGEHuFDjf/xVFn4wEEjQ+sZxuoRASKE05FFN2Y KeQg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:cc:references:in-reply-to:message-id:date :subject:to:from:delivered-to:arc-authentication-results; bh=RjHn6GliF3FzstD8qhRj2p6z8zP2aVaG3LyBtd+Edpw=; b=RbWPjJxbp9H3f85dST6OqyiA0aYxU/7OtepHRmq6Zhf2hCAmXhjgMOFg1utk/xAHug mLFJQ68g1AdGruGNzhkZg7N2zRXhQVvMEIGZMWdjn4Yg/kLkebqfviwr1trFXskE/rXg PYZfjXSuO0BsEGa0N0qtu+SZsTPCZyxk7nNJqm3zq6Cv/hICvW/hR5GkhN5t8s+E+vYM IyChfx47O5QmvzoxPgnMLmWt6339hx/o7zfnS2r5i9PSYtvQLPXIJnSXdzTPGOaNebEX lKBBcE8/9SDzczwW3QLrPuPgmZ4J6vyiVbQ6c6fwW6XQeNn+LLwaAfQAgYLF+mK03pqh eGqQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Return-Path: Received: from gabe.freedesktop.org (gabe.freedesktop.org. [131.252.210.177]) by mx.google.com with ESMTPS id t67si152746pfb.447.2017.07.17.14.01.22 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 17 Jul 2017 14:01:23 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) client-ip=131.252.210.177; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 4C7E26E297; Mon, 17 Jul 2017 21:01:22 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by gabe.freedesktop.org (Postfix) with ESMTPS id 1C77E6E297 for ; Mon, 17 Jul 2017 21:01:21 +0000 (UTC) Received: from tpad.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id A81D819B9; Mon, 17 Jul 2017 21:01:20 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Subject: [PATCH 2/7] docs: Do not include kerneldoc comments from kernel/sys.c Date: Mon, 17 Jul 2017 15:00:43 -0600 Message-Id: <20170717210048.16400-3-corbet@lwn.net> X-Mailer: git-send-email 2.9.4 In-Reply-To: <20170717210048.16400-1-corbet@lwn.net> References: <20170717210048.16400-1-corbet@lwn.net> Cc: linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Jonathan Corbet X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" ...because there are none there, and I cannot figure out what would ever have been of interest there. This eliminates this warning: ./kernel/sys.c:1: warning: no structured comments found from the build. Signed-off-by: Jonathan Corbet --- Documentation/driver-api/basics.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/Documentation/driver-api/basics.rst b/Documentation/driver-api/basics.rst index cbfb5a825077..73fa7d42bbba 100644 --- a/Documentation/driver-api/basics.rst +++ b/Documentation/driver-api/basics.rst @@ -103,9 +103,6 @@ Kernel utility functions .. kernel-doc:: kernel/panic.c :export: -.. kernel-doc:: kernel/sys.c - :export: - .. kernel-doc:: kernel/rcu/tree.c :export: From patchwork Mon Jul 17 21:00:44 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 108028 Delivered-To: patch@linaro.org Received: by 10.140.101.44 with SMTP id t41csp5011142qge; Mon, 17 Jul 2017 14:01:27 -0700 (PDT) X-Received: by 10.84.254.73 with SMTP id a9mr3556006pln.69.1500325287821; Mon, 17 Jul 2017 14:01:27 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1500325287; cv=none; d=google.com; s=arc-20160816; b=rvMjblcSNZXN1ODqzbLD56YdfkRJgYvTp8CiNGkNjYQVay1zrPmOeS3/vDWHe9QzkN QPQVAm6kOBltS/ekUPn4TayaubO1U7e0nwB7d+QCt0ytEhCAdJOUtPOPCT+PK16gxSj0 W1pKM8IQ+FfB75nQuj29oR494RzklmCNYhwj4DcmBLOgE/MJMb6LV9IPl/3g8HeQTkoN +4Wjb/0xuqt58KmX/I8F8wkjcBi0A8Ym3NEEG6pHGpNR84WDTw/4u+9QAPQ4FwgCHdda Gjc3kvBFp4nndt66KZbqqRWSdiIh5/xMDdCxzAMyprg0DP4zgtOAyq+YIslb2vlgzOFT TMvw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:cc:references:in-reply-to:message-id:date :subject:to:from:delivered-to:arc-authentication-results; bh=F28gt9whj92dGr7lYZ7dBySc5SuicNdYCfa4Y3bufm4=; b=HAcTx+GzNdvlSTL9eNLPVJXRw5MsUOFLbEwXpbb3r6c7g7tywIDxUD+PPUtuSw5Pdl 4wwfrgLy3LKlpd3vrSe9gOI9TvWEYLvTLWuZKTUh0xE9g2pMoxkaGZovdtJ5Y/LBvVKe 2FYn2IT5/DbG5PYR896Nvc8g9wGUA21e57Nl0zv9rDM7KWlYerC6rRgYmtp5DpnhoOBb OLbBIJikHfzQrcOglLq11sZdyIfxLQAjVQc7Av2p2CxcBteTUhSvWcUo2Imy2opqjBcR mGeadwndUI6N4oZETe+QVnKbO70g3X0xfvKsc/6P9iBHyrIJdjHtA7sevfBz2dsJhdFA 3++w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Return-Path: Received: from gabe.freedesktop.org (gabe.freedesktop.org. [131.252.210.177]) by mx.google.com with ESMTPS id k6si183133pgr.16.2017.07.17.14.01.27 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 17 Jul 2017 14:01:27 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) client-ip=131.252.210.177; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 545DF6E2A3; Mon, 17 Jul 2017 21:01:24 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by gabe.freedesktop.org (Postfix) with ESMTPS id 6C4396E297 for ; Mon, 17 Jul 2017 21:01:21 +0000 (UTC) Received: from tpad.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id 034E830F; Mon, 17 Jul 2017 21:01:20 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Subject: [PATCH 3/7] docs: Do not include from .../seqno-fence.c Date: Mon, 17 Jul 2017 15:00:44 -0600 Message-Id: <20170717210048.16400-4-corbet@lwn.net> X-Mailer: git-send-email 2.9.4 In-Reply-To: <20170717210048.16400-1-corbet@lwn.net> References: <20170717210048.16400-1-corbet@lwn.net> Cc: linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Jonathan Corbet X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" There are no kerneldoc comments in drivers/dma-buf/seqno-fence.c, and it appears there never have been. Stop looking for comments there to eliminate this warning: ./drivers/dma-buf/seqno-fence.c:1: warning: no structured comments found Signed-off-by: Jonathan Corbet --- Documentation/driver-api/dma-buf.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/Documentation/driver-api/dma-buf.rst b/Documentation/driver-api/dma-buf.rst index 31671b469627..dc384f2f7f34 100644 --- a/Documentation/driver-api/dma-buf.rst +++ b/Documentation/driver-api/dma-buf.rst @@ -139,9 +139,6 @@ DMA Fences Seqno Hardware Fences ~~~~~~~~~~~~~~~~~~~~~ -.. kernel-doc:: drivers/dma-buf/seqno-fence.c - :export: - .. kernel-doc:: include/linux/seqno-fence.h :internal: From patchwork Mon Jul 17 21:00:46 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 108030 Delivered-To: patch@linaro.org Received: by 10.140.101.44 with SMTP id t41csp5011329qge; Mon, 17 Jul 2017 14:01:38 -0700 (PDT) X-Received: by 10.99.146.13 with SMTP id o13mr30223008pgd.54.1500325297915; Mon, 17 Jul 2017 14:01:37 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1500325297; cv=none; d=google.com; s=arc-20160816; b=C4Yel4MX4kPYMAb/o16wp3Hzz3PSISrhPx+aju+ba24/b0dULPcwxQ2pJqYBk/AIqk 6C+Kf6hLGwjs6QRHpL7do6VFO4otor/B0eGGfVntIrrLez0WnYNxJjWi7W/lmjLQ+Los WJNnAs974iMVhACK5thQokaW6nRoQYLJshhqFRADlvO1RoOVv+6O1zKO8T0F4X6KO165 gdI2NsMpi5NGP8qmbw+/1Pk1YMaoR2Rwq5qFZsDAkn7ytD4HR1kPvh1sYHHDzrWaeftE wqkP+nao/1FwU8WncAQp4FxcJIM9XyjE0pAQtngePzOl/Cpv+iX9DnlL/TeUVVaBXmhL d+FA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:cc:references:in-reply-to:message-id:date :subject:to:from:delivered-to:arc-authentication-results; bh=l/jJk48MNYelqOeLAn2cQZCbpbe4rMlzTUCgFJhlQOw=; b=K6wf2ZYU1XoRvEOngUw0LDP3jBlSKxN0f5G2LzKjy1iAbfhS5pzkSWhlPxUeosDqqk BVMVl83A5bPQGUm1hoposWaE5mMMfzCqWszo9UmQD8T/WTnlIlnUjw5zQk7zq+2AmGSl IYAmGlgPXSQvZJ7sT2ujioFnUWHMcJ6005VnvgqAFCyHf9DwTI0l28LEusqYhoFofYOM Pha+H/f3VSkrdC3pJLF0yn51E/J8xx5zkHrnmjuHVC5FjSdKST61r97pRDhxKVu3XYRa oaMKEfNaJvGofsDpS+ACg4S8IcSbXGUk+qiw2JWPFH3lMo2os8rXwk/PEsGrrq2QjqRj 0lPA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Return-Path: Received: from gabe.freedesktop.org (gabe.freedesktop.org. [131.252.210.177]) by mx.google.com with ESMTPS id b129si164582pgc.310.2017.07.17.14.01.37 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 17 Jul 2017 14:01:37 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) client-ip=131.252.210.177; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id D3DE46E2AF; Mon, 17 Jul 2017 21:01:27 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by gabe.freedesktop.org (Postfix) with ESMTPS id 0E8026E297 for ; Mon, 17 Jul 2017 21:01:22 +0000 (UTC) Received: from tpad.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id A2A6A19BA; Mon, 17 Jul 2017 21:01:21 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Subject: [PATCH 5/7] docs: Do not include from drivers/scsi/constants.c Date: Mon, 17 Jul 2017 15:00:46 -0600 Message-Id: <20170717210048.16400-6-corbet@lwn.net> X-Mailer: git-send-email 2.9.4 In-Reply-To: <20170717210048.16400-1-corbet@lwn.net> References: <20170717210048.16400-1-corbet@lwn.net> Cc: linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Jonathan Corbet X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" The only function of interest in that file was scsi_print_status(). That function was removed in commit 7ac7076344d9 (scsi: remove scsi_print_status()) but the docs were not changed to match, yielding this warning: ./drivers/scsi/constants.c:1: warning: no structured comments found There's nothing there anymore, so just remove that section from the docs. Signed-off-by: Jonathan Corbet --- Documentation/driver-api/scsi.rst | 8 -------- 1 file changed, 8 deletions(-) diff --git a/Documentation/driver-api/scsi.rst b/Documentation/driver-api/scsi.rst index 859fb672319f..5a2aa7a377d9 100644 --- a/Documentation/driver-api/scsi.rst +++ b/Documentation/driver-api/scsi.rst @@ -224,14 +224,6 @@ mid to lowlevel SCSI driver interface .. kernel-doc:: drivers/scsi/hosts.c :export: -drivers/scsi/constants.c -~~~~~~~~~~~~~~~~~~~~~~~~ - -mid to lowlevel SCSI driver interface - -.. kernel-doc:: drivers/scsi/constants.c - :export: - Transport classes ----------------- From patchwork Mon Jul 17 21:00:47 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 108029 Delivered-To: patch@linaro.org Received: by 10.140.101.44 with SMTP id t41csp5011188qge; Mon, 17 Jul 2017 14:01:30 -0700 (PDT) X-Received: by 10.98.96.66 with SMTP id u63mr21222579pfb.68.1500325290264; Mon, 17 Jul 2017 14:01:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1500325290; cv=none; d=google.com; s=arc-20160816; b=LrqsE8sZgA/wzRRj/4yGJxYBljcNu/JD3fG7vzRDiMbtut9m1BZPJjB0Ox2F2WNNO4 CzhxxUt5GiyiV8ASnvdshuAAqcKqMQ4mBsm1EoEy0q5t9bAopJmGvgyrmPoX673owgWr sjdinQJpqQRjUQhURgR5L6HjqLAOv0fBRq4+1p/pOHARYxTWNNbfzSG8lDJfUlcarpxN hs8OmBUTe+DCKH9Lz3HSSiyWaR1kqrcgvQsJKbyoZcGW4ScZt5bMwTRdZ2xH7KTyyfaW qXYi2O/6pmhuitA/M9BOIvOmqX92YxFoniqkQfnXoHyW/85iZgLU33r6laEDYkdlH3bz yCVw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:cc:references:in-reply-to:message-id:date :subject:to:from:delivered-to:arc-authentication-results; bh=Ceyu+zWkHt1AkI/4jSgUXxCS5a48Ktjrxuq140YXG4k=; b=hAIz+WZjY7B+ZZGTZYX5SkJzaZisdyDSmKQpunen/Q7OO7YLvDLTUxzmFkAg7ojSqN GWGgZ3Uc4CMOK8vU22ljke/sVPRpQ0ojLkkj9YC8AG9Q3KhtDuGKcDyzCBxFyRLtmU0e JqSg8xhiqqYUHNw+JRXOnqNQCIbaCMNhlz1Bo4nzl3IBKrZHHSO535yptcqsw06W+i22 kTRVt52SA0EREEn/p0HnK6I0lLzt4BXwluHiSchtrEOgGD8DJ9KxjSd0ejkRFLRBqB13 YMwt23Llv8HguC9BhuiiHZH9TAxFqwDe7tboPeACyTBi2Pwkbu/0SZx2ZfjVkEupr0S1 zV4w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Return-Path: Received: from gabe.freedesktop.org (gabe.freedesktop.org. [131.252.210.177]) by mx.google.com with ESMTPS id s16si177765pfe.76.2017.07.17.14.01.30 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 17 Jul 2017 14:01:30 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) client-ip=131.252.210.177; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 7171B6E2A6; Mon, 17 Jul 2017 21:01:24 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by gabe.freedesktop.org (Postfix) with ESMTPS id 60B1E6E29F for ; Mon, 17 Jul 2017 21:01:22 +0000 (UTC) Received: from tpad.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id EA0DE2B9; Mon, 17 Jul 2017 21:01:21 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Subject: [PATCH 6/7] docs: Do not include from include/drm/drm_color_mgmt.h Date: Mon, 17 Jul 2017 15:00:47 -0600 Message-Id: <20170717210048.16400-7-corbet@lwn.net> X-Mailer: git-send-email 2.9.4 In-Reply-To: <20170717210048.16400-1-corbet@lwn.net> References: <20170717210048.16400-1-corbet@lwn.net> Cc: linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Jonathan Corbet X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" Commit 8f2e045ec878 (drm/color: un-inline drm_color_lut_extract()) moved the only kerneldoc comment out of include/drm/drm_color_mgmt.h, leading to this warning: ./include/drm/drm_color_mgmt.h:1: warning: no structured comments found That comment is already picked up in drm_color_mgmt.c, so just delete the directive. CC: dri-devel@lists.freedesktop.org Signed-off-by: Jonathan Corbet --- Documentation/gpu/drm-kms.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/Documentation/gpu/drm-kms.rst b/Documentation/gpu/drm-kms.rst index 2d77c9580164..0749000ab3d7 100644 --- a/Documentation/gpu/drm-kms.rst +++ b/Documentation/gpu/drm-kms.rst @@ -523,9 +523,6 @@ Color Management Properties .. kernel-doc:: drivers/gpu/drm/drm_color_mgmt.c :doc: overview -.. kernel-doc:: include/drm/drm_color_mgmt.h - :internal: - .. kernel-doc:: drivers/gpu/drm/drm_color_mgmt.c :export: From patchwork Mon Jul 17 21:00:48 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 108027 Delivered-To: patch@linaro.org Received: by 10.140.101.44 with SMTP id t41csp5011117qge; Mon, 17 Jul 2017 14:01:26 -0700 (PDT) X-Received: by 10.84.133.226 with SMTP id f89mr32014046plf.11.1500325285976; Mon, 17 Jul 2017 14:01:25 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1500325285; cv=none; d=google.com; s=arc-20160816; b=J42ZFFzvgBIAwpxU7MYqGClruZrou7tOjIVSLBlq0RcZRlTS9vj0I6sSHjgpiR+spH rVDgvLPjMaZwdxgRRhqhTbX2BqcuQTxzCq42517LJhl+5RylPvBXpGxfoC9p0e1z08Ri +Hi+rkTt6MmWDcui4KSAiu0p+wZEvX6I6mk1DSA/XoKJeonr9bimK/MRFhbZlM+plnR5 AS2eSrJWGnSvS25/HRl9ALDre47Kivo0n3t3Hsk6MxiunR9C+uG07ayTz0x0nGkWomD3 9e7KRGOAzfpC1TrdXH7ssSeWoRDJl+Bev9tSt7NTAjYTIbHv4w5F78LsNyKvPQdLm/6I i2wg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:cc:references:in-reply-to:message-id:date :subject:to:from:delivered-to:arc-authentication-results; bh=e7+rCVwlo0U/7EqykyKBJtRoQik65WhUOm+NT6zTV+o=; b=T++CwaxlFSwsdVcQLI0KbHXTxgJvyRZaDKyuVHwbbqezwofZQxVX1gWEEMLrXeTw7P hNfNKoyoDLrzvPqHOuVvEtB/67b7HlecTfZffNVYtzDz45ESq/84jb+8oZyACJygKI/1 5XwHE/3pfQqGXMJWK8C3dAiOPI+dhYbBAafsybSJ3F/XggQi0HxDM5ZXT+pe7qixRDi3 5AUzmC4/gcEei0TlBC3VTGhKEoQ+A+6eC+mIBhxsCwCPS+xr5YqKlcaN5OMHglRlAvZl j9IBig9ScYcwKDXbXatICw+HebJVuZdOGCp7d/YbLRZaKA8b02zxvTOKQ/STfxH3TIVZ dY6w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Return-Path: Received: from gabe.freedesktop.org (gabe.freedesktop.org. [131.252.210.177]) by mx.google.com with ESMTPS id 66si164303plb.428.2017.07.17.14.01.25 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 17 Jul 2017 14:01:25 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) client-ip=131.252.210.177; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id B549C6E2A4; Mon, 17 Jul 2017 21:01:23 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by gabe.freedesktop.org (Postfix) with ESMTPS id AC9936E2A1 for ; Mon, 17 Jul 2017 21:01:22 +0000 (UTC) Received: from tpad.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id 446BA19BC; Mon, 17 Jul 2017 21:01:22 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Subject: [PATCH 7/7] docs: Use :internal: for include/drm/drm_syncobj.h Date: Mon, 17 Jul 2017 15:00:48 -0600 Message-Id: <20170717210048.16400-8-corbet@lwn.net> X-Mailer: git-send-email 2.9.4 In-Reply-To: <20170717210048.16400-1-corbet@lwn.net> References: <20170717210048.16400-1-corbet@lwn.net> Cc: linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Jonathan Corbet X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" Documentation/gpu/drm-mm.rst includes from include/drm/drm_syncobj.h with :export:, but this is a header file without export directives. That results in this warning: ./include/drm/drm_syncobj.h:1: warning: no structured comments found ...and a failure to obtain the documentation from that file. Switch to :internal: instead to make both problems go away. Cc: dri-devel@lists.freedesktop.org Signed-off-by: Jonathan Corbet --- Documentation/gpu/drm-mm.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/gpu/drm-mm.rst b/Documentation/gpu/drm-mm.rst index 9412798645c1..300898298bf6 100644 --- a/Documentation/gpu/drm-mm.rst +++ b/Documentation/gpu/drm-mm.rst @@ -492,7 +492,7 @@ DRM Sync Objects :doc: Overview .. kernel-doc:: include/drm/drm_syncobj.h - :export: + :internal: .. kernel-doc:: drivers/gpu/drm/drm_syncobj.c :export: