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;
Date:   Fri, 15 Jul 2022 17:26:01 -0400
From:   Rodrigo Vivi <rodrigo.vivi@intel.com>
To:     Mauro Carvalho Chehab <mchehab@kernel.org>
CC:     David Airlie <airlied@linux.ie>, <intel-gfx@lists.freedesktop.org>,
        <linux-kernel@vger.kernel.org>, <dri-devel@lists.freedesktop.org>
Subject: Re: [Intel-gfx] [PATCH v2 26/39] drm/i915: i915_gem.c fix a
 kernel-doc issue
Message-ID: <YtHbaViIllnSiZIA@intel.com>
References: <cover.1657699522.git.mchehab@kernel.org>
 <3f512107b7c7c1bdbe3131b3a35d9cc34e29656d.1657699522.git.mchehab@kernel.org>
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <3f512107b7c7c1bdbe3131b3a35d9cc34e29656d.1657699522.git.mchehab@kernel.org>
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?aTrrG4QNzNhvI5BZbVFdy3/oB0maF+e4eEIuS4wHFMn5vAC18zbZc3K4y6EU?=
 =?us-ascii?Q?p1hDBGXs805RXouxYcVtTorDE5fCoOXPYbzTDqDZtljF7W15WcBQzgkZBZ/H?=
 =?us-ascii?Q?kxZBDu2h+R5KEM9WV13KgUZTwmOu4x0A0mmChfZia9inRfA9XaNVcztyPzQr?=
 =?us-ascii?Q?/MESmqcoFIsHvZrahI0cpFWhnmkS4bGie2ZEU9tAm/QRq/wi2VHwCXYtOJEr?=
 =?us-ascii?Q?XqY9Ve269ZTEcofbFb4qwkRgeG6jcBy2RW+YiAUxxAzQA8Vb/5Ks3Ov6XUsi?=
 =?us-ascii?Q?vgP+Ty5hR+hdX9CFphcYph8DfJwLb8/jdc6NLRF3Dy358UPcMh3PgyUUrb6R?=
 =?us-ascii?Q?TyDSyMXdhUeqq6SH6vAtOEwgtTlkY2Co8Ab1YLrNGhIrghPCtLvcucs5uv2O?=
 =?us-ascii?Q?OAbbXjjQ/Jo/W5Vnas1LATVKaLVXvstR3ALlywZ6ExK6ufKrL33Tx4Ybnnkt?=
 =?us-ascii?Q?CbWNTeFKyiTEG7ZK4LFHn+i9AC6p9wxAa76S6bEnQgYl/YOX0DkoFPaQgiMM?=
 =?us-ascii?Q?Nnd6sxZKNk24gjgQy7RjRr5wUo000lwTec3Co7HAS7LiRmjAJ9rNYwAWg9Gp?=
 =?us-ascii?Q?wxOt1tuwz/lOf+yM7Eb4y0l8AkR/64N6j/lM+6xbIwOXJvBBFmRb4zUkeCA1?=
 =?us-ascii?Q?4zpkITzF3N4e0rr9ijrTBfFt4uBnhGRISnv3Sxz5dj02KS6/LBX5RLObMynp?=
 =?us-ascii?Q?wpLNkKngziZpq35ZDNIuWkvrojarpO7WqzOdQsUJORUZUp7gHKXoHEkAJsY+?=
 =?us-ascii?Q?yDo1dtE7Zr+FzpWcvoO+ooXykPEk4rp2/csmiyeTHDG+tJayy3P8luWXUS7a?=
 =?us-ascii?Q?jWVyIrlKpW7+GFs/T+3waNYe/NGhOGRM2ZyzJUWMatf7ZXJxQI73BKknP1v7?=
 =?us-ascii?Q?sOR6QcveHsVjiXtFIgdHkHoGsgZUJgrZbHFzKYUE6AZJl83qBMGGGo+DWIzu?=
 =?us-ascii?Q?/NSQKcSHkEEBQPwiUJswbkQplw8MtWYogPAvK+59Hn+PeIOGsF4OeKfz0isE?=
 =?us-ascii?Q?6GsoABpOdLrNva6XhtmJrRAPFibT8tlR6ZWzC0Cv1cVaoXVEjgDaMFOEmj+i?=
 =?us-ascii?Q?AVez+LNhLl5t6m3cqhefiYvJnwbg5d5YcSBagZ445h9LrGhn83Np3IHaHtMd?=
 =?us-ascii?Q?UG6VfUEXEGNm1N/tssX5lnFR005tPoO/vMlTGw2DJvzmF18xd2h/H0Z2rdAr?=
 =?us-ascii?Q?WGfFPfiV+haP4XxUothAgPvCsdwwd13zU10l3xwpUa1sU/p6eu84ozhyE+1e?=
 =?us-ascii?Q?J9gUsvGnuWg6emoEbuC80VG6vyA/FivzMa30gWBrgM0m04OdYd35F5lfI5Tx?=
 =?us-ascii?Q?OUZXShRmQ++VnZH+JtQLjJ5B8uJc/qfOocr9ow7GdbTgkUNWnsD5jqUkcZbs?=
 =?us-ascii?Q?XlZ0h+jvVd7Pyt3Y/NjMYnt9rBNDeHx2hLT6UUwhjHhldFphG5CQ/1OqOtHQ?=
 =?us-ascii?Q?g9B0qxK3/hSS9uT0f4D3YS6ihDW3akx924QTqaFQnhBzBdhKGCppOS3ZOlCL?=
 =?us-ascii?Q?Kdot2STpKQxHHEtPqhYG37Ep9q7q2+2xkf5v8yqrqqWfC70Ghav1BTmVQap6?=
 =?us-ascii?Q?hOoOEjs4RztHDZvugZXFWlWeONGie+kevWKPHCwCe8mhnOdkPDlpiNGfVU7M?=
 =?us-ascii?Q?Mw=3D=3D?=
X-MS-Exchange-CrossTenant-Network-Message-Id: 905e0d8d-3cb3-4d12-9962-08da66a89ffe
X-MS-Exchange-CrossTenant-AuthSource: MN0PR11MB6059.namprd11.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Jul 2022 21:26:05.3491
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: 9nDHtkS+RqtE3hit9/ygTijsQ0Oikk5W9bj6k6RvIXsSEy6IWmjA7pPU0HvBCGfwWU/J9WN6gxmwb5Mhh91DpQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR11MB2028
X-OriginatorOrg: intel.com
X-Spam-Status: No, score=-5.0 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,
        DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,
        SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On Wed, Jul 13, 2022 at 09:12:14AM +0100, Mauro Carvalho Chehab wrote:
> 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 <mchehab@kernel.org>

Reviewed-by: Rodrigo Vivi <rodrigo.vivi@intel.com>

> ---
> 
> To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover.
> See [PATCH v2 00/39] at: https://lore.kernel.org/all/cover.1657699522.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 41e83d078a70..0ca4bb08ea78 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
>