From patchwork Thu Oct 12 02:36:36 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Haneen Mohammed X-Patchwork-Id: 10001197 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 B09AC602BF for ; Thu, 12 Oct 2017 07:35:52 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id A0B9328CFB for ; Thu, 12 Oct 2017 07:35:52 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 9571C28CFE; Thu, 12 Oct 2017 07:35:52 +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_ADSP_CUSTOM_MED, DKIM_SIGNED, FREEMAIL_FROM, 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]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 01F3A28CFB for ; Thu, 12 Oct 2017 07:35:52 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 9AF1C6E7D5; Thu, 12 Oct 2017 07:34:13 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-pf0-x244.google.com (mail-pf0-x244.google.com [IPv6:2607:f8b0:400e:c00::244]) by gabe.freedesktop.org (Postfix) with ESMTPS id 6F0D56E201 for ; Thu, 12 Oct 2017 02:36:39 +0000 (UTC) Received: by mail-pf0-x244.google.com with SMTP id p87so2942677pfj.3 for ; Wed, 11 Oct 2017 19:36:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=kTwVl4l3T0hNUis8VWwp9ysD3/1BNy/YhcHfGyJp2Xw=; b=royGpbdGYJf6oVXUf7tjNRz+c/dNHI+Fc82aFS6tzm0jCCJAyOAdGJQRXcU7W7iB5V a6Lx6vsB0wxzJZAYpq1CtzaFHunaVskbMVpUjoSIHDtE7TBm1PWnKZAgmFny/rff+gTi UNuk8YD1dtqqF4tFRX2C4SrSCpWoutmVpKc6OhvWQztaUY2eIBy76UrtdInKHi6/qjBb uIxFSU3JYDvnC2ROKhq8GmsDg7NqtCXUIx13jYsoLf4m5snKv87MNEJdtGn4Jfty9kr7 dzOAIbGGu8ai0eibgPXjU+hGh0I2cjqe+IxGh6XfyNRK557CkGsKczSMIdwcxrFUPcxG VZdA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=kTwVl4l3T0hNUis8VWwp9ysD3/1BNy/YhcHfGyJp2Xw=; b=jJ70pdUxVwxRpWeile9QBaYSJIo7qmp8lJySrhVJ3gC1ZgTovnh5xxs57sloEtwXkd xeR4EthBZ5XwVKjZY/u0MXN/Jvg3nlUYayrJoX8Zvx6H1SJuTfTxi3BnviuCQHoE5sXT V2GDn4mhwaN7wKJrP/ZWaFGI0phUVDR4NZ98ktAin/qYBJKdWB+F2g8TbM14vPo7nkwM qEW2yDWYgEuZqR6Iu+cUgnbd+goc0jQqETAPGxtNW8qSW2X3xcddBAzJcYofCak3/jkk Ex/LrZiTNJJXvU7p33X2CLEs8y6FVfXVXom+zohthO1tv9Th+EzNYJ8+sC154DlxmJ1x Irwg== X-Gm-Message-State: AMCzsaVTRlfO/euycce+3Uw4uwQ/YdqG8At7XbSSz2hqhcr3OrnNdik8 fkR5t6IXcP/H78dCjAGzqCFH/gJC X-Google-Smtp-Source: AOwi7QB9FmMBMfKfF9T8rMVtEJ0bTZxS3bh5ubQQr7PtzWNFsy0ZiLln3KwTK/QIcCO3zkdi1uCVvg== X-Received: by 10.98.219.195 with SMTP id f186mr908001pfg.69.1507775798709; Wed, 11 Oct 2017 19:36:38 -0700 (PDT) Received: from Haneen ([64.77.242.50]) by smtp.gmail.com with ESMTPSA id n12sm21246974pfb.149.2017.10.11.19.36.37 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 11 Oct 2017 19:36:38 -0700 (PDT) Date: Wed, 11 Oct 2017 20:36:36 -0600 From: Haneen Mohammed To: dri-devel@lists.freedesktop.org Subject: [PATCH v2 2/3] drm: Update old comment style Message-ID: References: MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.24 (2015-08-30) X-Mailman-Approved-At: Thu, 12 Oct 2017 07:33:54 +0000 Cc: gregkh@linuxfoundation.org, outreachy-kernel , Daniel Vetter 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: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Virus-Scanned: ClamAV using ClamSMTP Remove old comment style used by doxygen. And remove comment left from commit 99cdb35e787b ("drm/doc: move printf helpers out of drmP.h") after refactoring drmP.h. Signed-off-by: Haneen Mohammed --- Changes in v2: - Fix kerneldoc comments include/drm/drm_debug.h | 26 +++++++++----------------- 1 file changed, 9 insertions(+), 17 deletions(-) diff --git a/include/drm/drm_debug.h b/include/drm/drm_debug.h index 24fbea4..b40b0ef 100644 --- a/include/drm/drm_debug.h +++ b/include/drm/drm_debug.h @@ -42,9 +42,7 @@ __printf(3, 4) void drm_printk(const char *level, unsigned int category, const char *format, ...); -/***********************************************************************/ -/** \name Macros to make printk easier */ -/*@{*/ +/** Macros to make printk easier */ #define _DRM_PRINTK(once, level, fmt, ...) \ do { \ @@ -69,8 +67,8 @@ void drm_printk(const char *level, unsigned int category, /** * Error output. * - * \param fmt printf() like format string. - * \param arg arguments + * @dev: device pointer + * @fmt: printf() like format string. */ #define DRM_DEV_ERROR(dev, fmt, ...) \ drm_dev_printk(dev, KERN_ERR, DRM_UT_NONE, __func__, " *ERROR*",\ @@ -81,8 +79,8 @@ void drm_printk(const char *level, unsigned int category, /** * Rate limited error output. Like DRM_ERROR() but won't flood the log. * - * \param fmt printf() like format string. - * \param arg arguments + * @dev: device pointer + * @fmt: printf() like format string. */ #define DRM_DEV_ERROR_RATELIMITED(dev, fmt, ...) \ ({ \ @@ -112,8 +110,8 @@ void drm_printk(const char *level, unsigned int category, /** * Debug output. * - * \param fmt printf() like format string. - * \param arg arguments + * @dev: device pointer + * @fmt: printf() like format string. */ #define DRM_DEV_DEBUG(dev, fmt, args...) \ drm_dev_printk(dev, KERN_DEBUG, DRM_UT_CORE, __func__, "", fmt, \ @@ -164,8 +162,8 @@ void drm_printk(const char *level, unsigned int category, /** * Rate limited debug output. Like DRM_DEBUG() but won't flood the log. * - * \param fmt printf() like format string. - * \param arg arguments + * @dev: device pointer + * @fmt: printf() like format string. */ #define DRM_DEV_DEBUG_RATELIMITED(dev, fmt, args...) \ DEV__DRM_DEFINE_DEBUG_RATELIMITED(dev, CORE, fmt, ##args) @@ -184,10 +182,4 @@ void drm_printk(const char *level, unsigned int category, #define DRM_DEBUG_PRIME_RATELIMITED(fmt, args...) \ DRM_DEV_DEBUG_PRIME_RATELIMITED(NULL, fmt, ##args) -/* Format strings and argument splitters to simplify printing - * various "complex" objects - */ - -/*@}*/ - #endif /* _DRM_DEBUG_H_ */