* [PATCH] docs: Hook the RTLA documents into the kernel docs build
@ 2022-01-21 0:00 Jonathan Corbet
2022-01-23 1:57 ` Steven Rostedt
2022-01-25 8:33 ` Daniel Bristot de Oliveira
0 siblings, 2 replies; 3+ messages in thread
From: Jonathan Corbet @ 2022-01-21 0:00 UTC (permalink / raw)
To: Steven Rostedt
Cc: linux-kernel, linux-rt-users, linux-trace-devel,
Daniel Bristot de Oliveira
The RTLA documents were added to Documentation/ but never hooked into the
rest of the docs build, leading to a bunch of warnings like:
Documentation/tools/rtla/rtla-osnoise.rst: WARNING: document isn't included in any toctree
Add some basic glue to wire these documents into the build so that they are
available with the rest of the rendered docs. No attempt has been made to
turn the RTLA docs into proper RST files rather than warmed-over man pages;
that is an exercise for the future.
Fixes: d40d48e1f1f2 ("rtla: Add Documentation")
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
---
I'm happy to see this follow the original via the tracing tree, or I can
send it Linusward myself once docs-next catches up with mainline.
Documentation/index.rst | 1 +
Documentation/tools/index.rst | 18 ++++++++++++++++++
Documentation/tools/rtla/index.rst | 24 ++++++++++++++++++++++++
3 files changed, 43 insertions(+)
create mode 100644 Documentation/tools/index.rst
create mode 100644 Documentation/tools/rtla/index.rst
diff --git a/Documentation/index.rst b/Documentation/index.rst
index 2b4de3926858..b58692d687f6 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -166,6 +166,7 @@ to ReStructured Text format, or are simply too old.
.. toctree::
:maxdepth: 2
+ tools/index
staging/index
watch_queue
diff --git a/Documentation/tools/index.rst b/Documentation/tools/index.rst
new file mode 100644
index 000000000000..18f5f4583996
--- /dev/null
+++ b/Documentation/tools/index.rst
@@ -0,0 +1,18 @@
+============
+Kernel tools
+============
+
+This book covers user-space tools that are shipped with the kernel source;
+more additions are needed here:
+
+.. toctree::
+ :maxdepth: 1
+
+ rtla/index
+
+.. only:: subproject and html
+
+ Indices
+ =======
+
+ * :ref:`genindex`
diff --git a/Documentation/tools/rtla/index.rst b/Documentation/tools/rtla/index.rst
new file mode 100644
index 000000000000..5938009bf4ae
--- /dev/null
+++ b/Documentation/tools/rtla/index.rst
@@ -0,0 +1,24 @@
+================================
+The realtime Linux analysis tool
+================================
+
+RTLA provides a set of tools for the analysis of the kernel's realtime
+behavior on specific hardware.
+
+.. toctree::
+ :maxdepth: 1
+
+ rtla
+ rtla-osnoise
+ rtla-osnoise-hist
+ rtla-osnoise-top
+ rtla-timerlat
+ rtla-timerlat-hist
+ rtla-timerlat-top
+
+.. only:: subproject and html
+
+ Indices
+ =======
+
+ * :ref:`genindex`
--
2.34.1
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH] docs: Hook the RTLA documents into the kernel docs build
2022-01-21 0:00 [PATCH] docs: Hook the RTLA documents into the kernel docs build Jonathan Corbet
@ 2022-01-23 1:57 ` Steven Rostedt
2022-01-25 8:33 ` Daniel Bristot de Oliveira
1 sibling, 0 replies; 3+ messages in thread
From: Steven Rostedt @ 2022-01-23 1:57 UTC (permalink / raw)
To: Jonathan Corbet
Cc: linux-kernel, linux-rt-users, linux-trace-devel,
Daniel Bristot de Oliveira
On Thu, 20 Jan 2022 17:00:33 -0700
Jonathan Corbet <corbet@lwn.net> wrote:
> The RTLA documents were added to Documentation/ but never hooked into the
> rest of the docs build, leading to a bunch of warnings like:
>
> Documentation/tools/rtla/rtla-osnoise.rst: WARNING: document isn't included in any toctree
>
> Add some basic glue to wire these documents into the build so that they are
> available with the rest of the rendered docs. No attempt has been made to
> turn the RTLA docs into proper RST files rather than warmed-over man pages;
> that is an exercise for the future.
Looks fine to me.
Acked-by: Steven Rostedt (Google) <rostedt@goodmis.org>
-- Steve
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH] docs: Hook the RTLA documents into the kernel docs build
2022-01-21 0:00 [PATCH] docs: Hook the RTLA documents into the kernel docs build Jonathan Corbet
2022-01-23 1:57 ` Steven Rostedt
@ 2022-01-25 8:33 ` Daniel Bristot de Oliveira
1 sibling, 0 replies; 3+ messages in thread
From: Daniel Bristot de Oliveira @ 2022-01-25 8:33 UTC (permalink / raw)
To: Jonathan Corbet
Cc: linux-kernel, linux-rt-users, linux-trace-devel, Steven Rostedt
On 1/21/22 01:00, Jonathan Corbet wrote:
> The RTLA documents were added to Documentation/ but never hooked into the
> rest of the docs build, leading to a bunch of warnings like:
>
> Documentation/tools/rtla/rtla-osnoise.rst: WARNING: document isn't included in any toctree
>
> Add some basic glue to wire these documents into the build so that they are
> available with the rest of the rendered docs. No attempt has been made to
> turn the RTLA docs into proper RST files rather than warmed-over man pages;
> that is an exercise for the future.
>
> Fixes: d40d48e1f1f2 ("rtla: Add Documentation")
> Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Acked-by: Daniel Bristot de Oliveira <bristot@kernel.org>
Thanks, Jon!
-- Daniel
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2022-01-25 9:15 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-01-21 0:00 [PATCH] docs: Hook the RTLA documents into the kernel docs build Jonathan Corbet
2022-01-23 1:57 ` Steven Rostedt
2022-01-25 8:33 ` Daniel Bristot de Oliveira
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.