Update comments

Author: lionel-

crates/ark/src/interface.rs

@@ -803,8 +803,8 @@ impl RMain {
             // to be handled in a blocking way to ensure subscribers are
             // notified before the next incoming message is processed.
 
-            // First handle execute requests outside of `select!` to ensure they
-            // have priority. `select!` chooses at random.
+            // First handle execute requests outside of `select` to ensure they
+            // have priority. `select` chooses at random.
             if let Ok(req) = r_request_rx.try_recv() {
                 if let Some(input) = self.handle_execute_request(req, &info, buf, buflen) {
                     return input;

crates/ark/src/modules/positron/hooks.R

@@ -31,8 +31,9 @@ rebind <- function(pkg, name, value, namespace = FALSE) {
 #' Override a function within an attached package
 #'
 #' Assumes the package is attached, typically used for base packages like base or utils.
-#' - `hook` will replace the binding for unnamespaced calls.
-#' - `hook_namespace` will optionally also replace the binding for namespaced calls.
+#' - `pkg_bind()` replaces the binding in the package environment on the search
+#'   path for unnamespaced calls.
+#' - `ns_bind()` replaces the binding for namespaced calls.
 #'
 #' TODO: Will cause ark to fail to start if `option(defaultPackages = character())`
 #' or `R_DEFAULT_PACKAGES=NULL` are set! One idea is to register an `onAttach()`