doc: add missing macros

doc/chapters/advanced-examples.texi

@@ -460,20 +460,10 @@ The arguments following the codelets can be of the following types:
 @item
 @code{STARPU_R}, @code{STARPU_W}, @code{STARPU_RW}, @code{STARPU_SCRATCH}, @code{STARPU_REDUX} an access mode followed by a data handle;
 @item
-@code{STARPU_VALUE} followed  by a pointer to a constant value and
-the size of the constant;
-@item
-@code{STARPU_CALLBACK} followed by a pointer to a callback function;
-@item
-@code{STARPU_CALLBACK_ARG} followed by a pointer to be given as an
-argument to the callback function;
-@item
-@code{STARPU_CALLBACK_WITH_ARG} followed by two pointers: one to a callback
-function, and the other to be given as an argument to the callback
-function; this is equivalent to using both @code{STARPU_CALLBACK} and
-@code{STARPU_CALLBACK_WITH_ARG}
-@item
-@code{STARPU_PRIORITY} followed by a integer defining a priority level.
+the specific values @code{STARPU_VALUE}, @code{STARPU_CALLBACK},
+@code{STARPU_CALLBACK_ARG}, @code{STARPU_CALLBACK_WITH_ARG},
+@code{STARPU_PRIORITY}, followed by the appropriated objects as
+defined below.
 @end itemize
 
 Parameters to be passed to the codelet implementation are defined
@@ -482,6 +472,35 @@ through the type @code{STARPU_VALUE}. The function
 implementation to retrieve them.
 @end deftypefun
 
+@defmac STARPU_VALUE
+this macro is used when calling @code{starpu_insert_task}, and must be
+followed by a pointer to a constant value and the size of the constant
+@end defmac
+
+@defmac STARPU_CALLBACK
+this macro is used when calling @code{starpu_insert_task}, and must be
+followed by a pointer to a callback function
+@end defmac
+
+@defmac STARPU_CALLBACK_ARG
+this macro is used when calling @code{starpu_insert_task}, and must be
+followed by a pointer to be given as an argument to the callback
+function
+@end defmac
+
+@defmac  STARPU_CALLBACK_WITH_ARG
+this macro is used when calling @code{starpu_insert_task}, and must be
+followed by two pointers: one to a callback function, and the other to
+be given as an argument to the callback function; this is equivalent
+to using both @code{STARPU_CALLBACK} and
+@code{STARPU_CALLBACK_WITH_ARG}
+@end defmac
+
+@defmac STARPU_PRIORITY
+this macro is used when calling @code{starpu_insert_task}, and must be
+followed by a integer defining a priority level
+@end defmac
+
 @deftypefun void starpu_codelet_pack_args ({char **}arg_buffer, {size_t *}arg_buffer_size, ...)
 Pack arguments of type @code{STARPU_VALUE} into a buffer which can be
 given to a codelet and later unpacked with the function

doc/chapters/basic-api.texi

@@ -1338,10 +1338,16 @@ submitted if it has not been properly initialized.
 Initialize @var{task} with default values. This function is implicitly
 called by @code{starpu_task_create}. By default, tasks initialized with
 @code{starpu_task_init} must be deinitialized explicitly with
-@code{starpu_task_deinit}. Tasks can also be initialized statically, using the
-constant @code{STARPU_TASK_INITIALIZER}.
+@code{starpu_task_deinit}. Tasks can also be initialized statically,
+using @code{STARPU_TASK_INITIALIZER} defined below.
 @end deftypefun
 
+@defmac STARPU_TASK_INITIALIZER
+It is possible to initialize statically allocated tasks with this
+value. This is equivalent to initializing a starpu_task structure with
+the @code{starpu_task_init} function defined above.
+@end defmac
+
 @deftypefun {struct starpu_task *} starpu_task_create (void)
 Allocate a task structure and initialize it with default values. Tasks
 allocated dynamically with @code{starpu_task_create} are automatically freed when the