Improve docs

src/app.rs

@@ -1140,8 +1140,7 @@ pub enum ExternalMsg {
     CallSilently(Command),
 
     /// Call a Lua function.
-    /// The complete app state (exportable using `PrintAppStateAndQuit` or `Debug`)
-    /// will be passed to the function as argument.
+    /// A `CallLuaArg` object will be passed to the function as argument.
     /// The function can optionally return a list of messages for xplr to handle
     /// after the executing the function.
     ///

src/init.lua

@@ -1995,8 +1995,9 @@ xplr.config.modes.builtin.switch_layout = {
 xplr.config.modes.custom = {}
 
 -- Function
----- Formaters
------- Index
+---- Builtin
+------ Formaters
+-------- Format index column
 xplr.fn.builtin.fmt_general_table_row_cols_0 = function(m)
   local r = ""
   if m.is_before_focus then
@@ -2010,7 +2011,7 @@ xplr.fn.builtin.fmt_general_table_row_cols_0 = function(m)
   return r
 end
 
------- Path
+-------- Format path column
 xplr.fn.builtin.fmt_general_table_row_cols_1 = function(m)
   local r = m.tree .. m.prefix
 
@@ -2045,7 +2046,7 @@ xplr.fn.builtin.fmt_general_table_row_cols_1 = function(m)
   return r
 end
 
------- Permissions
+-------- Format permissions column
 xplr.fn.builtin.fmt_general_table_row_cols_2 = function(m)
 
   local no_color = os.getenv("NO_COLOR")
@@ -2133,7 +2134,7 @@ xplr.fn.builtin.fmt_general_table_row_cols_2 = function(m)
   return r
 end
 
------- Size
+-------- Format size column
 xplr.fn.builtin.fmt_general_table_row_cols_3 = function(m)
   if not m.is_dir then
     return m.human_size
@@ -2142,11 +2143,14 @@ xplr.fn.builtin.fmt_general_table_row_cols_3 = function(m)
   end
 end
 
------- Mime
+-------- Format mime column
 xplr.fn.builtin.fmt_general_table_row_cols_4 = function(m)
   if m.is_symlink and not m.is_broken then
     return m.symlink.mime_essence
   else
     return m.mime_essence
   end
 end
+
+---- Custom
+xplr.fn.custom = {}