Received: by 2002:ad5:4acb:0:0:0:0:0 with SMTP id n11csp3677008imw; Mon, 11 Jul 2022 13:28:00 -0700 (PDT) X-Google-Smtp-Source: AGRyM1sqPg5/kSdjdeVIn3WLfLe+Ts0BpIObggDzqJlfsdkVapPCiRR8c4R5XrPiKvURqf2tHQqQ X-Received: by 2002:aa7:8294:0:b0:528:2a54:49a5 with SMTP id s20-20020aa78294000000b005282a5449a5mr20123285pfm.3.1657571280221; Mon, 11 Jul 2022 13:28:00 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1657571280; cv=none; d=google.com; s=arc-20160816; b=xuMt76Gxqfpwq1Rvzbk4SfkFVBflNWWg/+2CainaIVgCCj7TQ6TB0NiEyG4ZsGuZWQ x7XLyXPI3lU3P3+grRdwWlCboQgC89l6GYaBFTgh4bIjHYXW9dEWqXSx3lH8tzQn2FUX E9MyyxexbmaKJK50wNNt8cvdCM2dBiBI+VUo7kOp6ops8e1cgY9QMMnWvO0GY17KH4aY pjl5wVnjeyT8cWaTprCzcWDJGnDkBHN2QQMGpOrgSuFGtlHdQRTVUVuV851MK1w7HtFV siQg4J8wHYZ74QZSU8xcXl9HbAiMCs5IG3EwcQm2x6LQ7C9Mq7k2/T1i+l7awY0DiXSC hW8g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:to:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:from :dkim-signature; bh=OHQFgOftRDrlu4jG7WhdamvQZsvNu9TIMAZe/PGNees=; b=RDlQKWQ+ULB+CdU8pJciXMKH2sUiu86FmP3rZ7TwifkJbF8QKKldcyKxEDmA9NCiDI V9umz3I186nBcx3ym5BOwiSagRTweGswjskTUvBvU1sXjOFTE1FssXnF1Qiv3hOnmt8m veq9lNNolWoTwZlQIKSVIvng7euYFU1MbiW6D5nv+aOu6BeE+xQWA1Z5p8DTtxN5WiPx xW+IaSG0RJW2nf67s/Df1PX2oG/jSRi6SJU2PjxPN1ZoJOz7WDAW6oiAI4nLRGbIP+Fw 6RQVv/gN9RjJA9rUnBcFKg1I+uevctJWBReSI9+HAeCcBffbd9zBcMtW4lPAH88i5rNh o3eQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@kernel.org header.s=k20201202 header.b="iAQZIC6/"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id u71-20020a63854a000000b0040a88eddccfsi10395365pgd.441.2022.07.11.13.27.47; Mon, 11 Jul 2022 13:28:00 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=fail header.i=@kernel.org header.s=k20201202 header.b="iAQZIC6/"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231966AbiGKU0y (ORCPT + 99 others); Mon, 11 Jul 2022 16:26:54 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:44582 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229638AbiGKUZb (ORCPT ); Mon, 11 Jul 2022 16:25:31 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C96364D83E for ; Mon, 11 Jul 2022 13:25:27 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id DD0DDB81227 for ; Mon, 11 Jul 2022 20:25:25 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 41361C36AE3; Mon, 11 Jul 2022 20:25:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1657571123; bh=D0bEjONKO0OQMVFCtOYHA/FPk+KIm9oq17OfYHcIwdM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=iAQZIC6/tx0PdX1S4dItst07G5SzprXk10MbTdVninLlEgXFztK88oOXF17hRb+Qy 79AHrZQumux78yo8Bql9RPDBmI0lV5ni/FVY86sLnxj4QRIbS8bNkwpMlB7tGX+hcQ CO0RFyWH4qL6cHkBDB9bcpecNNXZUGCXQBz/STfDHscTfc3jz8nr4vUO0BCt7aJJCx urNm4bwOWrpb8rvPrjrza5Z06Kwu1SwuEzUuVvIn7JvOU4W/iq5FOLxD35eM9Y747O rcG0qu4nw6Exv0Iz7cULcidDGvQtCUEu75b9BMui7asn2/4ODu110lSNjk2jPjqyGD 6bO3LYI/04EOA== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1oAzy3-004e8o-Pr; Mon, 11 Jul 2022 21:25:19 +0100 From: Mauro Carvalho Chehab Cc: Mauro Carvalho Chehab , "Jani Nikula" , "Lucas De Marchi" , "Rodrigo Vivi" , Daniel Vetter , David Airlie , Joonas Lahtinen , Tvrtko Ursulin , dri-devel@lists.freedesktop.org, intel-gfx@lists.freedesktop.org, linux-kernel@vger.kernel.org Subject: [PATCH 23/32] drm/i915: i915_gem.c fix a kernel-doc issue Date: Mon, 11 Jul 2022 21:25:08 +0100 Message-Id: <037b710c2a65c4b3da5b0b9bb947f740bf08c12e.1657565224.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-7.7 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_HI, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net To: unlisted-recipients:; (no To-header on input) Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Prevent this Sphinx warning: Documentation/foo/i915:728: ./drivers/gpu/drm/i915/i915_gem.c:447: WARNING: Inline emphasis start-string without end-string. By using @data to identify the data field, as expected by kernel-doc. Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH 00/32] at: https://lore.kernel.org/all/cover.1657565224.git.mchehab@kernel.org/ drivers/gpu/drm/i915/i915_gem.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/gpu/drm/i915/i915_gem.c b/drivers/gpu/drm/i915/i915_gem.c index f01f0896ff5c..0bc895c6a1fc 100644 --- a/drivers/gpu/drm/i915/i915_gem.c +++ b/drivers/gpu/drm/i915/i915_gem.c @@ -444,7 +444,7 @@ i915_gem_gtt_pread(struct drm_i915_gem_object *obj, * @data: ioctl data blob * @file: drm file pointer * - * On error, the contents of *data are undefined. + * On error, the contents of @data is undefined. */ int i915_gem_pread_ioctl(struct drm_device *dev, void *data, -- 2.36.1