[tensor] improve documentation, add todos

diff --git a/src/ai/tensor.h b/src/ai/tensor.h
index 44a14c2..a6fe03b 100644 (file)
--- a/src/ai/tensor.h
+++ b/src/ai/tensor.h
@@ -21,16 +21,22 @@
 #ifndef AUBIO_TENSOR_H
 #define AUBIO_TENSOR_H
 
-#ifdef __cplusplus
-extern "C" {
-#endif
-
 /** \file
 
   Tensor for real-valued data.
 
 */
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** Maximum number of dimensions
+
+  This is defined as a constant so that ::aubio_tensor_t allocated
+  on the stack can be manipulated.
+
+ */
 #define AUBIO_TENSOR_MAXDIM 10
 
 /** Tensor for real-valued data
@@ -38,6 +44,11 @@ extern "C" {
   This object holds a tensor of real-valued data, ::smpl_t, with up to
   AUBIO_TENSOR_MAXDIM dimentsions.
 
+  Todo:
+  - add array of strides
+  - add accessors macros
+  - consider removing data
+
 */
 typedef struct
 {