From c61568a5d82a880b4b4e42437354f632d178c36d Mon Sep 17 00:00:00 2001
From: yggverse <yggverse@project>
Date: Sat, 30 Nov 2024 18:19:04 +0200
Subject: [PATCH] update comments

---
 src/client/session.rs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/client/session.rs b/src/client/session.rs
index 493688e..fe28ede 100644
--- a/src/client/session.rs
+++ b/src/client/session.rs
@@ -32,10 +32,11 @@ impl Session {
         self.index.borrow_mut().insert(request, connection)
     }
 
-    /// Update existing session for given [Uri](https://docs.gtk.org/glib/struct.Uri.html)
+    /// Update existing session match [scope](https://geminiprotocol.net/docs/protocol-specification.gmi#status-60)
+    /// for given [Uri](https://docs.gtk.org/glib/struct.Uri.html)
     /// and [TlsCertificate](https://docs.gtk.org/gio/class.TlsCertificate.html)
-    /// * force rehandshake on user certificate was changed in runtime (ignore default session resumption by Glib TLS backend implementation)
-    /// * close previous connection match `Uri` if not closed yet
+    ///
+    /// * force rehandshake on user certificate change in runtime (ignore default session resumption by Glib TLS backend)
     pub fn update(&self, uri: &Uri, certificate: Option<&TlsCertificate>) -> Result<(), Error> {
         // Get available client connections match `uri` scope
         // https://geminiprotocol.net/docs/protocol-specification.gmi#status-60
@@ -44,6 +45,7 @@ impl Session {
                 uri.to_string_partial(UriHideFlags::QUERY | UriHideFlags::FRAGMENT)
                     .as_str(),
             ) {
+                // Begin re-handshake on user certificate change
                 match connection.tls_client_connection {
                     // User certificate session
                     Some(ref tls_client_connection) => {