From patchwork Wed Oct 11 04:16:30 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Haneen Mohammed X-Patchwork-Id: 9998869 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 38DC060230 for ; Wed, 11 Oct 2017 07:32:58 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 2799F2891D for ; Wed, 11 Oct 2017 07:32:58 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 1B6742891F; Wed, 11 Oct 2017 07:32:58 +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 B99AF2891D for ; Wed, 11 Oct 2017 07:32:57 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id C3FD96E5D7; Wed, 11 Oct 2017 07:32:36 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-pf0-x241.google.com (mail-pf0-x241.google.com [IPv6:2607:f8b0:400e:c00::241]) by gabe.freedesktop.org (Postfix) with ESMTPS id 99E096E1C7 for ; Wed, 11 Oct 2017 04:16:33 +0000 (UTC) Received: by mail-pf0-x241.google.com with SMTP id i23so1065754pfi.2 for ; Tue, 10 Oct 2017 21:16:33 -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=rF3AZfm8CZUg/i3c2geZ8d1wKzM7zylOZowajMSO0B0=; b=cGJ9GdP2enQEjXTqWuDPIYOL1vv35tXlRs7X2xZ6MMk6ewK7ABizsscfWRChPL17gM hm/IiGWa8c+5irUCYhpg+1itN/JQcmwK82hKKK/VeIKSua4z1QL05gaKq+q+ZGCI0Rxf 7rqM8uaAopnNbvLwLyaXV3RI2WRluw8+uMh4gvH+7LMXVV6RPZoit7/THDcH+lSszHDl C9a4Hhig6cnXG6gITUaEUOGhMR5uFPynjNlmP+FfUeSLNSbNjGg5BPw0NpPw6zmHFHrY 2xPdRwuQ7Q1o2TMn/QeJ6/gJ1se/kXZC0IlTHTkmAhAz6LAel8Kucq8tsf1ZNTEVkZmA XG+g== 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=rF3AZfm8CZUg/i3c2geZ8d1wKzM7zylOZowajMSO0B0=; b=XcLK1F2/KQSaMOF44/XTu88RxL3DqevbUFtm1xYS2wMBUqxhzsqcwqOio2V6V5HMNR IPx7+AFEW2fNKBfloqXwOZQr9in5npsmT1D6cP5GIRgm5UX1nhpRdG1miDxSqQFrDtfj nyeqCpq6BewrSVU7xeCvL8TLFnoLvWiyL1xcWWhdi7+vKTNoMZW2QwI9kKj6jLWaVUhM F+bnAVgLTJRPRPsZJHljB3EyyiK9jiXOCOkApGsl3g6iKngkFNJL5CZq4EP/c58F9zc4 1A//p2fWb9Zd1+tYJzPQSs3Z7g+j32n3NnAqHQMnhsEl9LzUMdbmOJ85dBspJbRP21cs VohA== X-Gm-Message-State: AMCzsaUi+2V1aTSD+kjBrzChfBUbJmqYHKxA/08ssHQx+9m7BTwM2sO0 123RAZqmuyLA9L6/KRCddQMjN25L X-Google-Smtp-Source: AOwi7QCdHhZuWCopFCnrX0f59cIQDx/kICMDc/UBDUqP78tqY5Y2mnnX94xEyBCFiSZfG0Z7APFtpg== X-Received: by 10.84.252.147 with SMTP id y19mr7964957pll.88.1507695392956; Tue, 10 Oct 2017 21:16:32 -0700 (PDT) Received: from Haneen ([64.77.242.50]) by smtp.gmail.com with ESMTPSA id z76sm3239716pfi.117.2017.10.10.21.16.32 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 10 Oct 2017 21:16:32 -0700 (PDT) Date: Tue, 10 Oct 2017 22:16:30 -0600 From: Haneen Mohammed To: dri-devel@lists.freedesktop.org Subject: [PATCH 2/2] drm: Update old comment style Message-ID: <89f342899ff9acc1645e6cc58451e9aafccb5e77.1507693829.git.hamohammed.sa@gmail.com> References: MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.24 (2015-08-30) X-Mailman-Approved-At: Wed, 11 Oct 2017 07:32:33 +0000 Cc: Daniel Vetter , outreachy-kernel , gregkh@linuxfoundation.org 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 --- 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..78e3702 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 + * @fmt: printf() like format string. + * @arg: arguments */ #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 + * @fmt: printf() like format string. + * @arg: arguments */ #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 + * @fmt: printf() like format string. + * @arg: arguments */ #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 + * @fmt: printf() like format string. + * @arg: arguments */ #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_ */