From 0c20cab2b307199731e5c569a05d5adfe4dc6381 Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Mon, 24 Jan 2011 12:31:38 +0000 Subject: [PATCH] docu --- src/include/gnunet_fs_service.h | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/src/include/gnunet_fs_service.h b/src/include/gnunet_fs_service.h index 68c250e97..52cd8bd78 100644 --- a/src/include/gnunet_fs_service.h +++ b/src/include/gnunet_fs_service.h @@ -871,9 +871,7 @@ struct GNUNET_FS_ProgressInfo /** * Depth of the given block in the tree; - * 0 would be the highest level (the first - * call is guaranteed to be for the lowest - * level). + * 0 would be the lowest level (DBLOCKs). */ unsigned int depth; @@ -1015,7 +1013,10 @@ struct GNUNET_FS_ProgressInfo struct { /** - * Data block we just obtained. + * Data block we just obtained, can be NULL (even if + * data_len > 0) if we found the entire block 'intact' on + * disk. In this case, it is also possible for 'data_len' + * to be larger than an individual (32k) block. */ const void *data; @@ -1031,9 +1032,7 @@ struct GNUNET_FS_ProgressInfo /** * Depth of the given block in the tree; - * 0 would be the highest level (the first - * call is guaranteed to be for the lowest - * level). + * 0 would be the lowest level (DBLOCKS). */ unsigned int depth; @@ -1454,9 +1453,7 @@ struct GNUNET_FS_ProgressInfo /** * Depth of the given block in the tree; - * 0 would be the highest level (the first - * call is guaranteed to be for the lowest - * level). + * 0 would be the lowest level (DBLOCKS). */ unsigned int depth; -- 2.25.1