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:40:25 -0400
From:   Rodrigo Vivi <rodrigo.vivi@intel.com>
To:     Mauro Carvalho Chehab <mchehab@kernel.org>
CC:     <dri-devel@lists.freedesktop.org>, David Airlie <airlied@linux.ie>,
        <linux-kernel@vger.kernel.org>,
        Juha-Pekka =?iso-8859-1?Q?Heikkil=E4?= 
        <juha-pekka.heikkila@intel.com>, <intel-gfx@lists.freedesktop.org>
Subject: Re: [Intel-gfx] [PATCH v2 16/39] drm/i915: intel_fb: fix a
 kernel-doc issue with Sphinx
Message-ID: <YtHeySNYE+B3XJ7w@intel.com>
References: <cover.1657699522.git.mchehab@kernel.org>
 <5647d7b6ffe47f53b90342e4ad881d4d4e6b005b.1657699522.git.mchehab@kernel.org>
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <5647d7b6ffe47f53b90342e4ad881d4d4e6b005b.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?lVcOH8C5FFEhYqkbzESgPpn7XRKx6YFHNZoA8qy/BF4tp6nbouWvBNQCKalA?=
 =?us-ascii?Q?g3HUvM9r4mSRgppgU0No19akQg8dLhqmOEsjW2mkUWNPGAIzRCLApRQgAOYU?=
 =?us-ascii?Q?jL7SuKZMQHxcZ/00a2YQnsBa6U0gsxjL73x/83Wkd9czzd3FIvOsDHuUARB1?=
 =?us-ascii?Q?HXlk8+LlSyjNNj/x2srudjFAFCSKQgx+O8x/zG4m2MMttyg+8JwqcFfNR+1W?=
 =?us-ascii?Q?vCBWeGr/llvoLa5XbZfeof19rcKUE8AvyWbalNbzZBtSbIwwlA0Mbyx7Ei1F?=
 =?us-ascii?Q?RCILWofCPe9Fmuyn17N+AtLD4drf+/s5EmuPEEIrUbSl2xWqkEPcV7CQ6B8d?=
 =?us-ascii?Q?l83jHBpqq+u3WkLPApQUx88GL15Rvr+d+sQ5R9wOV4XqfNJOVYSgPuqMPxzZ?=
 =?us-ascii?Q?xnoqLJiTIRrWq15NAdAZ/OA7uQDkGCuPxgqmC8qhAk+hO4Jg9EKHW5gBFztn?=
 =?us-ascii?Q?m+ta8dhHQBZQupr+beJDI56gd5T3S9s5y2QG0w53vJWDRm+hyXK1sN+K/3BZ?=
 =?us-ascii?Q?wf1ZCJQOD5Y2TUQ/uU0sRLCcqSrzYw8n86KUIp1hQKsifF0mz3d7I8pzUFNc?=
 =?us-ascii?Q?TgdosxZYBaGGE2sloP//GjRT5H7riE9f/yzmiufnR6RabJRvdWL7nBzorkPc?=
 =?us-ascii?Q?9oXLy12+QgpWCBycdfW6cZw+Z6ot8shUAs65PNFOTpMRKYoQCpKeQrkm7qF2?=
 =?us-ascii?Q?S1qVSQFd3M2GsYDjGHYGE2XxAdGpB6Z3tGlN+R1O/HNtcyA8niSX59i19tKU?=
 =?us-ascii?Q?ytt6/P8dZy+Gg2Ie7Grjx9A0Rmi+9cDW9LS4XD2dYEfE6kFP5jm6lawqZ/zx?=
 =?us-ascii?Q?UFPSfOey8FOEvA+m4j/qQpdnjVlOl8rp2eqdIz6nL8xXxo8DNSScb5xy12SQ?=
 =?us-ascii?Q?tUwUHsiKB5omxmDuirwqT9i8VUCemEpA6ImhwT9a9k9OueCG6rcQXC4Hte7S?=
 =?us-ascii?Q?MP/6dEH26hJb2tTbVWQaBVEqQvAIRYBsn5OmU9Z4E7FxeYkWSU6TBrZjhRe/?=
 =?us-ascii?Q?7KIlxTas/Rj7h8/mAqL2t74AzMRiRqKfZN7orICP5H+dIFKRIG+fmI+DoZa2?=
 =?us-ascii?Q?1VsYpWCGpJGW1lBTNOa4g12gDSF8V6/9FF5Ozizz5tucS/6tfjSgXpfGoDn8?=
 =?us-ascii?Q?VwwK7AQQ+MlSEpUArXg2JaLgj3io6WGXurV8oRevQLgcC8X+FuT4b9NoobSS?=
 =?us-ascii?Q?K9RklvH+Z4y+HJOImWTH8tIq/t5rbqttN0OjC4gTqIpSz2xXaV3N0xEP3nAL?=
 =?us-ascii?Q?E/QVbIyTGjIK2Lwq5JHBWDEQkXXxPsLjf2/J0hbYAyNw50BbgIr7w+dBuICH?=
 =?us-ascii?Q?GkRRVWt7YQdZmKDRJjN8cOjI/BU3FOeHBWpC5eGG7PQdba2XMO04t6vIZ1Zu?=
 =?us-ascii?Q?nqqQIdxiL7xjXx6Qu+NPbT+v3yfV8YngQO8fa+/Rv8W8uM1gw8wkV1+u8MsF?=
 =?us-ascii?Q?qdSvgzsTEi+HpU03g2S/BS0cQRDSr0yMiDii5u8d96VPsWMatuC+e5OzVsF5?=
 =?us-ascii?Q?9xXyax4FfLTzJnu0KEZuopkkYqz1bJVH7/h2UDayJgj3MKqWwFpEGhQUIm9c?=
 =?us-ascii?Q?THiMPqtwvWYrHFwcDvtwY1Qbc2Fpa02YZr350v+f7zNIERpozcAxrfcWtUCs?=
 =?us-ascii?Q?4w=3D=3D?=
X-MS-Exchange-CrossTenant-Network-Message-Id: cb457467-fed2-4744-cc38-08da66aaa32a
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:40:29.6340
 (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: vTQx4L690q/Dd5HJc342r986xcyGOzmCzVsLCzwB0ICX4eXJjFayPLBMB2BKTFrCrsUduojsyX0Dkqc9xqzfmQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH0PR11MB5234
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:04AM +0100, Mauro Carvalho Chehab wrote:
> We can't use %foo[<something>] as this produces a bad markup.
> Use instead, the emphasis markup directly.
> 
> Fix this issue:
> 	Documentation/gpu/i915:136: ./drivers/gpu/drm/i915/display/intel_fb.c:280: WARNING: Inline strong start-string without end-string.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>

Just trying to understand as well on why in a few you had chosen ```foo```
and here **foo**. why?

anyway, not a blocker:

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/display/intel_fb.c | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/drivers/gpu/drm/i915/display/intel_fb.c b/drivers/gpu/drm/i915/display/intel_fb.c
> index b191915ab351..fe72c75a9c79 100644
> --- a/drivers/gpu/drm/i915/display/intel_fb.c
> +++ b/drivers/gpu/drm/i915/display/intel_fb.c
> @@ -276,7 +276,7 @@ lookup_format_info(const struct drm_format_info formats[],
>   * @cmd: FB add command structure
>   *
>   * Returns:
> - * Returns the format information for @cmd->pixel_format specific to @cmd->modifier[0],
> + * Returns the format information for @cmd->pixel_format specific to **cmd->modifier[0]**,
>   * or %NULL if the modifier doesn't override the format.
>   */
>  const struct drm_format_info *
> -- 
> 2.36.1
>