Changes in kernel/generic/include/arch.h [41df2827:eb239dc] in mainline

File:

• kernel/generic/include/arch.h (modified) (4 diffs)

kernel/generic/include/arch.h

@@ -27 +27 @@
  */
 
-/** @addtogroup generic 
+/** @addtogroup generic
  * @{
  */
@@ -41 +41 @@
 #include <mm/as.h>
 
-#define DEFAULT_CONTEXT         0
+#define DEFAULT_CONTEXT  0
 
-#define CPU                     THE->cpu
-#define THREAD                  THE->thread
-#define TASK                    THE->task
-#define AS                      THE->as
-#define CONTEXT         (THE->task ? THE->task->context : DEFAULT_CONTEXT)
-#define PREEMPTION_DISABLED     THE->preemption_disabled
+#define CPU                  THE->cpu
+#define THREAD               THE->thread
+#define TASK                 THE->task
+#define AS                   THE->as
+#define CONTEXT              (THE->task ? THE->task->context : DEFAULT_CONTEXT)
+#define PREEMPTION_DISABLED  THE->preemption_disabled
 
-#define context_check(ctx1, ctx2)       ((ctx1) == (ctx2))
+#define context_check(ctx1, ctx2)  ((ctx1) == (ctx2))
 
 /**
@@ -58 +58 @@
  */
 typedef struct {
-        size_t preemption_disabled;     /**< Preemption disabled counter. */
-        thread_t *thread;               /**< Current thread. */
-        task_t *task;                   /**< Current task. */
-        cpu_t *cpu;                     /**< Executing cpu. */
-        as_t *as;                       /**< Current address space. */
+        size_t preemption_disabled;  /**< Preemption disabled counter. */
+        thread_t *thread;            /**< Current thread. */
+        task_t *task;                /**< Current task. */
+        cpu_t *cpu;                  /**< Executing cpu. */
+        as_t *as;                    /**< Current address space. */
 } the_t;
 
+/*
+ * THE is not an abbreviation, but the English definite article written in
+ * capital letters. It means the current pointer to something, e.g. thread,
+ * processor or address space. Kind reader of this comment shall appreciate
+ * the wit of constructs like THE->thread and similar.
+ */
 #define THE  ((the_t * )(get_stack_base()))
 
-extern void the_initialize(the_t *the);
-extern void the_copy(the_t *src, the_t *dst);
+extern void the_initialize(the_t *);
+extern void the_copy(the_t *, the_t *);
 
 extern void arch_pre_mm_init(void);
@@ -80 +86 @@
 extern void reboot(void);
 extern void arch_reboot(void);
-extern void *arch_construct_function(fncptr_t *fptr, void *addr, void *caller);
+extern void *arch_construct_function(fncptr_t *, void *, void *);
 
 #endif