@@ -45,3 +45,50 @@ The "immediate" mode has a lot of limitations but it is also useful in certain s
4545 * build.toml contains the target information.
4646 * host_or_cross_toolchain.toml contains the host/cross toolchain information
4747 * We can combine the two into one .toml file.
48+
49+
50+ Helloworld "immediate" example
51+ ------------------------------
52+
53+ * Write your ``build.toml `` file
54+ * Invoke ``buildexe `` from the command line from the **[workspace] ** folder
55+ * Pay attention to the ``root_dir `` and ``build_dir `` parameters set in your ``build.toml `` file.
56+ * These directories are relative to the directory from which you **invoke ** buildexe
57+
58+ ..code-block ::bash
59+
60+ ./buildexe --config build.toml --config$BUILDCC_HOME /host/host_toolchain.toml
61+
62+ [build_dir]/[toolchain_name]/[target_name] `` (taken from ``build.toml ``)
63+
64+ Directory structure
65+ ++++++++++++++++++++
66+
67+ ..uml ::
68+
69+ @startmindmap
70+ * [workspace]
71+ ** [src]
72+ *** main.cpp
73+ ** build.toml
74+ @endmindmap
75+
76+ Write your ``build.toml `` file
77+ +++++++++++++++++++++++++++++++
78+
79+ ..code-block ::toml
80+
81+ # Settings
82+ root_dir = ""
83+ build_dir = "_build"
84+ loglevel = "info"
85+ clean = false
86+
87+ # BuildExe run mode
88+ mode = "immediate"
89+
90+ # Target information
91+ name = "hello_world"
92+ type = "executable"
93+ relative_to_root = "src"
94+ srcs = ["main.cpp"]