[0/5] docs: improve the memory API documentation

Message

Alex Bennée March 7, 2024, 6:11 p.m. UTC

As I've been looking through the Memory API for our Xen work I thought
I should take the time to clean it up. I needed to teach kdoc about
our QLIST_ macros and I found at least one unused field in the
structure.

Looking through the definitions I do wander if the meaning of
romd_mode and ram_device could be cleaned up to a single bool
(directly_mapped or use_ops?).

Anyway for now just cosmetic improvements to the docs as we are close
to softfreeze.

Alex.

Alex Bennée (5):
  scripts/kernel-doc: teach kdoc about QLIST_ macros
  docs: include ramblock.h in the memory API docs
  include/exec: remove warning_printed from MemoryRegion
  include/exec: annotate all the MemoryRegion fields
  docs/devel: mark out defined functions and structures

 docs/devel/memory.rst   | 49 +++++++++++++-------------
 include/exec/memory.h   | 48 +++++++++++++++++++++++---
 include/exec/ramblock.h | 76 +++++++++++++++++++++++++++--------------
 scripts/kernel-doc      |  9 ++++-
 4 files changed, 127 insertions(+), 55 deletions(-)