From patchwork Tue Dec 16 16:53:33 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thierry Reding X-Patchwork-Id: 5502261 Return-Path: X-Original-To: patchwork-linux-samsung-soc@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 33D9C9F1D4 for ; Tue, 16 Dec 2014 16:54:37 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 9FF2220A1C for ; Tue, 16 Dec 2014 16:54:34 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id B69B320A28 for ; Tue, 16 Dec 2014 16:54:29 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751669AbaLPQyY (ORCPT ); Tue, 16 Dec 2014 11:54:24 -0500 Received: from mail-pd0-f174.google.com ([209.85.192.174]:37958 "EHLO mail-pd0-f174.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751628AbaLPQyY (ORCPT ); Tue, 16 Dec 2014 11:54:24 -0500 Received: by mail-pd0-f174.google.com with SMTP id fp1so14250454pdb.33 for ; Tue, 16 Dec 2014 08:54:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=n2MJPcMd4g9MAKvJMfvljOm3rxPYrliK+kiiQ+ZckrE=; b=p6aFsKLFnKzv753HzAN9lXuTdP0SdjnyfJwkXV2BXTzd7aPw5dUgJwkKFswxUnmALl 9erdkL+k8CZWBmg2WAlAU+XHbyc5zk+afBAJCrU5fDOGh8xTp75fPi7MmPlXX2+AB70u 7ZzSJQ8CO+txXqEwGNn1WZ85JNh5NeprsH8y6ATd+qtN+A6McJi6JvXw7pP+lOg5Ap2E lbV44gcKHWJIU4nAZprfXMpqKxIylAnL/XIMTFvSxKq2EPYigmKELeytG2HGZ35VC++L ETUJqiNbkhG9KaqX9x1yX6pH7Y8u+FWIgOMatxbwOtCMsK1r3n8OuZ8k4gzSWjttLKxf E8Qw== X-Received: by 10.66.97.97 with SMTP id dz1mr9267514pab.90.1418748863433; Tue, 16 Dec 2014 08:54:23 -0800 (PST) Received: from localhost ([216.228.120.20]) by mx.google.com with ESMTPSA id hx9sm1475428pad.38.2014.12.16.08.54.21 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 16 Dec 2014 08:54:22 -0800 (PST) From: Thierry Reding To: dri-devel@lists.freedesktop.org Cc: Daniel Vetter , Inki Dae , Philipp Zabel , Gerd Hoffmann , Mark Yao , Benjamin Gaignard , linux-samsung-soc@vger.kernel.org Subject: [PATCH 11/13] drm/irq: Document return values more consistently Date: Tue, 16 Dec 2014 17:53:33 +0100 Message-Id: <1418748815-15434-11-git-send-email-thierry.reding@gmail.com> X-Mailer: git-send-email 2.1.3 In-Reply-To: <1418748815-15434-1-git-send-email-thierry.reding@gmail.com> References: <1418748815-15434-1-git-send-email-thierry.reding@gmail.com> Sender: linux-samsung-soc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-samsung-soc@vger.kernel.org X-Spam-Status: No, score=-6.8 required=5.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED, FREEMAIL_FROM, RCVD_IN_DNSWL_HI, T_DKIM_INVALID, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: Thierry Reding Some of the functions are documented inconsistently. Add Returns: sections where missing and use consistent style to describe the return value. Signed-off-by: Thierry Reding Reviewed-by: Daniel Vetter --- drivers/gpu/drm/drm_irq.c | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/drivers/gpu/drm/drm_irq.c b/drivers/gpu/drm/drm_irq.c index b34900a8e172..ef5d993f06ee 100644 --- a/drivers/gpu/drm/drm_irq.c +++ b/drivers/gpu/drm/drm_irq.c @@ -991,6 +991,9 @@ EXPORT_SYMBOL(drm_crtc_send_vblank_event); * drm_vblank_enable - enable the vblank interrupt on a CRTC * @dev: DRM device * @pipe: CRTC index + * + * Returns: + * Zero on success or a negative error code on failure. */ static int drm_vblank_enable(struct drm_device *dev, unsigned int pipe) { @@ -1035,7 +1038,7 @@ static int drm_vblank_enable(struct drm_device *dev, unsigned int pipe) * This is the legacy version of drm_crtc_vblank_get(). * * Returns: - * Zero on success, nonzero on failure. + * Zero on success or a negative error code on failure. */ int drm_vblank_get(struct drm_device *dev, unsigned int pipe) { @@ -1072,7 +1075,7 @@ EXPORT_SYMBOL(drm_vblank_get); * This is the native kms version of drm_vblank_off(). * * Returns: - * Zero on success, nonzero on failure. + * Zero on success or a negative error code on failure. */ int drm_crtc_vblank_get(struct drm_crtc *crtc) {