X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=bertos%2Fio%2Fkfile_block.h;h=70fd681e7e30a5a5c64dfbccad76ba55c685972c;hb=983f074406bedb68909bf0439942e3b5dddc5579;hp=9694ea94c5c97cf4b1b527f66427acca65156068;hpb=0142058531b1f00b0dbe740b43900dfc361656e5;p=bertos.git

diff --git a/bertos/io/kfile_block.h b/bertos/io/kfile_block.h
index 9694ea94..70fd681e 100644
--- a/bertos/io/kfile_block.h
+++ b/bertos/io/kfile_block.h
@@ -32,6 +32,15 @@
  *
  * \brief KFile interface over a KBlock.
  *
+ * With this module, you can access a KBlock device
+ * with the handy KFile interface.
+ * In order to achieve this, the block device must support partial block write.
+ *
+ * \author Francesco Sacchi <batt@develer.com>
+ * \author Daniele Basile <asterix@develer.com>
+ *
+ * $WIZ$ module_name = "kfile_block"
+ * $WIZ$ module_depends = "kfile", "kblock"
  */
 
 #ifndef IO_KFILE_BLOCK_H
@@ -41,12 +50,25 @@
 #include <io/kblock.h>
 #include <io/kfile.h>
 
+/**
+ * KFileBlock context.
+ */
 typedef struct KFileBlock
 {
-	KFile fd;
-	KBlock *b;
+	KFile fd;    ///< KFile context
+	KBlock *blk; ///< KBlock device
 } KFileBlock;
 
-void kfileblock_init(KFileBlock *fb, KBlock *b);
+/**
+ * Init a KFile over KBlock.
+ * After this you can access your KBlock device with a handy KFile interface.
+ *
+ * \note The block device must support partial block write in order to support
+ *       random write access.
+ *
+ * \param fb KFileBlock context.
+ * \param blk block device to be accessed with a KFile interface.
+ */
+void kfileblock_init(KFileBlock *fb, KBlock *blk);
 
 #endif /* IO_KFILE_KBLOCK_H */