From patchwork Thu Jun 12 11:53:17 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sricharan R X-Patchwork-Id: 31828 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-yh0-f69.google.com (mail-yh0-f69.google.com [209.85.213.69]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id 786992100A for ; Thu, 12 Jun 2014 12:00:04 +0000 (UTC) Received: by mail-yh0-f69.google.com with SMTP id b6sf4777672yha.4 for ; Thu, 12 Jun 2014 05:00:04 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:delivered-to:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:sender:precedence:list-id :x-original-sender:x-original-authentication-results:mailing-list :list-post:list-help:list-archive:list-unsubscribe:content-type; bh=koTk8+51lbnc4Ycx6Pq9w0PWYu5WX1RIxu146idfGv0=; b=IG15Zp+ty0ZFxZrGbvQseqL/xopyxhJb1dcmNB8kWHCMGb1SSDIVj8PP9RewaEOaQ3 ZProaDmteRX7xoDmF1a2n9MiJzs7dYULeJpYBJSz9kfBgar8YUmXirxGa7PYodRBt5ac XM2arLPv6CkMnG2XOWLFYJQU5uNXWaEkJjBOULlxOG24U6ZNTVTNdzGcJ9pymLtzMJ+J keBW4PojkGq/1Wsf7dFOgZgpRKltvEQWP72X26dp/SMb+hAFezi9uCeMIBNfkAaO7seq ARBv6OdPSqBYw06mJ6h5qDTbwVjMrAPTzdQpR6z+Zez2SOc1kkGHJYEHIOacMiFGP2bd gZHQ== X-Gm-Message-State: ALoCoQnDRwOzB0t7orggDzk8EvLPY9Q9CNpr/EAsYj0Bl1+UF76+FE4jkKSTFobnO8j/r/6cSYWZ X-Received: by 10.52.164.236 with SMTP id yt12mr957032vdb.8.1402574404072; Thu, 12 Jun 2014 05:00:04 -0700 (PDT) X-BeenThere: patchwork-forward@linaro.org Received: by 10.140.42.111 with SMTP id b102ls3045212qga.31.gmail; Thu, 12 Jun 2014 05:00:03 -0700 (PDT) X-Received: by 10.220.92.193 with SMTP id s1mr451951vcm.34.1402574403851; Thu, 12 Jun 2014 05:00:03 -0700 (PDT) Received: from mail-vc0-f169.google.com (mail-vc0-f169.google.com [209.85.220.169]) by mx.google.com with ESMTPS id cx18si237724vec.89.2014.06.12.05.00.03 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 12 Jun 2014 05:00:03 -0700 (PDT) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.220.169 as permitted sender) client-ip=209.85.220.169; Received: by mail-vc0-f169.google.com with SMTP id la4so660692vcb.14 for ; Thu, 12 Jun 2014 05:00:03 -0700 (PDT) X-Received: by 10.58.229.101 with SMTP id sp5mr203378vec.42.1402574403740; Thu, 12 Jun 2014 05:00:03 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.221.54.6 with SMTP id vs6csp397312vcb; Thu, 12 Jun 2014 05:00:03 -0700 (PDT) X-Received: by 10.68.129.68 with SMTP id nu4mr12037945pbb.76.1402574402988; Thu, 12 Jun 2014 05:00:02 -0700 (PDT) Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id ps5si41372153pbb.80.2014.06.12.05.00.02; Thu, 12 Jun 2014 05:00:02 -0700 (PDT) Received-SPF: none (google.com: linux-kernel-owner@vger.kernel.org does not designate permitted sender hosts) client-ip=209.132.180.67; Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933955AbaFLL7s (ORCPT + 27 others); Thu, 12 Jun 2014 07:59:48 -0400 Received: from arroyo.ext.ti.com ([192.94.94.40]:60480 "EHLO arroyo.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933677AbaFLL4i (ORCPT ); Thu, 12 Jun 2014 07:56:38 -0400 Received: from dlelxv90.itg.ti.com ([172.17.2.17]) by arroyo.ext.ti.com (8.13.7/8.13.7) with ESMTP id s5CBu5o1016329; Thu, 12 Jun 2014 06:56:05 -0500 Received: from DFLE72.ent.ti.com (dfle72.ent.ti.com [128.247.5.109]) by dlelxv90.itg.ti.com (8.14.3/8.13.8) with ESMTP id s5CBu58m029637; Thu, 12 Jun 2014 06:56:05 -0500 Received: from dflp32.itg.ti.com (10.64.6.15) by DFLE72.ent.ti.com (128.247.5.109) with Microsoft SMTP Server id 14.3.174.1; Thu, 12 Jun 2014 06:56:05 -0500 Received: from uda0393807.india.ti.com. (ileax41-snat.itg.ti.com [10.172.224.153]) by dflp32.itg.ti.com (8.14.3/8.13.8) with ESMTP id s5CBtEbw008910; Thu, 12 Jun 2014 06:56:00 -0500 From: Sricharan R To: , , , CC: , , , , , , , Subject: [PATCH V2 09/19] irqchip: crossbar: fix kerneldoc warning Date: Thu, 12 Jun 2014 17:23:17 +0530 Message-ID: <1402574007-13987-10-git-send-email-r.sricharan@ti.com> X-Mailer: git-send-email 1.7.9.5 In-Reply-To: <1402574007-13987-1-git-send-email-r.sricharan@ti.com> References: <1402574007-13987-1-git-send-email-r.sricharan@ti.com> MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: list List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: r.sricharan@ti.com X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.220.169 as permitted sender) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , From: Nishanth Menon kernel doc style is wrong in code. fix it to squelch kerneldoc warnings: Warning(drivers/irqchip/irq-crossbar.c:27): missing initial short description on line: * struct crossbar_device: crossbar device description Info(drivers/irqchip/irq-crossbar.c:27): Scanning doc for struct Warning(drivers/irqchip/irq-crossbar.c:39): No description found for parameter 'write' Warning(drivers/irqchip/irq-crossbar.c:42): missing initial short description on line: * struct crossbar_data: Platform specific data Info(drivers/irqchip/irq-crossbar.c:42): Scanning doc for struct Warning(drivers/irqchip/irq-crossbar.c:50): No description found for parameter 'safe_map' 4 warnings Signed-off-by: Nishanth Menon --- drivers/irqchip/irq-crossbar.c | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/drivers/irqchip/irq-crossbar.c b/drivers/irqchip/irq-crossbar.c index 58790d4..7d4db07 100644 --- a/drivers/irqchip/irq-crossbar.c +++ b/drivers/irqchip/irq-crossbar.c @@ -23,11 +23,13 @@ #define IRQ_SKIP -3 #define GIC_IRQ_START 32 -/* +/** + * struct crossbar_device - crossbar device descriptio * @int_max: maximum number of supported interrupts * @irq_map: array of interrupts to crossbar number mapping * @crossbar_base: crossbar base address * @register_offsets: offsets for each irq number + * @write: register write function pointer */ struct crossbar_device { uint int_max; @@ -39,9 +41,10 @@ struct crossbar_device { }; /** - * struct crossbar_data: Platform specific data + * struct crossbar_data - Platform specific data * @irqs_unused: array of irqs that cannot be used because of hw erratas * @size: size of the irqs_unused array + * @safe_map: safe value to write to crossbar register */ struct crossbar_data { const uint *irqs_unused;