ext4: add doxygen doc for ext4_journal_start and ext4_journal_stop
authorgkostka <kostka.grzegorz@gmail.com>
Tue, 29 Dec 2015 14:24:11 +0000 (15:24 +0100)
committergkostka <kostka.grzegorz@gmail.com>
Tue, 29 Dec 2015 14:24:11 +0000 (15:24 +0100)
lwext4/ext4.h

index 9679eb89cfb2ccb30d14399ae45250aa09ef7082..5d123305093f871ba48d1b78c3c71dd20a8c14d3 100644 (file)
@@ -182,8 +182,24 @@ int ext4_mount(const char *dev_name, const char *mount_point);
  * @return  standard error code */
 int ext4_umount(const char *mount_point);
 
+/**@brief   Start journaling. Journaling start/stop functions are transparent
+ *          and might be used on filesystems without journaling support.
+ * @warning Usage:
+ *              ext4_mount("sda1", "/");
+ *              ext4_journal_start("/");
+ *
+ *              //File operations here...
+ *
+ *              ext4_journal_stop("/");
+ *              ext4_umount("/");
+ * @param   mount_point mount name
+ * @return  standard error code */
 int ext4_journal_start(const char *mount_point);
 
+/**@brief   Stop journaling. Journaling start/stop functions are transparent
+ *          and might be used on filesystems without journaling support.
+ * @param   mount_point mount name
+ * @return  standard error code */
 int ext4_journal_stop(const char *mount_point);
 
 /**@brief   Journal recovery.