From 2d7191a396cb3426facd6324cc0f2b3ee94e1d80 Mon Sep 17 00:00:00 2001 From: "Andre A. Gomes" Date: Mon, 19 Feb 2024 18:13:42 +0200 Subject: [PATCH] buffer(new-url-or-search-source): Review documentation. --- source/buffer.lisp | 17 +++-------------- 1 file changed, 3 insertions(+), 14 deletions(-) diff --git a/source/buffer.lisp b/source/buffer.lisp index 5ab1cbf0047..7ecfcd422a5 100644 --- a/source/buffer.lisp +++ b/source/buffer.lisp @@ -1523,20 +1523,9 @@ Otherwise, set `engine' to `default-search-engine'.")) (prompter:filter nil) (prompter:actions-on-return #'buffer-load*)) (:export-class-name-p t) - (:documentation "This prompter source tries to \"do the right thing\" to -generate a new URL query from user input. -- If the query is a URL, open it directly. -- If it's a file, prefix the query with 'file://'. -- If it's a search engine shortcut, include it in the suggestions. -- If it's none of the above, use the `default-search-engine'. - -It runs in two passes. The first pass does not check the DNS for domain -validity, nor does it return any search engine suggestions. This guarantees -that a good-enough default suggestion is showed instantaneously. -(We really want this prompter source to be fast!) The second pass checks the -DNS to precisely validate domains and returns the search engines suggestions, if -any.") - (:metaclass user-class)) + (:metaclass user-class) + (:documentation "Source listing URL queries from user input in a DWIM fashion. See +`new-url-query'.")) (defmethod prompter:object-attributes ((query new-url-query) (source new-url-or-search-source)) (declare (ignore source))