From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 38314C001DB for ; Fri, 23 Jun 2023 14:08:30 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231636AbjFWOI3 (ORCPT ); Fri, 23 Jun 2023 10:08:29 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43030 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230008AbjFWOI1 (ORCPT ); Fri, 23 Jun 2023 10:08:27 -0400 Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0018C2688; Fri, 23 Jun 2023 07:08:25 -0700 (PDT) Received: from pendragon.ideasonboard.com (213-243-189-158.bb.dnainternet.fi [213.243.189.158]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 20409BC; Fri, 23 Jun 2023 16:07:47 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1687529267; bh=cpgwXM3+rydqPxFvhazM/zjynkiXWUsuj5v+zaCCGTU=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=sVSr0tIsPU0V5Q0U8RG/jWcYnnWS6GISMv0B7y2OZG0AvZHzdci7MRmORYSWcRHm6 0GjwBxAhRzvKlsQd0Eb4V6f2itP6bDuq9DHfHQUg3ifFPyI6Kpqrd6VKrcs1UI3cBR tmag2csb5pVvLwCjfs9fsbXRamfUJpwTVahIgjzo= Date: Fri, 23 Jun 2023 17:08:22 +0300 From: Laurent Pinchart To: Geert Uytterhoeven Cc: Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Daniel Vetter , Jonathan Corbet , Jyri Sarha , Tomi Valkeinen , Bagas Sanjaya , dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, linux-renesas-soc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v2 2/4] drm/todo: Convert list of fbconv links to footnotes Message-ID: <20230623140822.GC2112@pendragon.ideasonboard.com> References: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi Geert, Thank you for the patch. On Fri, Jun 09, 2023 at 03:44:28PM +0200, Geert Uytterhoeven wrote: > Convert the references to fbconv links to footnotes, so they can be > navigated. > > Signed-off-by: Geert Uytterhoeven > --- > v2: > - New. > --- > Documentation/gpu/todo.rst | 10 +++++----- > 1 file changed, 5 insertions(+), 5 deletions(-) > > diff --git a/Documentation/gpu/todo.rst b/Documentation/gpu/todo.rst > index 6c328613c049fc1d..ce1d4e22c327063b 100644 > --- a/Documentation/gpu/todo.rst > +++ b/Documentation/gpu/todo.rst > @@ -753,16 +753,16 @@ existing hardware. The new driver's call-back functions are filled from > existing fbdev code. > > More complex fbdev drivers can be refactored step-by-step into a DRM > -driver with the help of the DRM fbconv helpers. [1] These helpers provide > +driver with the help of the DRM fbconv helpers [4]_. These helpers provide > the transition layer between the DRM core infrastructure and the fbdev > driver interface. Create a new DRM driver on top of the fbconv helpers, > copy over the fbdev driver, and hook it up to the DRM code. Examples for > -several fbdev drivers are available at [1] and a tutorial of this process > -available at [2]. The result is a primitive DRM driver that can run X11 > +several fbdev drivers are available at [4]_ and a tutorial of this process > +available at [5]_. The result is a primitive DRM driver that can run X11 When using footnotes, the main text must read correctly if you ignore the notes. This isn't the case for the second and third footnotes here. Examples for several fbdev drivers are available in Thomas Zimmermann's fbconv tree [4]_, as well as a tutorial of this process [5]_. I'm not making a call on whether that's better or not that's better than the current situation. An alternative is to use plain links: Examples for several fbdev drivers are available in 'Thomas Zimmermann's fbconv tree`_, as well as a `tutorial of this process`_. .. _Thomas Zimmermann's fbconv tree: https://gitlab.freedesktop.org/tzimmermann/linux/tree/fbconv .. _tutorial of this process: https://gitlab.freedesktop.org/tzimmermann/linux/blob/fbconv/drivers/gpu/drm/drm_fbconv_helper.c > and Weston. > > - - [1] https://gitlab.freedesktop.org/tzimmermann/linux/tree/fbconv > - - [2] https://gitlab.freedesktop.org/tzimmermann/linux/blob/fbconv/drivers/gpu/drm/drm_fbconv_helper.c > + .. [4] https://gitlab.freedesktop.org/tzimmermann/linux/tree/fbconv > + .. [5] https://gitlab.freedesktop.org/tzimmermann/linux/blob/fbconv/drivers/gpu/drm/drm_fbconv_helper.c > > Contact: Thomas Zimmermann > -- Regards, Laurent Pinchart