From patchwork Fri Jul 15 19:47:59 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Vetter X-Patchwork-Id: 9232515 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id E84A460868 for ; Fri, 15 Jul 2016 19:48:33 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id DC63F2621F for ; Fri, 15 Jul 2016 19:48:33 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id D127526D08; Fri, 15 Jul 2016 19:48:33 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.1 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_MED,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 527AF2621F for ; Fri, 15 Jul 2016 19:48:33 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 44CF76EABB; Fri, 15 Jul 2016 19:48:24 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-wm0-x244.google.com (mail-wm0-x244.google.com [IPv6:2a00:1450:400c:c09::244]) by gabe.freedesktop.org (Postfix) with ESMTPS id 7C28D6EAB3 for ; Fri, 15 Jul 2016 19:48:21 +0000 (UTC) Received: by mail-wm0-x244.google.com with SMTP id o80so3439127wme.0 for ; Fri, 15 Jul 2016 12:48:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=nb7uXpuXSbNVkLoUI9VVwr0Mge8Dsl0bGmXsmYASDDI=; b=S8BsmS/+5+ixN/dnJ2GaKDTSNzk2WhLjLxqLKGEr6Q5nBtqGRleOJWYQEkIVjLvceC 6urzfeJt1sPPkxBddTJNGybSXVlD7UKWYWrH8PZ7QmcQUGo/PsOx1gMfiVplmDeibaTP u2MEc+Qcmedz8zUirIq4NKkTadLT4FSobw9+0= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=nb7uXpuXSbNVkLoUI9VVwr0Mge8Dsl0bGmXsmYASDDI=; b=jDDuCFMg5aj+Mt9B/Re2jEVb41OhS+wJzzwaf0y06fZoVOrtt9ZOBzcNEN0JfuKwT+ yckMpi8kOwz7xWcP/0RLZooHK7dXWiSIp4db8boG29marD/iXdGHbuGWZyCIqko+sqHk 2BF1v/FpI+T5WYiKZnVQRSxq21r4Wt+Vc91vAk4UmPRxlDC4NBaVYWlNjjheaRR5OqvM +Xr64SdOOid1+y6RCJkLEgO3ihakb1N46fqGdea08gHOxOs7HgOvueDHF97ffqo6e0Gr MFO/mtl6BtkSyjuaXxMVwA66dZYY3WgkcjJ+tLWMocnOOrxNoB64jgcjqfh/XlbSKZZY fLSg== X-Gm-Message-State: ALyK8tJcXdntuBfGTzCxTrDQ2CEWh2dyxr1X73zT554Ron6Rd5FIH3xw0ifgs5l/9jKLwA== X-Received: by 10.28.21.140 with SMTP id 134mr43962920wmv.50.1468612098812; Fri, 15 Jul 2016 12:48:18 -0700 (PDT) Received: from phenom.ffwll.local ([2a02:168:56b5:0:ac27:b86c:7764:9429]) by smtp.gmail.com with ESMTPSA id bf3sm2256810wjb.32.2016.07.15.12.48.17 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 15 Jul 2016 12:48:18 -0700 (PDT) From: Daniel Vetter To: DRI Development Subject: [PATCH 02/11] drm/doc: Add kerneldoc for @index Date: Fri, 15 Jul 2016 21:47:59 +0200 Message-Id: <1468612088-9721-2-git-send-email-daniel.vetter@ffwll.ch> X-Mailer: git-send-email 2.8.1 In-Reply-To: <1468612088-9721-1-git-send-email-daniel.vetter@ffwll.ch> References: <1468612088-9721-1-git-send-email-daniel.vetter@ffwll.ch> Cc: Daniel Vetter , Daniel Vetter , Intel Graphics Development 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" X-Virus-Scanned: ClamAV using ClamSMTP Was forgotten when adding them all over. 0-day should complain about new missing kernel-doc, not sure why that wasn't caught/fixed. Cc: Chris Wilson Signed-off-by: Daniel Vetter --- include/drm/drm_crtc.h | 26 +++++++++++++++++++++----- 1 file changed, 21 insertions(+), 5 deletions(-) diff --git a/include/drm/drm_crtc.h b/include/drm/drm_crtc.h index ebf078685f86..656f189f1198 100644 --- a/include/drm/drm_crtc.h +++ b/include/drm/drm_crtc.h @@ -783,7 +783,10 @@ struct drm_crtc { struct drm_plane *primary; struct drm_plane *cursor; - /* position inside the mode_config.list, can be used as a [] idx */ + /** + * @index: Position inside the mode_config.list, can be used as an array + * index. + */ unsigned index; /* position of cursor plane on crtc */ @@ -1210,7 +1213,10 @@ struct drm_encoder { char *name; int encoder_type; - /* position inside the mode_config.list, can be used as a [] idx */ + /** + * @index: Position inside the mode_config.list, can be used as an array + * index. + */ unsigned index; uint32_t possible_crtcs; @@ -1713,7 +1719,10 @@ struct drm_plane { enum drm_plane_type type; - /* position inside the mode_config.list, can be used as a [] idx */ + /** + * @index: Position inside the mode_config.list, can be used as an array + * index. + */ unsigned index; const struct drm_plane_helper_funcs *helper_private; @@ -2321,8 +2330,6 @@ struct drm_mode_config_funcs { * @fb_lock: mutex to protect fb state and lists * @num_fb: number of fbs available * @fb_list: list of framebuffers available - * @num_connector: number of connectors on this device - * @connector_list: list of connector objects * @num_encoder: number of encoders on this device * @encoder_list: list of encoder objects * @num_overlay_plane: number of overlay planes on this device @@ -2397,8 +2404,17 @@ struct drm_mode_config { int num_fb; struct list_head fb_list; + /** + * @num_connector: Number of connectors on this device. + */ int num_connector; + /** + * @connector_ida: ID allocator for connector indices. + */ struct ida connector_ida; + /** + * @connector_list: List of connector objects. + */ struct list_head connector_list; /**