aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/src/architecture.dox15
-rw-r--r--docs/src/createthread.dox2
-rw-r--r--docs/src/memory.dox2
-rw-r--r--docs/src/portguide.dox6
-rw-r--r--readme.txt1
5 files changed, 20 insertions, 6 deletions
diff --git a/docs/src/architecture.dox b/docs/src/architecture.dox
index d9a512b10..e5a73239e 100644
--- a/docs/src/architecture.dox
+++ b/docs/src/architecture.dox
@@ -59,6 +59,7 @@
Platform [label="Platform"];
Kernel [label="Kernel"];
Port [label="Port"];
+ Board [label="Board Setup"];
HW [label="Hardware", style="filled", width="3.0", height="0.3"];
Application -> Kernel;
@@ -66,9 +67,12 @@
Application -> HW [label=" (not recommended)"];
HAL -> Platform;
HAL -> Kernel;
+ Board -> HW;
Platform -> Kernel;
+ Platform -> Board;
Platform -> HW;
Kernel -> Port;
+ Port -> Board [label="Optional", style="dotted"];
Port -> HW;
}
* @enddot
@@ -119,7 +123,7 @@
* @dot
digraph example {
node [shape=rectangle, fontname=Helvetica, fontsize=8,
- fixedsize="true", width="1.0", height="0.25"];
+ fixedsize="true", width="1.1", height="0.25"];
edge [fontname=Helvetica, fontsize=8];
Semaphores -> Scheduler;
@@ -128,6 +132,7 @@
Condvars -> Mutexes;
Events -> Scheduler;
Messages -> Scheduler;
+ "Binary Semaphores" -> Semaphores;
Mailboxes -> Semaphores;
}
* @enddot
@@ -151,17 +156,25 @@
fixedsize="true", width="1.0", height="0.25"];
edge [fontname=Helvetica, fontsize=8];
+ Application [label="Application", width="2.0"];
+ RAM [label="RAM", style="filled", width="2.0"];
Core [label="Core Allocator"];
Dynamic [label="Dynamic Threads"];
Heaps [label="Dynamic Heaps"];
Pools [label="Memory Pools"];
C [label="C-runtime"];
+ Application -> Dynamic;
+ Application -> Heaps;
+ Application -> Pools;
+ Application -> C [label="(not recommended)"];
+ Application -> Core;
Dynamic -> Heaps;
Dynamic -> Pools;
Heaps -> Core;
Pools -> Core;
C -> Core;
+ Core -> RAM
}
* @enddot
* Please also see the article @ref article_manage_memory.
diff --git a/docs/src/createthread.dox b/docs/src/createthread.dox
index 8bbd74a2d..f3b8e8362 100644
--- a/docs/src/createthread.dox
+++ b/docs/src/createthread.dox
@@ -147,7 +147,7 @@ int main(int argc, char *argv[]) {
}
* @endcode
*
- * <h2>Creating a dynamic thread using the heap allocator</h2>
+ * <h2>Creating a dynamic thread using the memory pool allocator</h2>
* A pool is a collection of equally sized memory blocks, creating a thread from
* a memry pool is very similar to the previous example but the memory of
* terminated threads is returned to the memory pool rather than to a heap:
diff --git a/docs/src/memory.dox b/docs/src/memory.dox
index 1bd39b266..f41dff32f 100644
--- a/docs/src/memory.dox
+++ b/docs/src/memory.dox
@@ -126,7 +126,7 @@
* <br>
* When designing a system it is recommended to proceed as follow:
* -# Use static objects and initializers whenever possible.
- * -# Where dynamic allocation is required without have to free the allocated
+ * -# Where dynamic allocation is required without having to free the allocated
* memory then use the Core Memory Manager allocation APIs.
* -# Where dynamic allocation is required evaluate if one or more memory
* pools can be used.
diff --git a/docs/src/portguide.dox b/docs/src/portguide.dox
index 170ca75a3..087724084 100644
--- a/docs/src/portguide.dox
+++ b/docs/src/portguide.dox
@@ -78,7 +78,7 @@
* core (a common example: ARM7) of a supported microcontroller but has
* differences in the internal peripherals.<br>
* If this is your case proceed as follow:
- * -# Create a new directory under @p <tt>./os/io/platforms</tt> and
+ * -# Create a new directory under @p <tt>./os/hal/platforms</tt> and
* name it with the microcontroller name (or family name).<br>
* In case of the ARM-based microcontroller you also need to create a
* equally named directory under
@@ -87,11 +87,11 @@
* see the existing ports as example.
* -# Copy into the newly created directory the most closely related existing
* chip port or the naked template files from
- * @p <tt>./os/io/templates</tt>.
+ * @p <tt>./os/hal/templates</tt>.
* -# Work out the differences in the drivers or implement them if you started
* from the templates.
* -# Edit/create the documentation file @p <tt>platform.dox</tt>, this
- * is required if you want to regenerate this documentation including
+ * is only required if you want to regenerate this documentation including
* your work.
* .
* Usually this kind of port just requires a serial driver (and those are very
diff --git a/readme.txt b/readme.txt
index fcb3e9d38..58110bd14 100644
--- a/readme.txt
+++ b/readme.txt
@@ -74,6 +74,7 @@
option is not compatible with the 64 bits stack alignment now default in
the Cortex-Mx port. Note that the 64 bits alignment has a cost both as
performance and as space but it is the "standard".
+- Fixed various documentation errors.
*** 2.1.0 ***
- FIX: Fixed notification order in input queues (bug 3020708)(backported in