aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorgdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>2009-02-02 21:07:27 +0000
committergdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>2009-02-02 21:07:27 +0000
commit528e9fea357b8b24069d99657230ba28968f5d0c (patch)
treefc423eb4662f925f37d705323d5e67cc0c342cd0 /docs
parentec4178dd0ff7587b79a8c525aa88d467642ce629 (diff)
downloadChibiOS-528e9fea357b8b24069d99657230ba28968f5d0c.tar.gz
ChibiOS-528e9fea357b8b24069d99657230ba28968f5d0c.tar.bz2
ChibiOS-528e9fea357b8b24069d99657230ba28968f5d0c.zip
git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@713 35acf78f-673a-0410-8e92-d51de3d6d3f4
Diffstat (limited to 'docs')
-rw-r--r--docs/src/atomic.dox8
-rw-r--r--docs/src/concepts.dox16
-rw-r--r--docs/src/interrupts.dox4
-rw-r--r--docs/src/licfaq.dox4
-rw-r--r--docs/src/timing.dox2
5 files changed, 19 insertions, 15 deletions
diff --git a/docs/src/atomic.dox b/docs/src/atomic.dox
index 64084ff30..5fb0bc628 100644
--- a/docs/src/atomic.dox
+++ b/docs/src/atomic.dox
@@ -51,9 +51,9 @@
chSysUnlock();
* @endcode
- * In general multiple I-Class and (non rescheduling) S-Class APIs can be
- * included and the block is terminated by a rescheduling S-Class API.
- * An extra @p chSchRescheduleS() can be present at the very end of the block,
- * it only reschedules if a reschedulation is still required.
+ * In general multiple @ref I-Class and (non rescheduling) @ref S-Class APIs
+ * can be included and the block is terminated by a rescheduling @ref S-Class
+ * API. An extra @p chSchRescheduleS() can be present at the very end of the
+ * block, it only reschedules if a reschedulation is still required.
*/
/** @} */
diff --git a/docs/src/concepts.dox b/docs/src/concepts.dox
index 531340560..9c0a1d9c2 100644
--- a/docs/src/concepts.dox
+++ b/docs/src/concepts.dox
@@ -33,10 +33,10 @@
* - <b>None</b>, APIs without any suffix can be invoked only from the user
* code in the <b>Normal</b> state unless differently specified. See
* @ref system_states.
- * - <b>"I"</b>, I-Class APIs are invokable only from the <b>I-Locked</b> or
- * <b>S-Locked</b> states. See @ref system_states.
- * - <b>"S"</b>, S-Class APIs are invokable only from the <b>S-Locked</b>
- * state. See @ref system_states.
+ * - @anchor I-Class <b>"I"</b>, I-Class APIs are invokable only from the
+ * <b>I-Locked</b> or <b>S-Locked</b> states. See @ref system_states.
+ * - @anchor S-Class <b>"S"</b>, S-Class APIs are invokable only from the
+ * <b>S-Locked</b> state. See @ref system_states.
* Examples: @p chThdCreateStatic(), @p chSemSignalI(), @p chIQGetTimeout().
*
* @section interrupt_classes Interrupt Classes
@@ -83,14 +83,14 @@
* goes in this state and waits for interrupts, after servicing the interrupt
* the Normal state is restored and the scheduler has a chance to reschedule.
* - <b>S-Locked</b>. Kernel locked and regular interrupt sources disabled.
- * Fast interrupt sources are enabled. S-Class and I-Class APIs are
+ * Fast interrupt sources are enabled. @ref S-Class and @ref I-Class APIs are
* invokable in this state.
* - <b>I-Locked</b>. Kernel locked and regular interrupt sources disabled.
- * I-Class APIs are invokable from this state.
+ * @ref I-Class APIs are invokable from this state.
* - <b>Serving Regular Interrupt</b>. No system APIs are accessible but it is
* possible to switch to the I-Locked state using @p chSysLockFromIsr() and
- * then invoke any I-Class API. Interrupt handlers can be preemptable on some
- * architectures thus is important to switch to I-Locked state before
+ * then invoke any @ref I-Class API. Interrupt handlers can be preemptable on
+ * some architectures thus is important to switch to I-Locked state before
* invoking system APIs.
* - <b>Serving Fast Interrupt</b>. System APIs are not accessible.
* - <b>Serving Non-Maskable Interrupt</b>. System APIs are not accessible.
diff --git a/docs/src/interrupts.dox b/docs/src/interrupts.dox
index fe74d90e9..1b3932078 100644
--- a/docs/src/interrupts.dox
+++ b/docs/src/interrupts.dox
@@ -39,8 +39,8 @@ CH_IRQ_HANDLER(myIRQ) {
CH_IRQ_EPILOGUE();
}
* @endcode
- * Note that only interrupt handlers that have to invoke system I-Class APIs
- * must be written in this form, handlers unrelated to the OS activity can
+ * Note that only interrupt handlers that have to invoke system @ref I-Class
+ * APIs must be written in this form, handlers unrelated to the OS activity can
* omit the macros.
* Another note about the handler name "myIRQ", in some ports it must be a
* vector number rather than a function name, it could also be a name from
diff --git a/docs/src/licfaq.dox b/docs/src/licfaq.dox
index a666a6aa0..afe0fa687 100644
--- a/docs/src/licfaq.dox
+++ b/docs/src/licfaq.dox
@@ -36,6 +36,10 @@
* application without have to release your source code under certains
* conditions. See the exception text under "Approved Interfaces" for
* details.
+ * - <b>Is the exception applicable to any ChibiOS/RT version ?</b><br>
+ * The exception is valid only for ChibiOS/RT releases marked as @e stable.
+ * Beta or unstable versions are covered by the GPL3 alone because are meant
+ * for testing only.
* - <b>I don't want to be bound by any of the above restriction, is this
* possible?</b><br>
* You may contact us about a commercial license.
diff --git a/docs/src/timing.dox b/docs/src/timing.dox
index c1a33ae19..9fd19545d 100644
--- a/docs/src/timing.dox
+++ b/docs/src/timing.dox
@@ -36,7 +36,7 @@ msg_t my_thread(void *param) {
* well below the system tick period and that @p my_thread() is not preempted
* by other threads inserting long intervals.<br>
* If the above conditions are not satisfied you may have @p do_something()
- * executed at irregular intevals, as example:<br><br>
+ * executed at irregular intervals, as example:<br><br>
* T0...T0+1000...T0+2002...T0+3002...T0+4005...etc.<br><br>
* Also note that the error increases over time and this kind of behavior can
* lead anomalies really hard to debug.