session server REFACTOR server destroy docs

Author: Roytak

src/session_server.c

@@ -3884,7 +3884,7 @@ nc_connect_ch_client_dispatch(const char *client_name, nc_server_ch_session_acqu
 
     NC_CHECK_SRV_INIT_RET(-1);
 
-    /* CONFIG READ LOCK */
+    /* CONFIG WRITE LOCK */
     if (nc_rwlock_lock(&server_opts.config_lock, NC_RWLOCK_WRITE, NC_CONFIG_LOCK_TIMEOUT, __func__) != 1) {
         return -1;
     }
@@ -3898,7 +3898,7 @@ nc_connect_ch_client_dispatch(const char *client_name, nc_server_ch_session_acqu
             new_session_cb, new_session_cb_data);
 
 cleanup:
-    /* CONFIG READ UNLOCK */
+    /* CONFIG WRITE UNLOCK */
     nc_rwlock_unlock(&server_opts.config_lock, __func__);
     return rc;
 }

src/session_server.h

@@ -142,12 +142,11 @@ struct nc_server_reply *nc_clb_default_close_session(struct lyd_node *rpc, struc
 int nc_server_init(void);
 
 /**
- * @brief Destroy any dynamically allocated libssh and/or libssl/libcrypto and
- *        server resources.
+ * @brief Destroy any dynamically allocated libssh and/or libssl/libcrypto and server resources.
  *
- * Can be called multiple times, even if a previous call failed.
- *
- * @return 0 on success, 1 on error - all resources could not be freed safely.
+ * @return 0 on success, 1 on error - failed to synchronize with other threads
+ *         (timed out waiting for locks or failed to join threads). Safe to call
+ *         again to retry freeing resources.
  */
 int nc_server_destroy(void);