docs: misc #38532

Close #38431
Close #38521
Close #38530

Co-authored-by: tayheau <thopsore@pasteur.fr>
Co-authored-by: zeertzjq <zeertzjq@outlook.com>
Co-authored-by: Olivia Kinnear <git@superatomic.dev>

src/nvim/option.c

@@ -11,6 +11,7 @@
 //   - For a buffer string option, add code to check_buf_options().
 // - If it's a numeric option, add any necessary bounds checks to check_num_option_bounds().
 // - If it's a list of flags, add some code in do_set(), search for WW_ALL.
+// - If it depends on options values, add it to didset_string_options().
 // - Add documentation! "desc" in options.lua, and any other related places.
 // - Add an entry in runtime/scripts/optwin.lua.
 

src/nvim/ui_client.c

@@ -275,6 +275,7 @@ void ui_client_event_raw_line(GridLineEvent *g)
                (const schar_T *)grid_line_buf_char, grid_line_buf_attr);
 }
 
+/// Handles the "connect" ui-event.
 void ui_client_event_connect(Array args)
 {
   if (args.size < 1 || args.items[0].type != kObjectTypeString) {
@@ -312,11 +313,12 @@ static void channel_connect_event(void **argv)
   xfree(server_addr);
 }
 
-/// When a "restart" UI event is received, its arguments are saved here when
+/// When a "restart" ui-event is received, its arguments are saved here when
 /// waiting for the server to exit.
 static Array restart_args = ARRAY_DICT_INIT;
 static bool restart_pending = false;
 
+/// Handles the "restart" ui-event.
 void ui_client_event_restart(Array args)
 {
   // NB: don't send nvim_ui_detach to server, as it may have already exited.
@@ -328,7 +330,7 @@ void ui_client_event_restart(Array args)
   restart_pending = true;
 }
 
-/// Called when the current server has exited.
+/// Called during "restart" when the old server just exited.
 void ui_client_attach_to_restarted_server(void)
 {
   if (!restart_pending) {
@@ -362,6 +364,7 @@ cleanup:
   restart_args = (Array)ARRAY_DICT_INIT;
 }
 
+/// Handles the "error_exit" ui-event.
 void ui_client_event_error_exit(Array args)
 {
   if (args.size < 1