This is an automated email from the ASF dual-hosted git repository.
xiaoxiang781216 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 ae0210479d7 doc/nxdoom: Improve the nxdoom doc to let user play it
ae0210479d7 is described below
commit ae0210479d78aee9c4a3fb78c8742d7a2b71a6d7
Author: Alan Carvalho de Assis <[email protected]>
AuthorDate: Fri Jul 3 10:05:55 2026 -0300
doc/nxdoom: Improve the nxdoom doc to let user play it
It is very easy to get NXDoom running on NuttX, but the instructions
was omitting the needed steps to get it running on Simulator.
Signed-off-by: Alan C. Assis <[email protected]>
---
Documentation/platforms/sim/sim/boards/sim/index.rst | 13 +++++++++++++
1 file changed, 13 insertions(+)
diff --git a/Documentation/platforms/sim/sim/boards/sim/index.rst
b/Documentation/platforms/sim/sim/boards/sim/index.rst
index 7c1fde0b91c..da849afb5fe 100644
--- a/Documentation/platforms/sim/sim/boards/sim/index.rst
+++ b/Documentation/platforms/sim/sim/boards/sim/index.rst
@@ -952,6 +952,19 @@ nxdoom
Play :doc:`NXDoom </applications/games/nxdoom/index>` on the Simulator using
X11
keyboard input and graphics. Read the docs for NXDoom to see how to play.
+By default this NuttX board config mounts the current directory from the host
where it was executed, making the files visible internally at /data directory.
+So you can copy the DOOM1.WAD (or other WAD file) to the current directory
where
+you compiled NuttX and run Doom from there:
+
+.. code:: console
+
+ $ cp ~/Download/DOOM1.WAD .
+ $ ./nuttx
+ NuttShell (NSH) NuttX-13.0.0
+ nsh> ls -l /data/DOOM1.WAD
+ -rw-rw-r-- 4196020 2026-07-03 12:32 /data/DOOM1.WAD
+ nsh> nxdoom -iwad /data/DOOM1.WAD
+
.. warning::
X11 keyboard codes are not perfectly translated to the NuttX codec
currently,
