docs update lv_fs.h, layer and align.png to v8

docs/overview/layer.md

@@ -40,13 +40,10 @@ lv_obj_del(label2);
 
 ## Bring to the foreground
 
-There are several ways to bring an object to the foreground:
-- Use `lv_obj_set_top(obj, true)`. If `obj` or any of its children is clicked, then LVGL will automatically bring the object to the foreground.
-It works similarly to a typical GUI on a PC. When a window in the background is clicked, it will come to the foreground automatically.
+There are 2 explicit way to bring an object to the foreground:
 - Use `lv_obj_move_foreground(obj)` to explicitly tell the library to bring an object to the foreground. Similarly, use `lv_obj_move_background(obj)` to move to the background.
 - When `lv_obj_set_parent(obj, new_parent)` is used, `obj` will be on the foreground on the `new_parent`.
 
-
 ## Top and sys layers
 
 LVGL uses two special layers named as `layer_top` and `layer_sys`.

src/misc/lv_fs.h

@@ -110,134 +110,135 @@ void _lv_fs_init(void);
  * Initialize a file system driver with default values.
  * It is used to surly have known values in the fields ant not memory junk.
  * After it you can set the fields.
- * @param drv pointer to driver variable to initialize
+ * @param drv     pointer to driver variable to initialize
  */
 void lv_fs_drv_init(lv_fs_drv_t * drv);
 
 /**
  * Add a new drive
- * @param drv_p pointer to an lv_fs_drv_t structure which is inited with the
- * corresponding function pointers.
- * Only pointer is saved, so the driver should be static or dynamically allocated.
+ * @param drv       pointer to an lv_fs_drv_t structure which is inited with the
+ *                  corresponding function pointers. Only pointer is saved, so the
+ *                  driver should be static or dynamically allocated.
  */
-void lv_fs_drv_register(lv_fs_drv_t * drv_p);
+void lv_fs_drv_register(lv_fs_drv_t * drv);
 
 /**
  * Give a pointer to a driver from its letter
- * @param letter the driver letter
- * @return pointer to a driver or NULL if not found
+ * @param letter    the driver letter
+ * @return          pointer to a driver or NULL if not found
  */
 lv_fs_drv_t * lv_fs_get_drv(char letter);
 
 /**
  * Test if a drive is ready or not. If the `ready` function was not initialized `true` will be
  * returned.
- * @param letter letter of the drive
- * @return true: drive is ready; false: drive is not ready
+ * @param letter    letter of the drive
+ * @return          true: drive is ready; false: drive is not ready
  */
 bool lv_fs_is_ready(char letter);
 
 /**
  * Open a file
- * @param file_p pointer to a lv_fs_file_t variable
- * @param path path to the file beginning with the driver letter (e.g. S:/folder/file.txt)
- * @param mode read: FS_MODE_RD, write: FS_MODE_WR, both: FS_MODE_RD | FS_MODE_WR
- * @return LV_FS_RES_OK or any error from lv_fs_res_t enum
+ * @param file_p    pointer to a lv_fs_file_t variable
+ * @param path      path to the file beginning with the driver letter (e.g. S:/folder/file.txt)
+ * @param mode      read: FS_MODE_RD, write: FS_MODE_WR, both: FS_MODE_RD | FS_MODE_WR
+ * @return          LV_FS_RES_OK or any error from lv_fs_res_t enum
  */
 lv_fs_res_t lv_fs_open(lv_fs_file_t * file_p, const char * path, lv_fs_mode_t mode);
 
 /**
  * Close an already opened file
- * @param file_p pointer to a lv_fs_file_t variable
- * @return LV_FS_RES_OK or any error from lv_fs_res_t enum
+ * @param file_p    pointer to a lv_fs_file_t variable
+ * @return          LV_FS_RES_OK or any error from lv_fs_res_t enum
  */
 lv_fs_res_t lv_fs_close(lv_fs_file_t * file_p);
 
 /**
  * Read from a file
- * @param file_p pointer to a lv_fs_file_t variable
- * @param buf pointer to a buffer where the read bytes are stored
- * @param btr Bytes To Read
- * @param br the number of real read bytes (Bytes Read). NULL if unused.
- * @return LV_FS_RES_OK or any error from lv_fs_res_t enum
+ * @param file_p    pointer to a lv_fs_file_t variable
+ * @param buf       pointer to a buffer where the read bytes are stored
+ * @param btr       Bytes To Read
+ * @param br        the number of real read bytes (Bytes Read). NULL if unused.
+ * @return          LV_FS_RES_OK or any error from lv_fs_res_t enum
  */
 lv_fs_res_t lv_fs_read(lv_fs_file_t * file_p, void * buf, uint32_t btr, uint32_t * br);
 
 /**
  * Write into a file
- * @param file_p pointer to a lv_fs_file_t variable
- * @param buf pointer to a buffer with the bytes to write
- * @param btr Bytes To Write
- * @param br the number of real written bytes (Bytes Written). NULL if unused.
- * @return LV_FS_RES_OK or any error from lv_fs_res_t enum
+ * @param file_p    pointer to a lv_fs_file_t variable
+ * @param buf       pointer to a buffer with the bytes to write
+ * @param btr       Bytes To Write
+ * @param br        the number of real written bytes (Bytes Written). NULL if unused.
+ * @return          LV_FS_RES_OK or any error from lv_fs_res_t enum
  */
 lv_fs_res_t lv_fs_write(lv_fs_file_t * file_p, const void * buf, uint32_t btw, uint32_t * bw);
 
 /**
  * Set the position of the 'cursor' (read write pointer) in a file
- * @param file_p pointer to a lv_fs_file_t variable
- * @param pos the new position expressed in bytes index (0: start of file)
- * @return LV_FS_RES_OK or any error from lv_fs_res_t enum
+ * @param file_p    pointer to a lv_fs_file_t variable
+ * @param pos       the new position expressed in bytes index (0: start of file)
+ * @param whence    tells from where set the position. See @lv_fs_whence_t
+ * @return          LV_FS_RES_OK or any error from lv_fs_res_t enum
  */
 lv_fs_res_t lv_fs_seek(lv_fs_file_t * file_p, uint32_t pos, lv_fs_whence_t whence);
 
 /**
  * Give the position of the read write pointer
- * @param file_p pointer to a lv_fs_file_t variable
- * @param pos_p pointer to store the position of the read write pointer
- * @return LV_FS_RES_OK or any error from 'fs_res_t'
+ * @param file_p    pointer to a lv_fs_file_t variable
+ * @param pos_p     pointer to store the position of the read write pointer
+ * @return          LV_FS_RES_OK or any error from 'fs_res_t'
  */
 lv_fs_res_t lv_fs_tell(lv_fs_file_t * file_p, uint32_t * pos);
 
 /**
  * Initialize a 'fs_dir_t' variable for directory reading
- * @param rddir_p pointer to a 'lv_fs_dir_t' variable
- * @param path path to a directory
- * @return LV_FS_RES_OK or any error from lv_fs_res_t enum
+ * @param rddir_p   pointer to a 'lv_fs_dir_t' variable
+ * @param path      path to a directory
+ * @return          LV_FS_RES_OK or any error from lv_fs_res_t enum
  */
 lv_fs_res_t lv_fs_dir_open(lv_fs_dir_t * rddir_p, const char * path);
 
 /**
  * Read the next filename form a directory.
  * The name of the directories will begin with '/'
- * @param rddir_p pointer to an initialized 'fs_dir_t' variable
- * @param fn pointer to a buffer to store the filename
- * @return LV_FS_RES_OK or any error from lv_fs_res_t enum
+ * @param rddir_p   pointer to an initialized 'fs_dir_t' variable
+ * @param fn        pointer to a buffer to store the filename
+ * @return          LV_FS_RES_OK or any error from lv_fs_res_t enum
  */
 lv_fs_res_t lv_fs_dir_read(lv_fs_dir_t * rddir_p, char * fn);
 
 /**
  * Close the directory reading
- * @param rddir_p pointer to an initialized 'fs_dir_t' variable
- * @return LV_FS_RES_OK or any error from lv_fs_res_t enum
+ * @param rddir_p   pointer to an initialized 'fs_dir_t' variable
+ * @return          LV_FS_RES_OK or any error from lv_fs_res_t enum
  */
 lv_fs_res_t lv_fs_dir_close(lv_fs_dir_t * rddir_p);
 
 /**
  * Fill a buffer with the letters of existing drivers
- * @param buf buffer to store the letters ('\0' added after the last letter)
- * @return the buffer
+ * @param buf       buffer to store the letters ('\0' added after the last letter)
+ * @return          the buffer
  */
 char * lv_fs_get_letters(char * buf);
 
 /**
  * Return with the extension of the filename
- * @param fn string with a filename
- * @return pointer to the beginning extension or empty string if no extension
+ * @param fn        string with a filename
+ * @return          pointer to the beginning extension or empty string if no extension
  */
 const char * lv_fs_get_ext(const char * fn);
 
 /**
  * Step up one level
- * @param path pointer to a file name
- * @return the truncated file name
+ * @param path      pointer to a file name
+ * @return          the truncated file name
  */
 char * lv_fs_up(char * path);
 
 /**
  * Get the last element of a path (e.g. U:/folder/file -> file)
- * @param path pointer to a file name
- * @return pointer to the beginning of the last element in the path
+ * @param path      pointer to a file name
+ * @return          pointer to the beginning of the last element in the path
  */
 const char * lv_fs_get_last(const char * path);