Changeset a6e55886 in mainline for kernel/generic/include/arch.h

Timestamp:

2018-11-01T14:30:03Z (5 years ago)

Author:

GitHub <noreply@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

d1da1ff2

Parents:

bab75df6

git-author:

Jiří Zárevúcky <zarevucky.jiri@…> (2018-11-01 14:30:03)

git-committer:

GitHub <noreply@…> (2018-11-01 14:30:03)

Message:

Rename THE/the_t to CURRENT/current_t (#50)

Because the word "THE" occurs several times in every license
header, searching for occurrences of "THE" macro is more difficult
than necessary.

While I appreciate the wit of it, using a non-conflicting word
for it is more practical.

File:

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

kernel/generic/include/arch.h

@@ -40 +40 @@
 
 /*
- * 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.
+ * The current_t structure holds pointers to various parts of the current
+ * execution state, like running task, thread, address space, etc.
  */
-#define THE  ((the_t * )(get_stack_base()))
+#define CURRENT  ((current_t * )(get_stack_base()))
 
 #define MAGIC                UINT32_C(0xfacefeed)
@@ -53 +51 @@
 #define DEFAULT_CONTAINER  0
 #define CONTAINER \
-        ((THE->task) ? (THE->task->container) : (DEFAULT_CONTAINER))
+        ((CURRENT->task) ? (CURRENT->task->container) : (DEFAULT_CONTAINER))
 
 /* Fwd decl. to avoid include hell. */
@@ -76 +74 @@
         struct as *as;         /**< Current address space. */
         uint32_t magic;        /**< Magic value */
-} the_t;
+} current_t;
 
 typedef struct {
@@ -96 +94 @@
 #define ARCH_OP(op)     ARCH_STRUCT_OP(arch_ops, op)
 
-extern void the_initialize(the_t *);
-extern void the_copy(the_t *, the_t *);
+extern void current_initialize(current_t *);
+extern void current_copy(current_t *, current_t *);
 
 extern void calibrate_delay_loop(void);