Hi Jonathan, On Thu, Mar 20, 2025 at 08:45:03 -0600, Jonathan Corbet <corbet@xxxxxxx> wrote: > Changyuan Lyu <changyuanl@xxxxxxxxxx> writes: > > > From: Alexander Graf <graf@xxxxxxxxxx> > > > > With KHO in place, let's add documentation that describes what it is and > > how to use it. > > > > Signed-off-by: Alexander Graf <graf@xxxxxxxxxx> > > Co-developed-by: Mike Rapoport (Microsoft) <rppt@xxxxxxxxxx> > > Signed-off-by: Mike Rapoport (Microsoft) <rppt@xxxxxxxxxx> > > Co-developed-by: Changyuan Lyu <changyuanl@xxxxxxxxxx> > > Signed-off-by: Changyuan Lyu <changyuanl@xxxxxxxxxx> > > --- > > .../admin-guide/kernel-parameters.txt | 25 ++++ > > Documentation/kho/concepts.rst | 70 +++++++++++ > > Documentation/kho/fdt.rst | 62 +++++++++ > > Documentation/kho/index.rst | 14 +++ > > Documentation/kho/usage.rst | 118 ++++++++++++++++++ > > Documentation/subsystem-apis.rst | 1 + > > MAINTAINERS | 1 + > > 7 files changed, 291 insertions(+) > > create mode 100644 Documentation/kho/concepts.rst > > create mode 100644 Documentation/kho/fdt.rst > > create mode 100644 Documentation/kho/index.rst > > create mode 100644 Documentation/kho/usage.rst > > I will ask again: please let's not create another top-level docs > directory for this...? It looks like it belongs in the admin guide to > me. Thanks for review the patch! Sure I will move usage.rst to Documentation/admin-guide in the next version. However, I think concepts.rst and fdt.rst are not not end-user oriented, but for kernel developers of other subsystems to use KHO API (I also plan to include the kernel-doc generated from kernel/kexec_handover.c and include/linux/kexec_handover.h here in the next version). Should Documentation/core-api be a better choice? Best, Changyuan
