From 9f69e1c0e9a958e1cceaf4445045f9a602d14ff3 Mon Sep 17 00:00:00 2001 From: hanzhijian Date: Mon, 6 Jul 2026 11:27:06 +0800 Subject: [PATCH] Documentation: fill in pass1 directory description in organization.rst Replace the TODO placeholder with a description of the two-pass build mechanism (CONFIG_BUILD_2PASS). pass1/ supports two-pass builds where application-generated source files are compiled and linked into the kernel address space during pass 2, primarily for kernel symbol table generation required by loadable kernel modules. Signed-off-by: hanzhijian Author: hanzhijian --- Documentation/quickstart/organization.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/Documentation/quickstart/organization.rst b/Documentation/quickstart/organization.rst index af0cb591ebe..6d80e7f2e09 100644 --- a/Documentation/quickstart/organization.rst +++ b/Documentation/quickstart/organization.rst @@ -193,7 +193,15 @@ For details see :doc:`/components/openamp`. ``nuttx/pass1`` =============== -TODO +This directory provides support for the two-pass build +(``CONFIG_BUILD_2PASS=y``). In a two-pass build, the application logic +is built during pass 1 and the operating system kernel during pass 2. +Applications may generate and install source files into this directory +during pass 1; those files are then compiled and linked into the kernel +address space during pass 2. + +The primary use of this mechanism is to generate kernel symbol tables +required for loadable kernel module support. ``nuttx/sched`` ===============