Prune AM_ASYNC_LABEL as redundant

Author: adel-mamin

docs/api.rst

@@ -341,8 +341,6 @@ The source code of the corresponding header file is in `async.h <https://github.
 
 .. doxygendefine:: AM_ASYNC_END
 
-.. doxygendefine:: AM_ASYNC_LABEL
-
 .. doxygendefine:: AM_ASYNC_AWAIT
 
 .. doxygendefine:: AM_ASYNC_YIELD

libs/async/async.h

@@ -51,7 +51,7 @@ struct am_async {
 /* clang-format off */
 
 /**
- * Mark the beginning of async function block.
+ * Mark the beginning of async function.
  *
  * Should be called at the beginning of async function.
  *
@@ -66,7 +66,7 @@ struct am_async {
     case __LINE__:
 
 /**
- * Mark the end of async function and return completion.
+ * Mark the end of async function.
  *
  * Resets the async state to the initial state
  * indicating that the async operation has completed.
@@ -78,31 +78,16 @@ struct am_async {
         return;
 
 /**
- * Mark the end of async function block and handle any unexpected states.
+ * Mark the end of async function block.
  *
- * Calls AM_ASYNC_EXIT() internally to reset the async state to
- * the initial state.
+ * Resets the async state.
  */
 #define AM_ASYNC_END()                                  \
         AM_ASYNC_EXIT();                                \
     default:                                            \
         AM_ASSERT(0);                                   \
     }}
 
-/**
- * Set label in async function.
- *
- * Stores the current line number in the `struct am_async``::state` field,
- * enabling the async function to resume from this point.
- */
-#define AM_ASYNC_LABEL()                                \
-        /* to suppress cppcheck warnings */             \
-        (void)am_async_->state;                         \
-        am_async_->state = __LINE__;                    \
-        /* FALLTHROUGH */                               \
-    case __LINE__:
-
-
 /**
  * Await a condition before proceeding.
  *

libs/async/test.c

@@ -33,12 +33,10 @@
 static void am_async_reentrant(struct am_async *me, int *reent, int *state) {
     ++(*reent);
     AM_ASYNC_BEGIN(me);
-    AM_ASYNC_LABEL();
     if (*state == 0) {
         *state = 1;
         AM_ASYNC_EXIT();
     }
-    AM_ASYNC_LABEL();
     if (*state == 1) {
         *state = 2;
         AM_ASYNC_EXIT();