* [PATCH] Documentation: gpu: add acceleration node section
@ 2023-02-23 2:52 Dylan Le
2023-02-23 4:25 ` Bagas Sanjaya
0 siblings, 1 reply; 5+ messages in thread
From: Dylan Le @ 2023-02-23 2:52 UTC (permalink / raw)
To: David Airlie, Daniel Vetter, Maarten Lankhorst, Maxime Ripard,
Thomas Zimmermann, Jonathan Corbet
Cc: Dylan Le, Shuah Khan, linux-kernel, dri-devel, linux-doc
This patch was initially written for the Linux Kernel Bug Fixing Mentorship
program. The patch adds a temporarily stubbed section on Acceleration Nodes
to resolve a documentation warning.
This resolves the warning:
./Documentation/gpu/drm-internals:179: ./include/drm/drm_file.h:411: WARNING: undefined label: drm_accel_node
I would appreciate any feedback on what should be documented here.
Signed-off-by: Dylan Le <self@dylanle.dev>
---
Documentation/gpu/drm-uapi.rst | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/Documentation/gpu/drm-uapi.rst b/Documentation/gpu/drm-uapi.rst
index ce47b4292..d25539862 100644
--- a/Documentation/gpu/drm-uapi.rst
+++ b/Documentation/gpu/drm-uapi.rst
@@ -175,6 +175,15 @@ other hand, a driver requires shared state between clients which is
visible to user-space and accessible beyond open-file boundaries, they
cannot support render nodes.
+.. _drm_accel_node:
+
+Acceleration nodes
+==================
+
+.. note::
+ There is not any documentation yet need to figure out what this is.
+
+
Device Hot-Unplug
=================
--
2.30.2
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH] Documentation: gpu: add acceleration node section
2023-02-23 2:52 [PATCH] Documentation: gpu: add acceleration node section Dylan Le
@ 2023-02-23 4:25 ` Bagas Sanjaya
2023-02-27 16:43 ` Jeffrey Hugo
2023-03-03 14:49 ` Dylan Le
0 siblings, 2 replies; 5+ messages in thread
From: Bagas Sanjaya @ 2023-02-23 4:25 UTC (permalink / raw)
To: Dylan Le, David Airlie, Daniel Vetter, Maarten Lankhorst,
Maxime Ripard, Thomas Zimmermann, Jonathan Corbet
Cc: Shuah Khan, linux-kernel, dri-devel, linux-doc
[-- Attachment #1: Type: text/plain, Size: 1289 bytes --]
On Thu, Feb 23, 2023 at 02:52:52AM +0000, Dylan Le wrote:
>
> This patch was initially written for the Linux Kernel Bug Fixing Mentorship
> program. The patch adds a temporarily stubbed section on Acceleration Nodes
> to resolve a documentation warning.
>
> This resolves the warning:
> ./Documentation/gpu/drm-internals:179: ./include/drm/drm_file.h:411: WARNING: undefined label: drm_accel_node
Please write the patch description in imperative mood ("Do foo" instead
of "This patch does foo").
>
> I would appreciate any feedback on what should be documented here.
I think above is better placed between the three dashes and diffstat ...
> ---
like here.
> Documentation/gpu/drm-uapi.rst | 9 +++++++++
> 1 file changed, 9 insertions(+)
>
> +.. _drm_accel_node:
> +
> +Acceleration nodes
> +==================
> +
> +.. note::
> + There is not any documentation yet need to figure out what this is.
I'd like to write this stub as generic .. admonition:: block [1] instead,
with the content which is "This section is empty, add appropriate
documentation here." or similar.
[1]: https://docutils.sourceforge.io/docs/ref/rst/directives.html#generic-admonition
Thanks.
--
An old man doll... just what I always wanted! - Clara
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] Documentation: gpu: add acceleration node section
2023-02-23 4:25 ` Bagas Sanjaya
@ 2023-02-27 16:43 ` Jeffrey Hugo
2023-02-28 7:59 ` Bagas Sanjaya
2023-03-03 14:49 ` Dylan Le
1 sibling, 1 reply; 5+ messages in thread
From: Jeffrey Hugo @ 2023-02-27 16:43 UTC (permalink / raw)
To: Bagas Sanjaya, ogabbay
Cc: Dylan Le, Thomas Zimmermann, Jonathan Corbet, linux-doc,
linux-kernel, dri-devel, Shuah Khan
I'm thinking the drm_file.h reference is broken. I suspect it should
reference Documentation/accel/index.rst
Oded?
On Wed, Feb 22, 2023 at 9:25 PM Bagas Sanjaya <bagasdotme@gmail.com> wrote:
>
> On Thu, Feb 23, 2023 at 02:52:52AM +0000, Dylan Le wrote:
> >
> > This patch was initially written for the Linux Kernel Bug Fixing Mentorship
> > program. The patch adds a temporarily stubbed section on Acceleration Nodes
> > to resolve a documentation warning.
> >
> > This resolves the warning:
> > ./Documentation/gpu/drm-internals:179: ./include/drm/drm_file.h:411: WARNING: undefined label: drm_accel_node
>
> Please write the patch description in imperative mood ("Do foo" instead
> of "This patch does foo").
>
> >
> > I would appreciate any feedback on what should be documented here.
>
> I think above is better placed between the three dashes and diffstat ...
>
>
> > ---
>
> like here.
>
> > Documentation/gpu/drm-uapi.rst | 9 +++++++++
> > 1 file changed, 9 insertions(+)
> >
>
> > +.. _drm_accel_node:
> > +
> > +Acceleration nodes
> > +==================
> > +
> > +.. note::
> > + There is not any documentation yet need to figure out what this is.
>
> I'd like to write this stub as generic .. admonition:: block [1] instead,
> with the content which is "This section is empty, add appropriate
> documentation here." or similar.
>
> [1]: https://docutils.sourceforge.io/docs/ref/rst/directives.html#generic-admonition
>
> Thanks.
>
> --
> An old man doll... just what I always wanted! - Clara
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] Documentation: gpu: add acceleration node section
2023-02-27 16:43 ` Jeffrey Hugo
@ 2023-02-28 7:59 ` Bagas Sanjaya
0 siblings, 0 replies; 5+ messages in thread
From: Bagas Sanjaya @ 2023-02-28 7:59 UTC (permalink / raw)
To: Jeffrey Hugo, ogabbay
Cc: Dylan Le, Thomas Zimmermann, Jonathan Corbet, linux-doc,
linux-kernel, dri-devel, Shuah Khan
On 2/27/23 23:43, Jeffrey Hugo wrote:
> I'm thinking the drm_file.h reference is broken. I suspect it should
> reference Documentation/accel/index.rst
>
I think so, but since the doc tree above only contains "Introduction"
doc, the reference should be that doc, right?
--
An old man doll... just what I always wanted! - Clara
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] Documentation: gpu: add acceleration node section
2023-02-23 4:25 ` Bagas Sanjaya
2023-02-27 16:43 ` Jeffrey Hugo
@ 2023-03-03 14:49 ` Dylan Le
1 sibling, 0 replies; 5+ messages in thread
From: Dylan Le @ 2023-03-03 14:49 UTC (permalink / raw)
To: Bagas Sanjaya
Cc: Thomas Zimmermann, Jonathan Corbet, linux-doc, linux-kernel,
dri-devel, Shuah Khan
On Wednesday, February 22nd, 2023 at 11:25 PM, Bagas Sanjaya <bagasdotme@gmail.com> wrote:
>
>
> On Thu, Feb 23, 2023 at 02:52:52AM +0000, Dylan Le wrote:
>
> > This patch was initially written for the Linux Kernel Bug Fixing Mentorship
> > program. The patch adds a temporarily stubbed section on Acceleration Nodes
> > to resolve a documentation warning.
> >
> > This resolves the warning:
> > ./Documentation/gpu/drm-internals:179: ./include/drm/drm_file.h:411: WARNING: undefined label: drm_accel_node
>
>
> Please write the patch description in imperative mood ("Do foo" instead
> of "This patch does foo").
>
> > I would appreciate any feedback on what should be documented here.
>
>
> I think above is better placed between the three dashes and diffstat ...
>
> > ---
>
>
> like here.
>
> > Documentation/gpu/drm-uapi.rst | 9 +++++++++
> > 1 file changed, 9 insertions(+)
>
> > +.. _drm_accel_node:
> > +
> > +Acceleration nodes
> > +==================
> > +
> > +.. note::
> > + There is not any documentation yet need to figure out what this is.
>
>
> I'd like to write this stub as generic .. admonition:: block [1] instead,
> with the content which is "This section is empty, add appropriate
> documentation here." or similar.
>
> [1]: https://docutils.sourceforge.io/docs/ref/rst/directives.html#generic-admonition
>
> Thanks.
>
> --
> An old man doll... just what I always wanted! - Clara
Thank you Bagas for the feedback,
I prematurely sent a v2 of this patch taking into account your feedback, but I will hold off on other changes. Since there seems to be another discussion about a broken reference in drm_file.h.
If there is something I can look at in the meantime let me know.
Thanks,
Dylan Le
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2023-03-03 14:49 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-02-23 2:52 [PATCH] Documentation: gpu: add acceleration node section Dylan Le
2023-02-23 4:25 ` Bagas Sanjaya
2023-02-27 16:43 ` Jeffrey Hugo
2023-02-28 7:59 ` Bagas Sanjaya
2023-03-03 14:49 ` Dylan Le
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).