From 074e2089d909e4f7ef85df89698875ec2b8935c3 Mon Sep 17 00:00:00 2001
From: bptato <nincsnevem662@gmail.com>
Date: Wed, 28 Feb 2024 21:48:44 +0100
Subject: pager: improve URL loading procs

Split up load into loadSubmit, gotoURL: loadSubmit is a replacement for
load(s + '\n'), and gotoURL is a load that does no URL expansion.

Also, fix a bug where load("\n") would crash the browser.
---
 doc/config.md | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

(limited to 'doc/config.md')

diff --git a/doc/config.md b/doc/config.md
index e0208e16..64ed6a44 100644
--- a/doc/config.md
+++ b/doc/config.md
@@ -879,12 +879,28 @@ from the document's last line.</td>
 
 <tr>
 <td>`pager.load(url)`</td>
-<td>Go to the specified URL. Opens a prompt with the current URL when no
-parameters are specified; otherwise, the string passed is displayed in
-the prompt. If this string ends with a newline
+<td>Put the specified address into the URL bar, and optionally load it.<br>
+Note that this performs auto-expansion of URLs, so Chawan will expand any
+matching omni-rules (e.g. search), try to open schemeless URLs with the default
+scheme/local files, etc.<br>
+Opens a prompt with the current URL when no parameters are specified; otherwise,
+the string passed is displayed in the prompt. If this string ends with a newline
 (e.g. `pager.load("about:chawan\n")`), the URL is loaded directly.</td>
 </tr>
 
+<tr>
+<td>`pager.loadSubmit(url)`</td>
+<td>Act as if `url` had been input into the address bar.<br>
+Same as `pager.load(url + "\n")`.</td>
+</tr>
+
+<tr>
+<td>`pager.gotoURL(url)`</td>
+<td>Go to the specified URL immediately (without a prompt). This differs from
+`load` and `loadSubmit` in that it *does not* try to correct the URL.<br>
+Use this for loading automatically retrieved (i.e. non-user-provided) URLs.</td>
+</tr>
+
 <tr>
 <td>`pager.dupeBuffer()`</td>
 <td>Duplicate the current buffer by loading its source to a new buffer.</td>
-- 
cgit 1.4.1-2-gfad0