X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=bertos%2Fio%2Fkfile.h;h=9b0b07d016aa27c8692c98b333827a3ace61e5b6;hb=9b851504d2822d5d10b9894dd09706a39232faad;hp=c5529822ccfa704a5ce89ba8fbd594b8627a04c0;hpb=1c11ac0ab0636d07db3899b02c5d89e2d0b020bc;p=bertos.git

diff --git a/bertos/io/kfile.h b/bertos/io/kfile.h
index c5529822..9b0b07d0 100644
--- a/bertos/io/kfile.h
+++ b/bertos/io/kfile.h
@@ -31,9 +31,6 @@
  *
  * -->
  *
- * \defgroup core BeRTOS core functionality
- * \{
- *
  * \defgroup io_kfile KFile interface
  * \ingroup core
  * \{
@@ -226,6 +223,12 @@ int kfile_genericClose(struct KFile *fd);
 /**
  * Read \a size bytes from file \a fd into \a buf.
  *
+ * This function reads at most the number of requested bytes into the
+ * provided buffer.
+ * The value returned may be less than the requested bytes in case EOF is
+ * reached OR an error occurred. You need to check the error conditions
+ * using kfile_error() to understand which case happened.
+ *
  * \note This function will block if there are less than \a size bytes
  *       to read.
  *
@@ -341,7 +344,6 @@ int kfile_testSetup(void);
 int kfile_testRun(void);
 int kfile_testRunGeneric(KFile *fd, uint8_t *test_buf, uint8_t *save_buf, size_t size);
 int kfile_testTearDown(void);
-/** \} */ //defgroup core
 
 
 #endif /* KERN_KFILE_H */