From patchwork Mon Jul 17 21:00:41 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 108025 Delivered-To: patch@linaro.org Received: by 10.140.101.44 with SMTP id t41csp5011050qge; Mon, 17 Jul 2017 14:01:23 -0700 (PDT) X-Received: by 10.99.119.194 with SMTP id s185mr30104589pgc.256.1500325282980; Mon, 17 Jul 2017 14:01:22 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1500325282; cv=none; d=google.com; s=arc-20160816; b=DrbRJicHGirMMKrUow5y1O6PZ958UHy/rkm1nU8INVIU4MYisZNvI9JdzFQ3TZ7lBb VoMPog/Mgkl2XDNXVwc9V3um7W8HrH5ow1Ms+Ik+KaEGSTcxA6WgdS9b9/Mu5FTxM5jt wsZWLDMfXLDjMMN1yT4obMx9RvlFj2gcmiOOCGyKDvksnuWvyy5AbW4jqcVfGTui01aG +1VkZkrd4kozQ4vewlHZbRB81PyhPBq9WpevO7/+XW9SIiX97EYrligvH0QQQFRWNDt1 meW2OLfmb5xYbWmJR9QGPpshi/GQqth2a4iWzBSkMrdNvLk9COSDffR+RJvttyN3vsjr NOvw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:date:subject:cc:to:from :arc-authentication-results; bh=TRrOcNTmFEDuUrW1qs768EzOxTBAb7wqD26anEFdwoM=; b=iUcnA+gja1pbHtwsQNgZRi2pDqXnyk6SSS2QRznzMgNwCCdTetzZKRt8noL0FJr8ea g5MStAJ+bIGyoEiZJCfXpKIFd8k+H55l8fNZIO/05WGEUawHkeSI9Y6CVeHBXsJ++DDR Oeo1eJoMmdYF7CH/8t0oFStufcqdT4f7v7E1b0aBxvZcHbBIgpAhZ7qd9cNorqI464kp vz7Z5kemuFT/RKfm0+BpaJXLqcbyQ8vY3yJg8weeOWuJy3w9a2AQjIk76ktyI/lnOJgl /lCtc6bCItkMpxR5Bj2g5LoQQkVSmCKTvUAk4rqAdlTTecBTH4ZAp7g08Zj1yQdwttfL pf/w== ARC-Authentication-Results: i=1; mx.google.com; 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 Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id h32si155463pld.476.2017.07.17.14.01.21; Mon, 17 Jul 2017 14:01:22 -0700 (PDT) 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; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751396AbdGQVBS (ORCPT + 25 others); Mon, 17 Jul 2017 17:01:18 -0400 Received: from ms.lwn.net ([45.79.88.28]:44398 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751317AbdGQVBQ (ORCPT ); Mon, 17 Jul 2017 17:01:16 -0400 Received: from tpad.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id 1BB5330F; Mon, 17 Jul 2017 21:01:16 +0000 (UTC) From: Jonathan Corbet To: linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Jonathan Corbet Subject: [PATCH 0/7] Documentation warning reduction Date: Mon, 17 Jul 2017 15:00:41 -0600 Message-Id: <20170717210048.16400-1-corbet@lwn.net> X-Mailer: git-send-email 2.9.4 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org I've come to the conclusion that we really need to make the docs build quieter. Here's a small step in that direction: getting rid of all of the "no structured comments found" warnings. Such warnings are usually the result of kerneldoc comments being moved elsewhere, so this took a bit of git archeology to do; hopefully I got it right. Each patch stands alone, so if the DRM folks want to carry the last two themselves, that's fine, just let me know. Jonathan Corbet (7): docs: Get module_init() docs from module.h docs: Do not include kerneldoc comments from kernel/sys.c docs: Do not include from .../seqno-fence.c docs: Get the struct cmbdata kernel doc from the right file docs: Do not include from drivers/scsi/constants.c docs: Do not include from include/drm/drm_color_mgmt.h docs: Use :internal: for include/drm/drm_syncobj.h Documentation/driver-api/basics.rst | 5 +---- Documentation/driver-api/dma-buf.rst | 3 --- Documentation/driver-api/s390-drivers.rst | 2 +- Documentation/driver-api/scsi.rst | 8 -------- Documentation/gpu/drm-kms.rst | 3 --- Documentation/gpu/drm-mm.rst | 2 +- 6 files changed, 3 insertions(+), 20 deletions(-) -- 2.9.4 Acked-by: Daniel Vetter