From patchwork Tue Oct 17 08:45:50 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Haneen Mohammed X-Patchwork-Id: 10014037 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 835D560215 for ; Wed, 18 Oct 2017 08:18:29 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 7251828AE2 for ; Wed, 18 Oct 2017 08:18:29 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 6709B28AF2; Wed, 18 Oct 2017 08:18:29 +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 2368528AE2 for ; Wed, 18 Oct 2017 08:18:29 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 03A7F6E824; Wed, 18 Oct 2017 08:17:19 +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 45EAA894E3 for ; Tue, 17 Oct 2017 08:45:54 +0000 (UTC) Received: by mail-pf0-x241.google.com with SMTP id x7so866749pfa.1 for ; Tue, 17 Oct 2017 01:45:54 -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=wL71eP2/MXm2INv39keHfrPMs2dXAs225+FCrs29JQw=; b=rp5FfyIWvrun3hUwQs+VDqdGIWYl5+S0x4HlSnhPOMUk9M7xixzDb5WQ7x5qhyWot2 JagfPPbSrI8csh7La0/UBEtK/xmTtIf6+5VzonPPJDStTZ7XRBxDYDuDlPOBMEzsSFqH hXvKlQ49JJMM4tWZJXsnYDTHzyT3VX/fg5FBRgwIJDgIsfhyXt1ZMXoPREagyGM+JcZl C+MUJxsxb84hsNOCWsNLbBNUulWN425lOlkuO/9YaQEiI9mHctgM7OLPCEl4sUQjp8s2 KXJcuTQq1w2wFmVZr5+DPukmoe57jI7r6YzVtHZDt75d3pOjRfTp0RpSAW/jGfWMkxtU jikQ== 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=wL71eP2/MXm2INv39keHfrPMs2dXAs225+FCrs29JQw=; b=dT12acrzjrC7y6Qavl04+ujrBNkXIPgh8EJpYXpQ32K4uKBWIPy8kMxQNtho62d5Xr FiouGiULPEKj0cvoib8xtoYq3XIW0Vw/4bg5qnk5FqnMvwL5M4HuRLe3AT4GfhB3gWtK gYcGnhgDTtuxQl5hkj0Nmv71tRcrLCnaHrmkvjNe1mn/DMqpVACyOFW1KLeUbLPltnJJ Uaj30tMVKcbgOcRvr3sC1nCNiX3aVAjq64SFlkM2zmKNqCshkUGkT1+7iycHwcHuvBs6 DrXDC2MN5VEDiR/O2ES5BVQ+m1OOhXhjweTMlrMVI3ypHHHM+UKvIM3BkNdc3ysH8SLt pzHw== X-Gm-Message-State: AMCzsaXZo+x3I8+YXjMGNrPZaB7FjAIvPMN5KIRP61faYKQymz8QFqJS aV6ovxR4PseuoGVZ6Amk00AYD+tH X-Google-Smtp-Source: AOwi7QAsznC2p16t2RdiT9usdSNTpBzMogH4GJWwZYTHWD/0tL2FSkFBkVBi46Nspuk5DaKQp6NExg== X-Received: by 10.98.160.90 with SMTP id r87mr11434523pfe.324.1508229953531; Tue, 17 Oct 2017 01:45:53 -0700 (PDT) Received: from Haneen ([64.77.242.50]) by smtp.gmail.com with ESMTPSA id m74sm9156802pfi.2.2017.10.17.01.45.52 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 17 Oct 2017 01:45:53 -0700 (PDT) Date: Tue, 17 Oct 2017 02:45:50 -0600 From: Haneen Mohammed To: dri-devel@lists.freedesktop.org Subject: [PATCH v3 2/2] drm/print: Update old comment style Message-ID: <2d37692b811a36c06262ff53efbb520e2f26eb88.1508228315.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:10 +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 v3: - 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 9dacc5e..d208a85 100644 --- a/include/drm/drm_print.h +++ b/include/drm/drm_print.h @@ -136,9 +136,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 { \ @@ -163,8 +162,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*",\ @@ -175,8 +174,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, ...) \ ({ \ @@ -206,8 +205,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, \ @@ -258,8 +257,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) @@ -278,10 +277,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_ */