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:33:35 -0400
From:   Rodrigo Vivi <rodrigo.vivi@intel.com>
To:     Mauro Carvalho Chehab <mchehab@kernel.org>
CC:     Tvrtko Ursulin <tvrtko.ursulin@linux.intel.com>,
        David Airlie <airlied@linux.ie>,
        <intel-gfx@lists.freedesktop.org>, <linux-kernel@vger.kernel.org>,
        <dri-devel@lists.freedesktop.org>
Subject: Re: [PATCH v2 27/39] drm/i915: i915_scatterlist.h: fix some
 kernel-doc markups
Message-ID: <YtHdL+Q3anh7o7QI@intel.com>
References: <cover.1657699522.git.mchehab@kernel.org>
 <a8448975d949b77379939e11ccbb794d8fcbeee7.1657699522.git.mchehab@kernel.org>
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <a8448975d949b77379939e11ccbb794d8fcbeee7.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?1kRwx8lcr+2IU+oERf9XmytEpsHN9nCSfM4uZv0DeJj/o1HKpNyq8po1/fTc?=
 =?us-ascii?Q?qTQUrFNuW+klmqI9K5/D9aNBn8Iffl2M0kI/P/h3Ot4Kg3L0tE2Ekdl7CPOD?=
 =?us-ascii?Q?kgaA3uYmw8SpT+GeDoPWzzgyp5Ei+VoPvS7qrvMo+NKbKamXqFvdqjZAzoyQ?=
 =?us-ascii?Q?rfo7JouNIpTQWorcpQg4l9NyjQkmju1/BebwI3xvVukS7aQkOdeihWSBKeva?=
 =?us-ascii?Q?QFVpdt0a+ni1DFFckRwVM8y5VQhjFLc049DiiZyP8Jb0BtuW5wgrowCCRSIT?=
 =?us-ascii?Q?195xxo41Y7QkswTbVyLAWiTNsVefFD2Bhz/S3L1RwcCctVZEWEXuffC7MXvU?=
 =?us-ascii?Q?8zhDM9CJjUgRhbbPPpWw9wTgFk0QaEzGzldeD4JKJgsDVSJapodZkx5Bb9Sb?=
 =?us-ascii?Q?q30C5n2p6H9Ij067pDTIiZXshDOsYtOGboNKwSWa4RKf//murMzdNXku9W67?=
 =?us-ascii?Q?iIYZRetD6UDVyzxIrcHOh55zcnFk6NR4e8omVLely9vxnrL+Hb6UnMZuJrEc?=
 =?us-ascii?Q?j5MetipUUhKSbN8i0FWgnAtseW46qqAqG9bcVWGWHDo7qvFnrpAzp5FTJBnP?=
 =?us-ascii?Q?qXge2Gyiu1IWJeBpVKP7SC5uDPJrmOr3eT5qahSl9xSfZdJ4X1DokkPmusKG?=
 =?us-ascii?Q?+wzjexEZhAP6JyqZ2F/bt1pZgcX0G6AQubOGcyfbKCRkapA74WGHt5iX3ARN?=
 =?us-ascii?Q?lA/VZZcEzKkRILdq5+V/Wrj1npY0XfOy5npAqLpQY3/ORMcBTtzji371NW1R?=
 =?us-ascii?Q?JOuC0LAh5OyRH5Pjgg2Nqz3e4ax2U5ATcsMtkcDIjS25ScsnMoCwJv0WZ63g?=
 =?us-ascii?Q?Xw62RTuj2dHHlQuwmfaQiVPVCmMAQ6bFk1+6QGwFN3W0nLOVljE8sHivpM0Q?=
 =?us-ascii?Q?/94DAWG5BZH4LROE4GoBRSjlVOr1YmcivXuxbGV8CoyEnbi0blqXfzMNKmLI?=
 =?us-ascii?Q?LFwITmAirMCEVD7FeihERWcn56o+nZsBcdtj0gSWssxYLYT0kYT6mztSlvgj?=
 =?us-ascii?Q?ExWfmTa5BuwH0rq7Kr5YBEPArVZNzp05KkW//lYDw1XZftKlefhm+KXMo0EX?=
 =?us-ascii?Q?t/mMEIeQmmXMRb1ehqW1Oazf01detf7dVtFH/rAM1RJC7ZYwRQsIXVoWHB6N?=
 =?us-ascii?Q?6MPGgP60hAUik9vgCanWttnOc04GtBAsJ3GqX5v4+1yDrSwHMVC4z2IfO6J5?=
 =?us-ascii?Q?CnTCjqHF8p3KEh2w4Kkf5r7gWQONXK6oB1C5IQF/OizePviyON17GTWAY+tv?=
 =?us-ascii?Q?ShiEzgjwsc5HOkKmQURI4GwxC/cw0vv/APwU4zvyw5vygj8F7Z5d4KzPBuTO?=
 =?us-ascii?Q?DWb7sl+eezt+gqGRYbgUEY4JfsLB6YVd9Pj5698geSJMAZcWqpVWA73DIC3I?=
 =?us-ascii?Q?ateY+ert2o6vegT1kOlU+8WNSjSBS0UlSWnG9novNppUOx3TsaADuvtroi71?=
 =?us-ascii?Q?z+UOwfyOxUvFV2LUzZcakYUjeW0jFWSsOJ4deiql/xscEzFjUQeQpnwSj6yE?=
 =?us-ascii?Q?gqf0YUu4wYaQgyphKYAzzoLrTmuoTzM3uaUN5RjQUodXaw2+tGJLTZKjtmge?=
 =?us-ascii?Q?MmzhvOwjs92JLSY5igeRtakd+BQOrr4SBsRfHk2zu5p9ErAIXgT8agVbBPFk?=
 =?us-ascii?Q?Xg=3D=3D?=
X-MS-Exchange-CrossTenant-Network-Message-Id: 745adbcf-2a9e-4b4b-e4e1-08da66a9ae97
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:33:39.3386
 (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: ijjFfylAeCLe0Qy8POExQjE9yhf3eV2E0E9fmg3/YeJXdFLjbhI81+HzeCKwK4+pUXGxv565BiCYHd/BHBlc4Q==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR11MB3016
X-OriginatorOrg: intel.com
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_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:15AM +0100, Mauro Carvalho Chehab wrote:
> Building docs currently produces this warning:
> 
> 	Documentation/foo/i915:159: ./drivers/gpu/drm/i915/i915_scatterlist.h:73: WARNING: Inline strong start-string without end-string.
> 
> That's because @foo evaluates into **foo**, and placing anything
> after it without spaces cause Sphinx to warn and do the wrong
> thing.. So, replace them by a different Sphinx-compatible tag.
> 
> 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_scatterlist.h | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/drivers/gpu/drm/i915/i915_scatterlist.h b/drivers/gpu/drm/i915/i915_scatterlist.h
> index 0b8bf4be4330..5b5c4eee0f44 100644
> --- a/drivers/gpu/drm/i915/i915_scatterlist.h
> +++ b/drivers/gpu/drm/i915/i915_scatterlist.h
> @@ -70,7 +70,7 @@ static inline struct scatterlist *____sg_next(struct scatterlist *sg)
>   *
>   * Description:
>   *   If the entry is the last, return NULL; otherwise, step to the next
> - *   element in the array (@sg@+1). If that's a chain pointer, follow it;
> + *   element in the array (``sg@+1``). If that's a chain pointer, follow it;
>   *   otherwise just return the pointer to the current element.
>   **/
>  static inline struct scatterlist *__sg_next(struct scatterlist *sg)
> -- 
> 2.36.1
>