From 717c1db64ebf9f736452c08480c37538852ea000 Mon Sep 17 00:00:00 2001
From: Mathieu Faverge <mathieu.faverge@inria.fr>
Date: Wed, 12 Apr 2017 13:18:59 +0200
Subject: [PATCH] Minor on documentation
---
control/descriptor.c | 29 ++++++++++++++++++-----------
1 file changed, 18 insertions(+), 11 deletions(-)
diff --git a/control/descriptor.c b/control/descriptor.c
index a071d25cd..28718f07b 100644
--- a/control/descriptor.c
+++ b/control/descriptor.c
@@ -41,7 +41,7 @@ static int nbdesc = 0;
/**
******************************************************************************
*
- * @ingroup internal_descriptor
+ * @ingroup Descriptor
*
* morse_desc_init_user - Internal function to create tiled matrix descriptor
* with generic function for data distribution and storage format.
@@ -559,11 +559,13 @@ int MORSE_Desc_Create_User(MORSE_desc_t **descptr, void *mat, MORSE_enum dtyp, i
return MORSE_SUCCESS;
}
-/** ***************************************************************************
+/**
+ *****************************************************************************
*
* @ingroup Descriptor
*
- * MORSE_Desc_Create_OOC - Create matrix descriptor for matrix which may not fit memory
+ * MORSE_Desc_Create_OOC - Create matrix descriptor for tiled matrix which may
+ * not fit memory.
*
******************************************************************************
*
@@ -652,7 +654,8 @@ int MORSE_Desc_Create_OOC(MORSE_desc_t **descptr, MORSE_enum dtyp, int mb, int n
#endif
}
-/** ***************************************************************************
+/**
+ *****************************************************************************
*
* @ingroup Descriptor
*
@@ -690,7 +693,8 @@ int MORSE_Desc_Destroy(MORSE_desc_t **desc)
return MORSE_SUCCESS;
}
-/** ***************************************************************************
+/**
+ *****************************************************************************
*
* @ingroup Descriptor
*
@@ -712,7 +716,8 @@ int MORSE_Desc_Acquire (MORSE_desc_t *desc) {
return RUNTIME_desc_acquire( desc );
}
-/** ***************************************************************************
+/**
+ *****************************************************************************
*
* @ingroup Descriptor
*
@@ -735,7 +740,8 @@ int MORSE_Desc_Release (MORSE_desc_t *desc) {
return RUNTIME_desc_release( desc );
}
-/** ***************************************************************************
+/**
+ *****************************************************************************
*
* @ingroup Descriptor
*
@@ -757,14 +763,15 @@ int MORSE_Desc_Getoncpu(MORSE_desc_t *desc) {
return RUNTIME_desc_getoncpu( desc );
}
-/** ***************************************************************************
+/**
+ *****************************************************************************
*
* @ingroup Descriptor
*
* MORSE_user_tag_size - Set the sizes for the MPI tags
- * Default value: tag_width=31, tag_sep=24, meaning that the MPI tag is stored in 31 bits,
- * with 24 bits for the tile tag and 7 for the descriptor.
- * This function must be called before any descriptor creation.
+ * Default value: tag_width=31, tag_sep=24, meaning that the MPI tag is stored
+ * in 31 bits, with 24 bits for the tile tag and 7 for the descriptor. This
+ * function must be called before any descriptor creation.
*
******************************************************************************
*
--
GitLab