fs: update fs_close() description
authorHeinrich Schuchardt <xypron.glpk@gmx.de>
Sun, 13 Oct 2019 08:26:26 +0000 (10:26 +0200)
committerHeinrich Schuchardt <xypron.glpk@gmx.de>
Thu, 17 Oct 2019 17:19:55 +0000 (19:19 +0200)
Provide a more detailed description of fs_close().

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
include/fs.h

index 5a1244d57fd2328e2e00e7f6f58b981b7e0253f4..247e9540536ca67b416ef831be6bf36f53da4c4b 100644 (file)
@@ -40,7 +40,12 @@ int fs_set_blk_dev_with_part(struct blk_desc *desc, int part);
 /**
  * fs_close() - Unset current block device and partition
  *
- * Should be paired with either fs_set_blk_dev() or fs_set_dev_with_part()
+ * fs_close() closes the connection to a file system opened with either
+ * fs_set_blk_dev() or fs_set_dev_with_part().
+ *
+ * Many file functions implicitly call fs_close(), e.g. fs_closedir(),
+ * fs_exist(), fs_ln(), fs_ls(), fs_mkdir(), fs_read(), fs_size(), fs_write(),
+ * fs_unlink().
  */
 void fs_close(void);