From patchwork Thu Jun 20 08:11:27 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Srinivas Kandagatla X-Patchwork-Id: 167306 Delivered-To: patch@linaro.org Received: by 2002:a92:4782:0:0:0:0:0 with SMTP id e2csp1759064ilk; Thu, 20 Jun 2019 01:11:51 -0700 (PDT) X-Google-Smtp-Source: APXvYqwqOHJq6AZLz0i0ffFMit6GnVwswIO+o+CLPE5hNBW7ebtJyPHCJ1O2y+oAbZ6nUv/f0aCm X-Received: by 2002:a17:90a:b00b:: with SMTP id x11mr1813703pjq.120.1561018311673; Thu, 20 Jun 2019 01:11:51 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1561018311; cv=none; d=google.com; s=arc-20160816; b=KAYfJ5BMCW1+O0CLjRGnk8br3qCcKMbwkKeGn8F413UhETbPgH4845d3Icd02sSx4s WVPU/58tWctdBbxOoeitO3U+Y/iprAKiX8b3/5QstpvzL2wEE01l8uY0m+De64uxj1F3 QLRl4g0jXccES9Vua4weP6E/WoTMHS5XVoVKAxKSx5nD3XHrfeQnoWcyfn53F3PjNUwJ GYTMNFAx1MgPFuBBkOMkqt0s80N5R0hvUjWp5jD5fZXTvGe7FlizcLlgb4qN7w19+0sH mVEqp8/2gdvPb6B6/ktQpHyfj2gizsAXGrg/MuWOdUc8shGzOEHnfNNeA5h3LU+LdlOt Gq3w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=QQRh2gTu0XxP02eaevWI4QLBFrAyLvn8wbFwlTAm3vE=; b=sq/OBaT/10hmuseQWPyiQx3cV8qVJEak9W51pYwJqxQVZ9NdI0Om4IeRUlk5pJKX0R GKcaQNwK3uKePE4CUk5ysuohhGPCQGettSjhclE5m+TKY5VDEWWnCQ5nqvA4Kuvyy9ux 7i5jbC/4rTwbekYCsSKleBiKSulJ6eAwCq7Hl4zF0rqpkiScEacquNKep6tTyIlBjiD9 mbbdKKmmJlXvbZOk5z6Ku7J+B+/JQEeTPRXWOpsNg9Glt8mldnJFbo8ord08H7DcGXhR V40p/ZscGF54tPsPFasJJby5DtTMc3qCeDu9j/aU0KidnSRl9HqHhZ7qVmfbwC5gtm+d z/kA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=YbDDbAeg; 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=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id h7si5205266pgk.379.2019.06.20.01.11.51; Thu, 20 Jun 2019 01:11:51 -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; dkim=pass header.i=@linaro.org header.s=google header.b=YbDDbAeg; 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=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730908AbfFTILg (ORCPT + 30 others); Thu, 20 Jun 2019 04:11:36 -0400 Received: from mail-wm1-f67.google.com ([209.85.128.67]:36797 "EHLO mail-wm1-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725977AbfFTILe (ORCPT ); Thu, 20 Jun 2019 04:11:34 -0400 Received: by mail-wm1-f67.google.com with SMTP id u8so2144032wmm.1 for ; Thu, 20 Jun 2019 01:11:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=QQRh2gTu0XxP02eaevWI4QLBFrAyLvn8wbFwlTAm3vE=; b=YbDDbAegnE0dp4YumxpEKd5tEw4La1v3jt4kihJK5jyw2BUQQR1uZFOE2Ik6jnJj36 z8MiqykH+K7ixsqv71H2SpZ2kIdYvhPPNu4TMwigVUjFZhOQUC7dpx6vVoshTPiYOmNO ftClQRkLAgfaq/fv3imw1NNxA6VFMohIC4QSRuxiQu898a6DmHEf4CSVx6pyiixqrYBN 1OInEzdDKeK18AvYt8iG8qrHFhW24Q7MjjSJI8qT7zjFUvMUZO+pTv9/uBdWejqdfXY7 GjpcnjXK/PxKVn3+jRWovjUVVZx6CtpbwVRoEAJHq4RSlc2yvBCCA7TDYO+3wgYGkyRH vkQA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=QQRh2gTu0XxP02eaevWI4QLBFrAyLvn8wbFwlTAm3vE=; b=Ltf2SpliIZAeSsw44AXZp7Yvy5osVXYKAox01gQk0CDWxXKQW2seu+4lWiJxF67tcH QO0TdlvJioYRP5MBskNPBVHpEuZ5i4hYD1MWOdBIsGnjmliQQOowxh5c3kFkKdyHGcMc BsLeSNa6hclz+qNwtYBBJuZhun6rCg3alILvZvsnS+KsBQ/ksAujs+/1N/4m8rAFY7TE NP1n7QXhVEa0Ay693BPAcvZlFfeN8jlCLvi28e+3QJ7duJ8BGHb84KF9i+NvBHEVqEhf As+9Vjtlgk+F3jQyPctPDda4ZmKKCgHE98jEjV0ZbvYD4bkrZRJEo38V+L3Ml0YlOfk8 ZcFg== X-Gm-Message-State: APjAAAV+qRMlYuj81SJAkJi6g/wdqaLCNXDhI45vr0F2Hr+uOjl0QDA7 GW+yhMoPeNqC0wed4k0esmIetg== X-Received: by 2002:a1c:7a15:: with SMTP id v21mr1672163wmc.82.1561018292082; Thu, 20 Jun 2019 01:11:32 -0700 (PDT) Received: from srini-hackbox.lan (cpc89974-aztw32-2-0-cust43.18-1.cable.virginm.net. [86.30.250.44]) by smtp.gmail.com with ESMTPSA id q12sm17559174wrp.50.2019.06.20.01.11.31 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Thu, 20 Jun 2019 01:11:31 -0700 (PDT) From: Srinivas Kandagatla To: gregkh@linuxfoundation.org Cc: linux-kernel@vger.kernel.org Subject: [PATCH 1/3] slimbus: fix kerneldoc comments Date: Thu, 20 Jun 2019 09:11:27 +0100 Message-Id: <20190620081129.4721-2-srinivas.kandagatla@linaro.org> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190620081129.4721-1-srinivas.kandagatla@linaro.org> References: <20190620081129.4721-1-srinivas.kandagatla@linaro.org> MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Jonathan Corbet The kerneldoc comments in drivers/slimbus/stream.c were not properly formatted, leading to a distinctly unsatisfying "no structured comments found" warning in the docs build. Sprinkle some asterisks around so that the comments will be properly recognized. Signed-off-by: Jonathan Corbet Signed-off-by: Srinivas Kandagatla --- drivers/slimbus/stream.c | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) -- 2.21.0 diff --git a/drivers/slimbus/stream.c b/drivers/slimbus/stream.c index 2fa05324ed07..75f87b3d8b95 100644 --- a/drivers/slimbus/stream.c +++ b/drivers/slimbus/stream.c @@ -84,7 +84,7 @@ static const int slim_presence_rate_table[] = { 512000, }; -/* +/** * slim_stream_allocate() - Allocate a new SLIMbus Stream * @dev:Slim device to be associated with * @name: name of the stream @@ -189,7 +189,7 @@ static int slim_get_prate_code(int rate) return -EINVAL; } -/* +/** * slim_stream_prepare() - Prepare a SLIMbus Stream * * @rt: instance of slim stream runtime to configure @@ -336,7 +336,7 @@ static int slim_activate_channel(struct slim_stream_runtime *stream, return slim_do_transfer(sdev->ctrl, &txn); } -/* +/** * slim_stream_enable() - Enable a prepared SLIMbus Stream * * @stream: instance of slim stream runtime to enable @@ -389,7 +389,7 @@ int slim_stream_enable(struct slim_stream_runtime *stream) } EXPORT_SYMBOL_GPL(slim_stream_enable); -/* +/** * slim_stream_disable() - Disable a SLIMbus Stream * * @stream: instance of slim stream runtime to disable @@ -423,7 +423,7 @@ int slim_stream_disable(struct slim_stream_runtime *stream) } EXPORT_SYMBOL_GPL(slim_stream_disable); -/* +/** * slim_stream_unprepare() - Un-prepare a SLIMbus Stream * * @stream: instance of slim stream runtime to unprepare @@ -449,7 +449,7 @@ int slim_stream_unprepare(struct slim_stream_runtime *stream) } EXPORT_SYMBOL_GPL(slim_stream_unprepare); -/* +/** * slim_stream_free() - Free a SLIMbus Stream * * @stream: instance of slim stream runtime to free