git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@714 35acf78f-673a-0410-8e92-d51de3d6d3f4

docs/ch.txt

@@ -234,8 +234,13 @@
  *   becomes negative the thread is queued in the semaphore and suspended.
  * - <b>Reset</b>: The semaphore counter is reset to a non-negative value
  *   and all the threads in the queue are released.
- * Semaphores can be used as guards for mutual exclusion code zones but
+ *
- * also have other uses, queues guards and counters as example.<br>
+ * Semaphores can be used as guards for mutual exclusion code zones (note that
+ * mutexes are recommended for this kind of use) but also have other uses,
+ * queues guards and counters as example.<br>
+ * Semaphores usually use FIFO queues but it is possible to make them
+ * order threads by priority by specifying CH_USE_SEMAPHORES_PRIORITY in
+ * @p chconf.h.<br>
  * In order to use the Semaphores APIs the @p CH_USE_SEMAPHORES
  * option must be specified in @p chconf.h.<br><br>
  * @file semaphores.h Semaphores macros and structures.
@@ -256,6 +261,7 @@
  * - <b>Unlock</b>: The mutex is released by the owner and the highest
  *   priority thread waiting in the queue, if any, is resumed and made owner
  *   of the mutex.
+ *
  * In order to use the Event APIs the @p CH_USE_MUTEXES option must be
  * specified in @p chconf.h.<br>
  *
@@ -320,7 +326,7 @@
 /**
  * @defgroup Messages Messages
  * @{
- * Synchronous inter-thread Messages.
+ * Synchronous inter-thread messages.
  * <h2>Operation Mode</h2>
  * Messages are an easy to use and fast IPC mechanism, threads can both serve
  * messages and send messages to other threads, the mechanism allows data to
@@ -360,6 +366,7 @@
  * - <b>Full duplex queue</b>, bidirectional queue where read and write
  *   operations can happen at the same time. Full duplex queues
  *   are implemented by pairing an input queue and an output queue together.
+ *
  * In order to use the I/O queues the @p CH_USE_QUEUES option must
  * be specified in @p chconf.h.<br>
  * In order to use the half duplex queues the @p CH_USE_QUEUES_HALFDUPLEX
@@ -397,7 +404,7 @@
  * The library code does not follow the same naming convention of the
  * system APIs in order to make very clear that it is not "core" code.<br>
  * The main difference is that library code is not formally  tested in the
- * test suite but through usage in the various demo application.
+ * test suite but through usage in the various demo applications.
  */
 /** @} */
 

readme.txt

@@ -101,6 +101,8 @@ Win32-MinGW            - ChibiOS/RT simulator and demo into a WIN32 process,
   CH_IRQ_PROLOGUE() and CH_IRQ_EPILOGUE() in order to make very clear that
   those are not functions but inlined code. Also introduced a new macro
   CH_IRQ_HANDLER that should be used when declaring an interrupt handler.
+  CHANGE: Renamed several internal initialization functions by removing the
+  "ch" prefix because could not be considered system APIs. 
 - Improved ARM7 and Cortex-M3 support, new configuration options.
 - Introduced the concept of interrupt classes, see the documentation.
 - Introduced the concept of system states, see the documentation.

src/chdebug.c

@@ -26,7 +26,7 @@ char *panicmsg;
 /**
  * @brief Debug subsystem initialization.
  */
-void chDbgInit(void) {
+void debug_init(void) {
 
 #ifdef CH_USE_TRACE
   dbgtb.tb_size = TRACE_BUFFER_SIZE;

src/chheap.c

@@ -65,10 +65,9 @@ static struct {
 /**
  * @brief Initializes the allocator subsystem.
  *
- * @note It is internally invoked, this function should not normally be
+ * @note Internal use only.
- *       invoked from the user code.
  */
-void chHeapInit(void) {
+void heap_init(void) {
   struct header *hp;
 
 #if CH_HEAP_SIZE == 0

src/chschd.c

@@ -32,7 +32,7 @@ ReadyList rlist;
  * @brief Scheduler initialization.
  * @note Internally invoked by the @p chSysInit().
  */
-void chSchInit(void) {
+void scheduler_init(void) {
 
   queue_init(&rlist);
   rlist.r_prio = NOPRIO;

src/chsys.c

@@ -57,17 +57,17 @@ void chSysInit(void) {
   static Thread mainthread;
 
   port_init();
-  chSchInit();
+  scheduler_init();
-  chDbgInit();
+  debug_init();
-  chVTInit();
+  vt_init();
 #ifdef CH_USE_HEAP
-  chHeapInit();
+  heap_init();
 #endif
+
   /*
    * Now this instructions flow becomes the main thread.
    */
   (currp = init_thread(&mainthread, NORMALPRIO))->p_state = PRCURR;
-
   chSysEnable();
 
   /*

src/chvt.c

@@ -31,7 +31,7 @@ VTList vtlist;
  *
  * @note Internal use only.
  */
-void chVTInit(void) {
+void vt_init(void) {
 
   vtlist.vt_next = vtlist.vt_prev = (void *)&vtlist;
   vtlist.vt_time = (systime_t)-1;

src/include/debug.h

@@ -62,7 +62,7 @@ extern char *dbglastmsg;
 #ifdef __cplusplus
 extern "C" {
 #endif
-  void chDbgInit(void);
+  void debug_init(void);
   void chDbgPanic(char *msg);
 #ifdef __cplusplus
 }
@@ -83,7 +83,7 @@ extern "C" {
 
 #else /* !CH_USE_DEBUG */
 
-#define chDbgInit()
+#define debug_init()
 #define chDbgPanic(msg) {}
 #define chDbgAssert(c, m) {(void)(c);}
 

src/include/heap.h

@@ -28,7 +28,7 @@
 #ifdef __cplusplus
 extern "C" {
 #endif
-  void chHeapInit(void);
+  void heap_init(void);
   void *chHeapAlloc(size_t size);
   void chHeapFree(void *p);
   size_t chHeapStatus(size_t *sizep);

src/include/scheduler.h

@@ -75,7 +75,7 @@ extern ReadyList rlist;
 #ifdef __cplusplus
 extern "C" {
 #endif
-  void chSchInit(void);
+  void scheduler_init(void);
   Thread *chSchReadyI(Thread *tp);
   void chSchGoSleepS(tstate_t newstate);
   msg_t chSchGoSleepTimeoutS(tstate_t newstate, systime_t time);

src/include/vt.h

@@ -99,7 +99,7 @@ extern VTList vtlist;
 #ifdef __cplusplus
 extern "C" {
 #endif
-  void chVTInit(void);
+  void vt_init(void);
   void chVTSetI(VirtualTimer *vtp, systime_t time, vtfunc_t vtfunc, void *par);
   void chVTResetI(VirtualTimer *vtp);
   bool_t chSysInTimeWindow(systime_t start, systime_t end);