* [PATCH] docs: consolidate core subsystems
@ 2023-06-22 7:10 Costa Shulyupin
2023-06-22 15:35 ` Randy Dunlap
2023-07-14 19:38 ` Jonathan Corbet
0 siblings, 2 replies; 4+ messages in thread
From: Costa Shulyupin @ 2023-06-22 7:10 UTC (permalink / raw)
To: Jonathan Corbet, linux-doc; +Cc: Costa Shulyupin, open list
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset=true, Size: 1434 bytes --]
to make the page more organized as requested
Signed-off-by: Costa Shulyupin <costa.shul@redhat.com>
---
Documentation/subsystem-apis.rst | 21 ++++++++++++++-------
1 file changed, 14 insertions(+), 7 deletions(-)
diff --git a/Documentation/subsystem-apis.rst b/Documentation/subsystem-apis.rst
index b67a1b65855b..8664b05777c3 100644
--- a/Documentation/subsystem-apis.rst
+++ b/Documentation/subsystem-apis.rst
@@ -10,6 +10,20 @@ is taken directly from the kernel source, with supplemental material added
as needed (or at least as we managed to add it — probably *not* all that is
needed).
+Core subsystems
+---------------
+
+.. toctree::
+ :maxdepth: 1
+
+ core-api/index
+ driver-api/index
+ mm/index
+ power/index
+ scheduler/index
+ timers/index
+ locking/index
+
Human interfaces
----------------
@@ -39,9 +53,6 @@ Storage interfaces
.. toctree::
:maxdepth: 1
- driver-api/index
- core-api/index
- locking/index
accounting/index
cpu-freq/index
fpga/index
@@ -53,8 +64,6 @@ Storage interfaces
netlabel/index
networking/index
pcmcia/index
- power/index
- timers/index
spi/index
w1/index
watchdog/index
@@ -63,12 +72,10 @@ Storage interfaces
accel/index
security/index
crypto/index
- mm/index
bpf/index
usb/index
PCI/index
misc-devices/index
- scheduler/index
mhi/index
peci/index
wmi/index
--
2.41.0
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH] docs: consolidate core subsystems
2023-06-22 7:10 [PATCH] docs: consolidate core subsystems Costa Shulyupin
@ 2023-06-22 15:35 ` Randy Dunlap
2023-06-22 16:57 ` Costa Shulyupin
2023-07-14 19:38 ` Jonathan Corbet
1 sibling, 1 reply; 4+ messages in thread
From: Randy Dunlap @ 2023-06-22 15:35 UTC (permalink / raw)
To: Costa Shulyupin, Jonathan Corbet, linux-doc; +Cc: open list
Hi--
On 6/22/23 00:10, Costa Shulyupin wrote:
> to make the page more organized as requested
>
> Signed-off-by: Costa Shulyupin <costa.shul@redhat.com>
> ---
> Documentation/subsystem-apis.rst | 21 ++++++++++++++-------
> 1 file changed, 14 insertions(+), 7 deletions(-)
>
> diff --git a/Documentation/subsystem-apis.rst b/Documentation/subsystem-apis.rst
> index b67a1b65855b..8664b05777c3 100644
> --- a/Documentation/subsystem-apis.rst
> +++ b/Documentation/subsystem-apis.rst
> @@ -10,6 +10,20 @@ is taken directly from the kernel source, with supplemental material added
> as needed (or at least as we managed to add it — probably *not* all that is
> needed).
>
> +Core subsystems
> +---------------
> +
> +.. toctree::
> + :maxdepth: 1
> +
> + core-api/index
> + driver-api/index
> + mm/index
> + power/index
> + scheduler/index
> + timers/index
> + locking/index
> +
In general I am OK with this grouping, except for 2 nits:
a. I'm not sure that locking is a subsystem (it's a core API IMO).
b. I often have trouble finding "filesystems" and I think that it should be
given a higher location in the TOC (somehow).
thanks.
--
~Randy
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] docs: consolidate core subsystems
2023-06-22 15:35 ` Randy Dunlap
@ 2023-06-22 16:57 ` Costa Shulyupin
0 siblings, 0 replies; 4+ messages in thread
From: Costa Shulyupin @ 2023-06-22 16:57 UTC (permalink / raw)
To: Randy Dunlap; +Cc: Jonathan Corbet, linux-doc, open list
On Thu, 22 Jun 2023 at 18:36, Randy Dunlap <rdunlap@infradead.org> wrote:
> a. I'm not sure that locking is a subsystem (it's a core API IMO).
Actually https://docs.kernel.org/locking/index.html describes more
than just API.
> b. I often have trouble finding "filesystems" and I think that it should be
> given a higher location in the TOC (somehow).
I plan to put "filesystems" under "Storage subsystems" in the next patch.
Thanks
Costa
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] docs: consolidate core subsystems
2023-06-22 7:10 [PATCH] docs: consolidate core subsystems Costa Shulyupin
2023-06-22 15:35 ` Randy Dunlap
@ 2023-07-14 19:38 ` Jonathan Corbet
1 sibling, 0 replies; 4+ messages in thread
From: Jonathan Corbet @ 2023-07-14 19:38 UTC (permalink / raw)
To: Costa Shulyupin, linux-doc; +Cc: Costa Shulyupin, open list
Costa Shulyupin <costa.shul@redhat.com> writes:
> to make the page more organized as requested
>
> Signed-off-by: Costa Shulyupin <costa.shul@redhat.com>
> ---
> Documentation/subsystem-apis.rst | 21 ++++++++++++++-------
> 1 file changed, 14 insertions(+), 7 deletions(-)
Applied, thanks.
jon
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2023-07-14 19:38 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-06-22 7:10 [PATCH] docs: consolidate core subsystems Costa Shulyupin
2023-06-22 15:35 ` Randy Dunlap
2023-06-22 16:57 ` Costa Shulyupin
2023-07-14 19:38 ` Jonathan Corbet
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.