about summary refs log tree commit diff stats
path: root/doc/cha-api.5
diff options
context:
space:
mode:
authorbptato <nincsnevem662@gmail.com>2024-09-02 20:39:11 +0200
committerbptato <nincsnevem662@gmail.com>2024-09-02 20:46:07 +0200
commitf73926306811359c47b589bf860ddccb0a1ceb14 (patch)
tree1dd00feb7e50a085839ea6666a9451c31a677888 /doc/cha-api.5
parent410951c56ad856954874463a1ad14432cad42149 (diff)
downloadchawan-f73926306811359c47b589bf860ddccb0a1ceb14.tar.gz
doc: update manpages
Diffstat (limited to 'doc/cha-api.5')
-rw-r--r--doc/cha-api.520
1 files changed, 18 insertions, 2 deletions
diff --git a/doc/cha-api.5 b/doc/cha-api.5
index 66088fa9..45b37d61 100644
--- a/doc/cha-api.5
+++ b/doc/cha-api.5
@@ -1,5 +1,5 @@
 '\" t
-.\" Automatically generated by Pandoc 3.2
+.\" Automatically generated by Pandoc 3.3
 .\"
 .TH "cha\-api" "5" "" "" "Chawan\[cq]s command API"
 .SH Chawan\[cq]s command API
@@ -124,16 +124,32 @@ Same as \f[CR]pager.load(url + \[dq]n\[dq])\f[R].
 T}@T{
 T}
 T{
-\f[CR]gotoURL(url)\f[R]
+\f[CR]gotoURL(url, options = {replace: null, contentType: null})\f[R]
 T}@T{
 Go to the specified URL immediately (without a prompt).
 This differs from \f[CR]load\f[R] and \f[CR]loadSubmit\f[R] in that it
 \f[I]does not\f[R] try to correct the URL.
+When \f[CR]replace\f[R] is set, the new buffer may replace the old one
+if it loads successfully.
+When \f[CR]contentType\f[R] is set, the new buffer\[cq]s content type is
+forcefully set to that string.
 Use this for loading automatically retrieved (i.e.\ non\-user\-provided)
 URLs.
 T}@T{
 T}
 T{
+\f[CR]nextBuffer()\f[R], \f[CR]prevBuffer()\f[R],
+\f[CR]nextSiblingBufer()\f[R], \f[CR]prevSiblingBuffer()\f[R],
+\f[CR]parentBuffer()\f[R]
+T}@T{
+Traverse the buffer tree.
+\f[CR]nextBuffer()\f[R], \f[CR]prevBuffer()\f[R] do a depth\-first
+traversal; \[ga]\f[CR]nextSiblingBufer()\f[R],
+\f[CR]prevSiblingBuffer()\f[R] cycle through siblings, and
+\f[CR]parentBuffer()\f[R] returns to the parent.
+T}@T{
+T}
+T{
 \f[CR]dupeBuffer()\f[R]
 T}@T{
 Duplicate the current buffer by loading its source to a new buffer.