From patchwork Wed Oct 18 04:31:22 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Haneen Mohammed X-Patchwork-Id: 10014033 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 5CE5D60215 for ; Wed, 18 Oct 2017 08:17:48 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 4BFFD28AE2 for ; Wed, 18 Oct 2017 08:17:48 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 40D9B28AF2; Wed, 18 Oct 2017 08:17:48 +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 D28B328AE2 for ; Wed, 18 Oct 2017 08:17:47 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id D8ADD6E808; Wed, 18 Oct 2017 08:17:13 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-pg0-x243.google.com (mail-pg0-x243.google.com [IPv6:2607:f8b0:400e:c05::243]) by gabe.freedesktop.org (Postfix) with ESMTPS id 353E76E7C5 for ; Wed, 18 Oct 2017 04:31:26 +0000 (UTC) Received: by mail-pg0-x243.google.com with SMTP id y7so3230488pgb.7 for ; Tue, 17 Oct 2017 21:31:26 -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=NNxvah3afOu410eQCBuWixcEsn2cez8flJpowNwco7I=; b=nLBs+Jfy7WkcfF41z0UgArDJbvMBR5HQ1dkb7ny0u69yxiEx6XGOo/J7dZrz/g8WyU /miiwmvQZUBMArplwey18Ofe6DdtuTMmOCoq27s8vNE5PoUZmzHyb557GbNKCLnpoULw 3TMkx540oAymda00i0+7bqUEW2gIFxlsoaa2kNsG6PGyWo6hD8huX0joaaW8aZFH4roa ahi8pnj3cveFimRmPA34OXqsfVvJkR3t3nStM5H0ALlitMwJxvYKR6Kn5ajpZy6EDi/w REsKM6hwnL3qZN0XDwXm2740deRuJoOGOL04R3BDuUlI7gfI9nhqryZs/5OEFnlJ1MQx o1RA== 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=NNxvah3afOu410eQCBuWixcEsn2cez8flJpowNwco7I=; b=uXooOpuvPSMCKuCmHcR7rJXZD+Bf44aYflDnoZyU+BPdOWpNFTToNkXv3VKvhf2Kz6 zte0LfU1DjxsXMh9+Jf88PZ03iOMwgPyLm5IWKiC1XCl6SI6icIqxKHGxzucQ7Xx61JS H0HTsHUl6pHwfMqSjBksOCGlJoZuUjGtvhEC+Waqgc3Da1+rtPXFopYyiQ676bxpIMEO YEQB86nCRFG5ox4YpGvUnPVH8fttMa9ubpjodN7ssZAdFTIHGhZjFLDs3fOaZkDT1RcX fgQqK5ouwP4B6begthe3HJ6AuGMZWIon9uOfHAQogJX5u0Cf9JN3hfLQIEgCKox8ieEs fcDA== X-Gm-Message-State: AMCzsaVFoqqWL32y9v3QahQZhNR7afPTXXoD089rhK8xYgcAuE2MNN9B ecxws7A0PQTV9oasAMuKQ/oOJj+p X-Google-Smtp-Source: AOwi7QDqbQoIpSy4nbuq3jCCvg5tbGotU9K1RfoQow6fXuNric7ktIT59+Pcac5hQ5qzIpqH4ieNew== X-Received: by 10.99.1.7 with SMTP id 7mr13091710pgb.251.1508301085456; Tue, 17 Oct 2017 21:31:25 -0700 (PDT) Received: from Haneen ([64.77.242.50]) by smtp.gmail.com with ESMTPSA id h29sm13500613pfd.65.2017.10.17.21.31.24 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 17 Oct 2017 21:31:24 -0700 (PDT) Date: Tue, 17 Oct 2017 22:31:22 -0600 From: Haneen Mohammed To: dri-devel@lists.freedesktop.org Subject: [PATCH v4 2/2] drm/print: Update old comment style Message-ID: <4d89eef3945dbffd402d2ecdc130108b0565c158.1508297716.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, 18 Oct 2017 08:17:09 +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 v4: - Nothing. include/drm/drm_print.h | 27 ++++++++++----------------- 1 file changed, 10 insertions(+), 17 deletions(-) diff --git a/include/drm/drm_print.h b/include/drm/drm_print.h index 41dd757..7b9c86a 100644 --- a/include/drm/drm_print.h +++ b/include/drm/drm_print.h @@ -179,9 +179,8 @@ void drm_dev_printk(const struct device *dev, const char *level, __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 { \ @@ -206,8 +205,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*",\ @@ -218,8 +217,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, ...) \ ({ \ @@ -249,8 +248,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, \ @@ -301,8 +300,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) @@ -321,10 +320,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_PRINT_H_ */