docs: fileselector: improve docs for enum, events and keyword usage

src/lib/elementary/elm_fileselector.eo

@@ -26,7 +26,7 @@ class Elm.Fileselector (Elm.Layout, Elm.Interface.Fileselector,
             ]]
          }
          values {
-            visible: bool; [[true to show buttons, false to hide.]]
+            visible: bool; [[$true to show buttons, $false to hide.]]
          }
       }
    }
@@ -63,10 +63,10 @@ class Elm.Fileselector (Elm.Layout, Elm.Interface.Fileselector,
       Elm.Interface.Atspi_Widget_Action.elm_actions.get;
    }
    events {
-      done;
-      activated;
-      selected,invalid;
-      directory,open;
+      done; [[Called when OK button was pressed]]
+      activated; [[Called when the filesector was activated]]
+      selected,invalid; [[Called when fileselector was selected]]
+      directory,open; [[Called when a directory was opened]]
    }
 
 }

src/lib/elementary/elm_fileselector_button.eo

@@ -21,7 +21,7 @@ class Elm.Fileselector_Button (Elm.Button, Elm.Interface.Fileselector)
       Elm.Interface.Fileselector.mode;
    }
    events {
-      file,chosen;
+      file,chosen; [[Called when a file was chosen in the fileselector]]
    }
 
 }

src/lib/elementary/elm_fileselector_entry.eo

@@ -25,9 +25,9 @@ class Elm.Fileselector_Entry (Elm.Layout, Elm.Interface.Fileselector,
       Efl.Part.part;
    }
    events {
-      changed;
-      activated;
-      file,chosen;
+      changed; [[Called when the entry changed]]
+      activated; [[Called when the entry was activated]]
+      file,chosen; [[Called when a file was chosen in the fileselector]]
       press;
    }
 

src/lib/elementary/elm_interface_fileselector.eo

@@ -15,14 +15,15 @@ enum Elm.Fileselector.Mode
 
 enum Elm.Fileselector.Sort
 {
-   by_filename_asc = 0,
-   by_filename_desc,
-   by_type_asc,
-   by_type_desc,
-   by_size_asc,
-   by_size_desc,
-   by_modified_asc,
-   by_modified_desc,
+   [[Fileselector sorting modes]]
+   by_filename_asc = 0, [[Alphabetical sort by ascending filename, default]]
+   by_filename_desc, [[Alphabetical sorting by descending filename]]
+   by_type_asc, [[Sort by file type]]
+   by_type_desc, [[Sort by file type description]]
+   by_size_asc, [[Sort by ascending file size]]
+   by_size_desc, [[Sort by descending file size]]
+   by_modified_asc, [[Sort by ascending modified date]]
+   by_modified_desc, [[Sort by descending modified date]]
    last [[Sentinel (helper) value, not used.]]
 }