This is an automated email from the ASF dual-hosted git repository.
acassis pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git
The following commit(s) were added to refs/heads/master by this push:
new 9f69e1c0e9a Documentation: fill in pass1 directory description in
organization.rst
9f69e1c0e9a is described below
commit 9f69e1c0e9a958e1cceaf4445045f9a602d14ff3
Author: hanzhijian <[email protected]>
AuthorDate: Mon Jul 6 11:27:06 2026 +0800
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 <[email protected]>
Author: hanzhijian <[email protected]>
---
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``
===============
