Blame


1 cc9bf8f2 2021-11-05 op <!DOCTYPE html>
2 cc9bf8f2 2021-11-05 op <html>
3 cc9bf8f2 2021-11-05 op <!-- This is an automatically generated file. Do not edit.
4 cc9bf8f2 2021-11-05 op Copyright (c) 2021 Omar Polo <op@omarpolo.com>
5 cc9bf8f2 2021-11-05 op
6 cc9bf8f2 2021-11-05 op Permission to use, copy, modify, and distribute this software for any
7 cc9bf8f2 2021-11-05 op purpose with or without fee is hereby granted, provided that the above
8 cc9bf8f2 2021-11-05 op copyright notice and this permission notice appear in all copies.
9 cc9bf8f2 2021-11-05 op
10 cc9bf8f2 2021-11-05 op THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 cc9bf8f2 2021-11-05 op WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 cc9bf8f2 2021-11-05 op MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 cc9bf8f2 2021-11-05 op ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 cc9bf8f2 2021-11-05 op WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 cc9bf8f2 2021-11-05 op ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 cc9bf8f2 2021-11-05 op OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 cc9bf8f2 2021-11-05 op -->
18 cc9bf8f2 2021-11-05 op <head>
19 cc9bf8f2 2021-11-05 op <meta charset="utf-8"/>
20 cc9bf8f2 2021-11-05 op <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
21 cc9bf8f2 2021-11-05 op <style>
22 bfd29c14 2021-12-01 op body {
23 bfd29c14 2021-12-01 op max-width: 960px;
24 bfd29c14 2021-12-01 op margin: 0 auto;
25 bfd29c14 2021-12-01 op padding: 0 10px;
26 bfd29c14 2021-12-01 op font-size: 1rem;
27 bfd29c14 2021-12-01 op }
28 bfd29c14 2021-12-01 op
29 bfd29c14 2021-12-01 op pre {
30 bfd29c14 2021-12-01 op overflow: auto;
31 bfd29c14 2021-12-01 op }
32 bfd29c14 2021-12-01 op table.head, table.foot { width: 100%; }
33 bfd29c14 2021-12-01 op td.head-rtitle, td.foot-os { text-align: right; }
34 bfd29c14 2021-12-01 op td.head-vol { text-align: center; }
35 bfd29c14 2021-12-01 op .Nd, .Bf, .Op { display: inline; }
36 bfd29c14 2021-12-01 op .Pa, .Ad { font-style: italic; }
37 bfd29c14 2021-12-01 op .Ms { font-weight: bold; }
38 bfd29c14 2021-12-01 op .Bl-diag > dt { font-weight: bold; }
39 bfd29c14 2021-12-01 op code.Nm, .Fl, .Cm, .Ic, code.In, .Fd, .Fn, .Cd { font-weight: bold;
40 bfd29c14 2021-12-01 op font-family: inherit; }
41 cc9bf8f2 2021-11-05 op </style>
42 cc9bf8f2 2021-11-05 op <title>TELESCOPE(1)</title>
43 cc9bf8f2 2021-11-05 op </head>
44 cc9bf8f2 2021-11-05 op <body>
45 cc9bf8f2 2021-11-05 op <table class="head">
46 cc9bf8f2 2021-11-05 op <tr>
47 cc9bf8f2 2021-11-05 op <td class="head-ltitle">TELESCOPE(1)</td>
48 cc9bf8f2 2021-11-05 op <td class="head-vol">General Commands Manual</td>
49 cc9bf8f2 2021-11-05 op <td class="head-rtitle">TELESCOPE(1)</td>
50 cc9bf8f2 2021-11-05 op </tr>
51 cc9bf8f2 2021-11-05 op </table>
52 cc9bf8f2 2021-11-05 op <div class="manual-text">
53 cc9bf8f2 2021-11-05 op <section class="Sh">
54 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
55 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> &#x2014;
56 cc9bf8f2 2021-11-05 op <span class="Nd">multi-protocol browser</span></p>
57 cc9bf8f2 2021-11-05 op </section>
58 cc9bf8f2 2021-11-05 op <section class="Sh">
59 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
60 cc9bf8f2 2021-11-05 op <table class="Nm">
61 cc9bf8f2 2021-11-05 op <tr>
62 cc9bf8f2 2021-11-05 op <td><code class="Nm">telescope</code></td>
63 bfd29c14 2021-12-01 op <td>[<code class="Fl">-ChnSv</code>]
64 ca5a29bf 2021-12-30 op [<code class="Fl">-c</code>&#x00A0;<var class="Ar">config</var>]
65 cc9bf8f2 2021-11-05 op [<var class="Ar">URL</var>]</td>
66 cc9bf8f2 2021-11-05 op </tr>
67 cc9bf8f2 2021-11-05 op </table>
68 cc9bf8f2 2021-11-05 op </section>
69 cc9bf8f2 2021-11-05 op <section class="Sh">
70 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
71 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> is an interactive browser that
72 cc9bf8f2 2021-11-05 op supports the Finger, Gemini and Gopher protocols.
73 cc9bf8f2 2021-11-05 op <code class="Nm">telescope</code> features tabs, a minibuffer, interactive
74 cc9bf8f2 2021-11-05 op completions, bookmarks and out-of-band TOFU verification.</p>
75 cc9bf8f2 2021-11-05 op <p class="Pp">The arguments are as follows:</p>
76 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
77 cc9bf8f2 2021-11-05 op <dt id="C"><a class="permalink" href="#C"><code class="Fl">-C</code></a>,
78 cc9bf8f2 2021-11-05 op <code class="Fl">--colors</code></dt>
79 cc9bf8f2 2021-11-05 op <dd>Show all available colors and exit.</dd>
80 cc9bf8f2 2021-11-05 op <dt id="c"><a class="permalink" href="#c"><code class="Fl">-c</code></a>
81 ca5a29bf 2021-12-30 op <var class="Ar">config</var></dt>
82 cc9bf8f2 2021-11-05 op <dd>Specify an alternative configuration file. By default
83 ca5a29bf 2021-12-30 op <span class="Pa">~/.config/telescope/config</span> is loaded.</dd>
84 cc9bf8f2 2021-11-05 op <dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a>,
85 cc9bf8f2 2021-11-05 op <code class="Fl">--help</code></dt>
86 cc9bf8f2 2021-11-05 op <dd>Display version and usage.</dd>
87 cc9bf8f2 2021-11-05 op <dt id="n"><a class="permalink" href="#n"><code class="Fl">-n</code></a></dt>
88 cc9bf8f2 2021-11-05 op <dd>Configtest mode. Only check the configuration file for validity.</dd>
89 bfd29c14 2021-12-01 op <dt id="S"><a class="permalink" href="#S"><code class="Fl">-S</code></a>,
90 bfd29c14 2021-12-01 op <code class="Fl">--safe</code></dt>
91 bfd29c14 2021-12-01 op <dd>&#x201C;Safe&#x201D; (or &#x201C;sandbox&#x201D;) mode. Prevent
92 bfd29c14 2021-12-01 op <code class="Nm">telescope</code> from writing files to the disk and to
93 bfd29c14 2021-12-01 op acquire the lock, allowing to run multiple instances at the same time.
94 bfd29c14 2021-12-01 op <code class="Nm">telescope</code> still loads the session file and the
95 bfd29c14 2021-12-01 op custom about pages.</dd>
96 cc9bf8f2 2021-11-05 op <dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a>,
97 cc9bf8f2 2021-11-05 op <code class="Fl">--version</code></dt>
98 cc9bf8f2 2021-11-05 op <dd>Display version.</dd>
99 cc9bf8f2 2021-11-05 op </dl>
100 cc9bf8f2 2021-11-05 op </section>
101 cc9bf8f2 2021-11-05 op <section class="Sh">
102 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="UI_CONCEPTS"><a class="permalink" href="#UI_CONCEPTS">UI
103 cc9bf8f2 2021-11-05 op CONCEPTS</a></h1>
104 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> interface is divided into four
105 cc9bf8f2 2021-11-05 op areas: the tabline, the body, the modeline and the echoarea/minibuffer.</p>
106 cc9bf8f2 2021-11-05 op <p class="Pp">The tabline is always at the top of the screen and displays the
107 cc9bf8f2 2021-11-05 op tabs separated by a vertical line. When there are more tabs than the size of
108 cc9bf8f2 2021-11-05 op the window allow to display, the characters &#x2018;&lt;&#x2019; or
109 cc9bf8f2 2021-11-05 op &#x2018;&gt;&#x2019; are shown at the start/end of the tabline to indicate
110 cc9bf8f2 2021-11-05 op that there are more tabs in that direction.</p>
111 cc9bf8f2 2021-11-05 op <p class="Pp">The body occupies the majority of the visible area. It contains
112 cc9bf8f2 2021-11-05 op the current page and optionally a side window.</p>
113 cc9bf8f2 2021-11-05 op <p class="Pp">The modeline is the second to last row of the screen. It shows
114 cc9bf8f2 2021-11-05 op some information about the page: a spinner when the page is loading, the
115 cc9bf8f2 2021-11-05 op trust level, the document type, the scroll offset and the URL.</p>
116 cc9bf8f2 2021-11-05 op <p class="Pp">The echoarea is usually the last line of the screen. Messages are
117 cc9bf8f2 2021-11-05 op often showed there, and link addresses too. The echoarea is also used to
118 cc9bf8f2 2021-11-05 op obtain input from the user. When commands like
119 cc9bf8f2 2021-11-05 op <code class="Ic">swiper</code> or <code class="Ic">link-select</code> are
120 cc9bf8f2 2021-11-05 op invoked, the minibuffer area grows to show possible completions.</p>
121 cc9bf8f2 2021-11-05 op </section>
122 cc9bf8f2 2021-11-05 op <section class="Sh">
123 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="TOFU"><a class="permalink" href="#TOFU">TOFU</a></h1>
124 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> aims to use the &#x201C;Trust,
125 cc9bf8f2 2021-11-05 op but Verify (where appropriate)&#x201D; approach for TOFU (&#x201C;Trust On
126 cc9bf8f2 2021-11-05 op First Use&#x201D;). The idea is to define three level of verification for a
127 cc9bf8f2 2021-11-05 op certificate:</p>
128 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
129 cc9bf8f2 2021-11-05 op <dt>untrusted</dt>
130 cc9bf8f2 2021-11-05 op <dd>(&#x2018;!&#x2019;) the server fingerprint does NOT match the stored
131 cc9bf8f2 2021-11-05 op value.</dd>
132 cc9bf8f2 2021-11-05 op <dt>trusted</dt>
133 cc9bf8f2 2021-11-05 op <dd>(&#x2018;v&#x2019;) the server fingerprint matches the store one.</dd>
134 cc9bf8f2 2021-11-05 op <dt>verified</dt>
135 cc9bf8f2 2021-11-05 op <dd>(&#x2018;V&#x2019;) the fingerprint matches and has been verified
136 cc9bf8f2 2021-11-05 op out-of-band.</dd>
137 cc9bf8f2 2021-11-05 op </dl>
138 cc9bf8f2 2021-11-05 op <p class="Pp">The trust level of the page is indicated in the modeline with the
139 cc9bf8f2 2021-11-05 op indicated character.</p>
140 cc9bf8f2 2021-11-05 op <p class="Pp">Most of the time the &#x201C;trusted&#x201D; level is enough, but
141 cc9bf8f2 2021-11-05 op where is appropriate users should be able to verify out-of-band the
142 cc9bf8f2 2021-11-05 op certificate.</p>
143 cc9bf8f2 2021-11-05 op <p class="Pp">At the moment, there is no built-in support for an out-of-band
144 cc9bf8f2 2021-11-05 op verification though.</p>
145 cc9bf8f2 2021-11-05 op </section>
146 cc9bf8f2 2021-11-05 op <section class="Sh">
147 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="SUPPORTED_PROTOCOLS"><a class="permalink" href="#SUPPORTED_PROTOCOLS">SUPPORTED
148 cc9bf8f2 2021-11-05 op PROTOCOLS</a></h1>
149 cc9bf8f2 2021-11-05 op <p class="Pp">The following protocols are supported:</p>
150 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
151 cc9bf8f2 2021-11-05 op <dt>about:</dt>
152 cc9bf8f2 2021-11-05 op <dd>About pages are <code class="Nm">telescope</code> internal page. See
153 cc9bf8f2 2021-11-05 op about:about for a list of all these pages.</dd>
154 cc9bf8f2 2021-11-05 op <dt>file://</dt>
155 cc9bf8f2 2021-11-05 op <dd>File types know to <code class="Nm">telescope</code>, such as .gmi,
156 cc9bf8f2 2021-11-05 op .gemini, .txt, .md, .markdown, .diff or .patch, can be viewed inside the
157 cc9bf8f2 2021-11-05 op application. Types of local files are detected solely based on the file
158 cc9bf8f2 2021-11-05 op extension. On some systems, such as <span class="Ux">OpenBSD</span>, only
159 cc9bf8f2 2021-11-05 op files inside special directories (like <span class="Pa">/tmp</span>
160 cc9bf8f2 2021-11-05 op <span class="No">or</span> <span class="Pa">~/Downloads</span>) are
161 cc9bf8f2 2021-11-05 op available.</dd>
162 cc9bf8f2 2021-11-05 op <dt>finger://</dt>
163 cc9bf8f2 2021-11-05 op <dd>Finger URLs are interpreted as follows:
164 cc9bf8f2 2021-11-05 op <ul class="Bl-bullet Bl-compact">
165 cc9bf8f2 2021-11-05 op <li>the host is determined by the host name portion of the URL</li>
166 cc9bf8f2 2021-11-05 op <li>if the user portion of the URL is provided, it's interpreted as the
167 cc9bf8f2 2021-11-05 op user to finger, otherwise the path component will be used</li>
168 cc9bf8f2 2021-11-05 op </ul>
169 cc9bf8f2 2021-11-05 op thus <a class="Lk" href="finger://user@hostname">finger://user@hostname</a>
170 cc9bf8f2 2021-11-05 op and <a class="Lk" href="finger://hostname/user">finger://hostname/user</a>
171 cc9bf8f2 2021-11-05 op are treated as the same URL.</dd>
172 cc9bf8f2 2021-11-05 op <dt>gemini://</dt>
173 cc9bf8f2 2021-11-05 op <dd>Gemini is fully supported, with the exception of client-certificates.</dd>
174 cc9bf8f2 2021-11-05 op <dt>gopher://</dt>
175 cc9bf8f2 2021-11-05 op <dd>Gopher support is limited to items type 0, 1 and 7. All text is assumed to
176 cc9bf8f2 2021-11-05 op be encoded in UTF-8 (or ASCII).</dd>
177 cc9bf8f2 2021-11-05 op </dl>
178 cc9bf8f2 2021-11-05 op <p class="Pp">User-entered URLs, given as argument on the command line or
179 cc9bf8f2 2021-11-05 op entered with <code class="Ic">load-url</code>, are intepreted with a simple
180 cc9bf8f2 2021-11-05 op heuristic:</p>
181 cc9bf8f2 2021-11-05 op <ul class="Bl-bullet Bl-compact">
182 cc9bf8f2 2021-11-05 op <li>if it's a proper absolute URL then use it as-is,</li>
183 cc9bf8f2 2021-11-05 op <li>if it starts with &#x201C;./&#x201D; or &#x201C;/&#x201D; assume it's a
184 cc9bf8f2 2021-11-05 op file:// URL,</li>
185 cc9bf8f2 2021-11-05 op <li>otherwise assume it's a Gemini URL.</li>
186 cc9bf8f2 2021-11-05 op </ul>
187 bfd29c14 2021-12-01 op </section>
188 bfd29c14 2021-12-01 op <section class="Sh">
189 bfd29c14 2021-12-01 op <h1 class="Sh" id="CONFIGURATION_FILE"><a class="permalink" href="#CONFIGURATION_FILE">CONFIGURATION
190 bfd29c14 2021-12-01 op FILE</a></h1>
191 bfd29c14 2021-12-01 op <p class="Pp">During the startup, <code class="Nm">telescope</code> reads the
192 bfd29c14 2021-12-01 op configuration file at <span class="Pa">~/.config/telescope/config</span> or
193 bfd29c14 2021-12-01 op <span class="Pa">~/.telescope/config</span>.</p>
194 bfd29c14 2021-12-01 op <p class="Pp">It's possible to load a custom configuration file using the
195 bfd29c14 2021-12-01 op <code class="Fl">-c</code> flag.</p>
196 bfd29c14 2021-12-01 op <p class="Pp"><code class="Nm">telescope</code> will also load a file called
197 bfd29c14 2021-12-01 op <span class="Pa">config-TERM</span>, where &#x201C;TERM&#x201D; is the name
198 bfd29c14 2021-12-01 op of the terminal type (i.e. the TERM environment variable), if it exists.</p>
199 bfd29c14 2021-12-01 op <p class="Pp">The format of the configuration file is fairly flexible. The
200 bfd29c14 2021-12-01 op current line can be extended over multiple ones using a backslash
201 bfd29c14 2021-12-01 op (&#x2018;\&#x2019;). Comments can be put anywhere in the file using a hash
202 bfd29c14 2021-12-01 op mark (&#x2018;#&#x2019;), and extend to the end of the current line, but
203 bfd29c14 2021-12-01 op backslashes can't be used to extend comments over multiple lines.</p>
204 bfd29c14 2021-12-01 op <p class="Pp">The following constructs are available:</p>
205 bfd29c14 2021-12-01 op <dl class="Bl-tag">
206 bfd29c14 2021-12-01 op <dt id="bind"><a class="permalink" href="#bind"><code class="Ic">bind</code></a>
207 bfd29c14 2021-12-01 op <var class="Ar">map</var> <var class="Ar">key</var>
208 bfd29c14 2021-12-01 op <var class="Ar">cmd</var></dt>
209 bfd29c14 2021-12-01 op <dd>Bind <var class="Ar">key</var> to the function <var class="Ar">cmd</var>
210 bfd29c14 2021-12-01 op in the keymap <var class="Ar">map</var>. Valid values for map are
211 bfd29c14 2021-12-01 op &#x201C;global-map&#x201D; (i.e. when the user is viewing a page) and
212 bfd29c14 2021-12-01 op &#x201C;minibuffer-map&#x201D; (i.e. when the minibuffer has the focus.)
213 bfd29c14 2021-12-01 op <var class="Ar">key</var> follows the same syntax described in
214 bfd29c14 2021-12-01 op <a class="Sx" href="#DEFAULT_KEY_BINDINGS">DEFAULT KEY BINDINGS</a> and
215 bfd29c14 2021-12-01 op all the possible functions are listed in
216 bfd29c14 2021-12-01 op <a class="Sx" href="#INTERACTIVE_COMMANDS">INTERACTIVE COMMANDS</a>.</dd>
217 bfd29c14 2021-12-01 op <dt id="proxy"><a class="permalink" href="#proxy"><code class="Ic">proxy</code></a>
218 bfd29c14 2021-12-01 op <var class="Ar">proto</var> <code class="Ic">via</code>
219 bfd29c14 2021-12-01 op <var class="Ar">url</var></dt>
220 bfd29c14 2021-12-01 op <dd>Use <var class="Ar">url</var> as proxy for all URLs with protocol
221 bfd29c14 2021-12-01 op <var class="Ar">proto</var>. <var class="Ar">url</var> must be a Gemini
222 bfd29c14 2021-12-01 op URI without path, query and fragment component.</dd>
223 bfd29c14 2021-12-01 op <dt id="set"><a class="permalink" href="#set"><code class="Ic">set</code></a>
224 bfd29c14 2021-12-01 op <var class="Ar">opt</var> <span class="No">=</span>
225 bfd29c14 2021-12-01 op <var class="Ar">val</var></dt>
226 bfd29c14 2021-12-01 op <dd>Set the option <var class="Ar">opt</var> to the value
227 bfd29c14 2021-12-01 op <var class="Ar">val</var>. Valid options are:
228 bfd29c14 2021-12-01 op <p class="Pp"></p>
229 bfd29c14 2021-12-01 op <dl class="Bl-tag Bl-compact">
230 bfd29c14 2021-12-01 op <dt>autosave</dt>
231 bfd29c14 2021-12-01 op <dd>(integer) If greater than zero, save the session after the specified
232 bfd29c14 2021-12-01 op amount of seconds after some events happens (new or closed tabs,
233 bfd29c14 2021-12-01 op visited a link ...) Defaults to 20.</dd>
234 bfd29c14 2021-12-01 op <dt>dont-wrap-pre</dt>
235 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, don't wrap preformatted blocks. Defaults to
236 bfd29c14 2021-12-01 op 0.</dd>
237 bfd29c14 2021-12-01 op <dt>download-path</dt>
238 bfd29c14 2021-12-01 op <dd>(string) The default download path. Defaults to
239 bfd29c14 2021-12-01 op <span class="Pa">/tmp</span>.</dd>
240 bfd29c14 2021-12-01 op <dt>emojify-link</dt>
241 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, when the text of a link starts with an emoji
242 bfd29c14 2021-12-01 op followed by a space, use that emoji as line prefix. Defaults to
243 bfd29c14 2021-12-01 op 1.</dd>
244 bfd29c14 2021-12-01 op <dt>enable-colors</dt>
245 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, enable colours. Defaults to 0 if
246 bfd29c14 2021-12-01 op <code class="Ev">NO_COLORS</code> is set, 1 otherwise.</dd>
247 bfd29c14 2021-12-01 op <dt>fill-column</dt>
248 bfd29c14 2021-12-01 op <dd>(integer) If greater than zero, lines of text will be formatted in a
249 bfd29c14 2021-12-01 op way that don't exceed the given number of columns. Defaults to
250 bfd29c14 2021-12-01 op 80.</dd>
251 bfd29c14 2021-12-01 op <dt>hide-pre-blocks</dt>
252 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, hide by default the body of the preformatted
253 bfd29c14 2021-12-01 op blocks. Defaults to zero. <code class="Ic">push-button</code> can be
254 bfd29c14 2021-12-01 op used to toggle the visibility per-block.</dd>
255 bfd29c14 2021-12-01 op <dt>hide-pre-closing-line</dt>
256 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, hide the closing line of preformatted blocks.
257 bfd29c14 2021-12-01 op Defaults to 0.</dd>
258 bfd29c14 2021-12-01 op <dt>hide-pre-context</dt>
259 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, hide the start and end line of the preformatted
260 bfd29c14 2021-12-01 op blocks. If both hide-pre-context and hide-pre-blocks are nonzero,
261 bfd29c14 2021-12-01 op preformatted blocks are irremediably hidden. Defaults to zero.</dd>
262 bfd29c14 2021-12-01 op <dt>new-tab-url</dt>
263 bfd29c14 2021-12-01 op <dd>(string) URL for the new tab page. Defaults to
264 bfd29c14 2021-12-01 op &#x201C;about:new&#x201D;.</dd>
265 bfd29c14 2021-12-01 op <dt>olivetti-mode</dt>
266 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, enable <code class="Ic">olivetti-mode</code>
267 bfd29c14 2021-12-01 op Defaults to 1.</dd>
268 bfd29c14 2021-12-01 op <dt>set-title</dt>
269 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, set the terminal title to the page title.
270 bfd29c14 2021-12-01 op Defaults to 1.</dd>
271 bfd29c14 2021-12-01 op <dt>tab-bar-show</dt>
272 bfd29c14 2021-12-01 op <dd>(integer) If tab-bar-show is -1 hide the tab bar permanently, if 0
273 bfd29c14 2021-12-01 op show it unconditionally. If it's 1, show the bar only when there is
274 bfd29c14 2021-12-01 op more than one tab. Defaults to 1.</dd>
275 bfd29c14 2021-12-01 op </dl>
276 bfd29c14 2021-12-01 op </dd>
277 bfd29c14 2021-12-01 op <dt id="style"><a class="permalink" href="#style"><code class="Ic">style</code></a>
278 bfd29c14 2021-12-01 op <var class="Ar">name</var> <var class="Ar">option</var></dt>
279 bfd29c14 2021-12-01 op <dd>Change the styling of the element identified by
280 bfd29c14 2021-12-01 op <var class="Ar">name</var>. Multiple options may be specified within curly
281 bfd29c14 2021-12-01 op braces. Valid style identifiers are:
282 bfd29c14 2021-12-01 op <div class="Bd-indent">
283 bfd29c14 2021-12-01 op <dl class="Bl-tag Bl-compact">
284 bfd29c14 2021-12-01 op <dt>line</dt>
285 bfd29c14 2021-12-01 op <dd>the area outside the lines in the body of the page.</dd>
286 bfd29c14 2021-12-01 op <dt>line.compl</dt>
287 bfd29c14 2021-12-01 op <dd>the completions.</dd>
288 bfd29c14 2021-12-01 op <dt>line.compl.current</dt>
289 bfd29c14 2021-12-01 op <dd>the current completion.</dd>
290 bfd29c14 2021-12-01 op <dt>line.help</dt>
291 bfd29c14 2021-12-01 op <dd>text in the *Help* buffer.</dd>
292 bfd29c14 2021-12-01 op <dt>line.download.ongoing</dt>
293 bfd29c14 2021-12-01 op <dd>an ongoing download</dd>
294 bfd29c14 2021-12-01 op <dt>line.download.done</dt>
295 bfd29c14 2021-12-01 op <dd>a completed download</dd>
296 bfd29c14 2021-12-01 op <dt>line.download.info</dt>
297 bfd29c14 2021-12-01 op <dd>informational text in the *Downloads* buffer.</dd>
298 bfd29c14 2021-12-01 op <dt>line.text</dt>
299 bfd29c14 2021-12-01 op <dd>text lines.</dd>
300 bfd29c14 2021-12-01 op <dt>line.link</dt>
301 bfd29c14 2021-12-01 op <dd>link lines.</dd>
302 bfd29c14 2021-12-01 op <dt>line.title1..3</dt>
303 bfd29c14 2021-12-01 op <dd>headings</dd>
304 bfd29c14 2021-12-01 op <dt>line.item</dt>
305 bfd29c14 2021-12-01 op <dd>item lines.</dd>
306 bfd29c14 2021-12-01 op <dt>line.quote</dt>
307 bfd29c14 2021-12-01 op <dd>quotes.</dd>
308 bfd29c14 2021-12-01 op <dt>line.pre.start</dt>
309 bfd29c14 2021-12-01 op <dd>the heading of a preformatted block.</dd>
310 bfd29c14 2021-12-01 op <dt>line.pre</dt>
311 bfd29c14 2021-12-01 op <dd>the content of a preformatted block.</dd>
312 bfd29c14 2021-12-01 op <dt>line.pre.end</dt>
313 bfd29c14 2021-12-01 op <dd>the closing line of a preformatted block.</dd>
314 bfd29c14 2021-12-01 op <dt>download</dt>
315 bfd29c14 2021-12-01 op <dd>the download pane</dd>
316 bfd29c14 2021-12-01 op <dt>minibuffer</dt>
317 bfd29c14 2021-12-01 op <dd>the minibuffer.</dd>
318 bfd29c14 2021-12-01 op <dt>modeline</dt>
319 bfd29c14 2021-12-01 op <dd>the modeline.</dd>
320 bfd29c14 2021-12-01 op <dt>tabline</dt>
321 bfd29c14 2021-12-01 op <dd>the tabline.</dd>
322 bfd29c14 2021-12-01 op <dt>tabline.tab</dt>
323 bfd29c14 2021-12-01 op <dd>the non-focused tabs.</dd>
324 bfd29c14 2021-12-01 op <dt>tabline.current</dt>
325 bfd29c14 2021-12-01 op <dd>the focused tab.</dd>
326 bfd29c14 2021-12-01 op </dl>
327 bfd29c14 2021-12-01 op </div>
328 bfd29c14 2021-12-01 op <p class="Pp">Valid options are:</p>
329 bfd29c14 2021-12-01 op <dl class="Bl-tag">
330 bfd29c14 2021-12-01 op <dt id="attr"><a class="permalink" href="#attr"><code class="Ic">attr</code></a>
331 bfd29c14 2021-12-01 op <var class="Ar">prefix</var> [<var class="Ar">line</var>
332 bfd29c14 2021-12-01 op [<var class="Ar">trail</var>]]</dt>
333 bfd29c14 2021-12-01 op <dd>Sets the text attributes. If only one value is given,
334 bfd29c14 2021-12-01 op <var class="Ar">line</var> and <var class="Ar">trail</var> default to
335 bfd29c14 2021-12-01 op that; if two values are given then <var class="Ar">trail</var>
336 bfd29c14 2021-12-01 op defaults to <var class="Ar">prefix</var>. Each attribute is a
337 bfd29c14 2021-12-01 op comma-separated list of keywords:
338 bfd29c14 2021-12-01 op <div class="Bd-indent">
339 bfd29c14 2021-12-01 op <dl class="Bl-tag Bl-compact">
340 bfd29c14 2021-12-01 op <dt id="normal"><a class="permalink" href="#normal"><code class="Ic">normal</code></a></dt>
341 bfd29c14 2021-12-01 op <dd>no attributes.</dd>
342 bfd29c14 2021-12-01 op <dt id="standout"><a class="permalink" href="#standout"><code class="Ic">standout</code></a></dt>
343 bfd29c14 2021-12-01 op <dd>best highlighting mode for the terminal.</dd>
344 bfd29c14 2021-12-01 op <dt id="underline"><a class="permalink" href="#underline"><code class="Ic">underline</code></a></dt>
345 bfd29c14 2021-12-01 op <dd>underlines the text.</dd>
346 bfd29c14 2021-12-01 op <dt id="reverse"><a class="permalink" href="#reverse"><code class="Ic">reverse</code></a></dt>
347 bfd29c14 2021-12-01 op <dd>reverses background/foreground colors.</dd>
348 bfd29c14 2021-12-01 op <dt id="blink"><a class="permalink" href="#blink"><code class="Ic">blink</code></a></dt>
349 bfd29c14 2021-12-01 op <dd>makes the text blinking.</dd>
350 bfd29c14 2021-12-01 op <dt id="dim"><a class="permalink" href="#dim"><code class="Ic">dim</code></a></dt>
351 bfd29c14 2021-12-01 op <dd>half bright.</dd>
352 bfd29c14 2021-12-01 op <dt id="bold"><a class="permalink" href="#bold"><code class="Ic">bold</code></a></dt>
353 bfd29c14 2021-12-01 op <dd>extra bright or bold.</dd>
354 bfd29c14 2021-12-01 op </dl>
355 bfd29c14 2021-12-01 op </div>
356 bfd29c14 2021-12-01 op <p class="Pp">Only the style identifiers with the &#x201C;line.&#x201D;
357 bfd29c14 2021-12-01 op prefix accept up to three attributes. The other will only use the
358 bfd29c14 2021-12-01 op first one given.</p>
359 bfd29c14 2021-12-01 op </dd>
360 bfd29c14 2021-12-01 op <dt id="bg"><a class="permalink" href="#bg"><code class="Ic">bg</code></a>
361 bfd29c14 2021-12-01 op <var class="Ar">prefix</var> [<var class="Ar">line</var>
362 bfd29c14 2021-12-01 op [<var class="Ar">trail</var>]]</dt>
363 bfd29c14 2021-12-01 op <dd>Sets the background color. Follows the same behaviour as
364 bfd29c14 2021-12-01 op <code class="Ic">attr</code> regarding the optional parameters. The
365 bfd29c14 2021-12-01 op colour is one of black, red, green, yellow, blue, magenta, cyan and
366 bfd29c14 2021-12-01 op white; colour0 to colour255 (or color0 to color255) from the
367 bfd29c14 2021-12-01 op 256-colour set; default for the default colour.</dd>
368 bfd29c14 2021-12-01 op <dt id="fg"><a class="permalink" href="#fg"><code class="Ic">fg</code></a>
369 bfd29c14 2021-12-01 op <var class="Ar">prefix</var> [<var class="Ar">line</var>
370 bfd29c14 2021-12-01 op [<var class="Ar">trail</var>]]</dt>
371 bfd29c14 2021-12-01 op <dd>Sets the foreground color. It behaves just like
372 bfd29c14 2021-12-01 op <code class="Ic">bg</code>.</dd>
373 bfd29c14 2021-12-01 op <dt id="prefix"><a class="permalink" href="#prefix"><code class="Ic">prefix</code></a>
374 bfd29c14 2021-12-01 op <var class="Ar">prfx</var> [<var class="Ar">cont</var>]</dt>
375 bfd29c14 2021-12-01 op <dd>Sets the prefix for the current line type to
376 bfd29c14 2021-12-01 op <var class="Ar">prfx</var> and <var class="Ar">cont</var> as the
377 bfd29c14 2021-12-01 op prefix for the continuation lines (i.e. when a long line gets
378 bfd29c14 2021-12-01 op wrapped.) If <var class="Ar">cont</var> is not given its value will be
379 bfd29c14 2021-12-01 op the same of <var class="Ar">prfx</var>.</dd>
380 bfd29c14 2021-12-01 op </dl>
381 bfd29c14 2021-12-01 op </dd>
382 bfd29c14 2021-12-01 op </dl>
383 cc9bf8f2 2021-11-05 op </section>
384 cc9bf8f2 2021-11-05 op <section class="Sh">
385 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="DEFAULT_KEY_BINDINGS"><a class="permalink" href="#DEFAULT_KEY_BINDINGS">DEFAULT
386 cc9bf8f2 2021-11-05 op KEY BINDINGS</a></h1>
387 cc9bf8f2 2021-11-05 op <p class="Pp">The default key bindings are very similar to GNU Emacs, but care
388 cc9bf8f2 2021-11-05 op has been taken to include also bindings familiar for <a class="Xr">vi(1)</a>
389 cc9bf8f2 2021-11-05 op and &#x201C;CUA&#x201D; users. In the following examples, C-x means
390 cc9bf8f2 2021-11-05 op Control-x, M-x means Meta-x, where the Meta key may be either a special key
391 cc9bf8f2 2021-11-05 op on the keyboard or the ALT key; otherwise ESC followed by the key X works as
392 cc9bf8f2 2021-11-05 op well, and C-M-x means to press the key X together with both Control and
393 cc9bf8f2 2021-11-05 op Meta.</p>
394 cc9bf8f2 2021-11-05 op <p class="Pp">Keys are usually a single character, like &#x2018;p&#x2019; or
395 cc9bf8f2 2021-11-05 op &#x2018;n&#x2019;, but some special keys are accepted as well.</p>
396 cc9bf8f2 2021-11-05 op <p class="Pp"></p>
397 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
398 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
399 cc9bf8f2 2021-11-05 op <dt>&lt;up&gt;</dt>
400 cc9bf8f2 2021-11-05 op <dd>Up arrow</dd>
401 cc9bf8f2 2021-11-05 op <dt>&lt;down&gt;</dt>
402 cc9bf8f2 2021-11-05 op <dd>Down arrow</dd>
403 cc9bf8f2 2021-11-05 op <dt>&lt;left&gt;</dt>
404 cc9bf8f2 2021-11-05 op <dd>Left arrow</dd>
405 cc9bf8f2 2021-11-05 op <dt>&lt;right&gt;</dt>
406 cc9bf8f2 2021-11-05 op <dd>Right arrow</dd>
407 cc9bf8f2 2021-11-05 op <dt>&lt;prior&gt;</dt>
408 cc9bf8f2 2021-11-05 op <dd>Previous page/Page up</dd>
409 cc9bf8f2 2021-11-05 op <dt>&lt;next&gt;</dt>
410 cc9bf8f2 2021-11-05 op <dd>Next page/Page down</dd>
411 cc9bf8f2 2021-11-05 op <dt>&lt;home&gt;</dt>
412 cc9bf8f2 2021-11-05 op <dd>Home</dd>
413 cc9bf8f2 2021-11-05 op <dt>&lt;end&gt;</dt>
414 cc9bf8f2 2021-11-05 op <dd>End</dd>
415 cc9bf8f2 2021-11-05 op <dt>&lt;f0&gt; thru &lt;f63&gt;</dt>
416 cc9bf8f2 2021-11-05 op <dd>Function keys</dd>
417 cc9bf8f2 2021-11-05 op <dt>del or backspace</dt>
418 cc9bf8f2 2021-11-05 op <dd>Backspace</dd>
419 cc9bf8f2 2021-11-05 op <dt>esc</dt>
420 cc9bf8f2 2021-11-05 op <dd>Escape</dd>
421 cc9bf8f2 2021-11-05 op <dt>space or spc</dt>
422 cc9bf8f2 2021-11-05 op <dd>Space</dd>
423 cc9bf8f2 2021-11-05 op <dt>enter or ret</dt>
424 cc9bf8f2 2021-11-05 op <dd>Enter</dd>
425 cc9bf8f2 2021-11-05 op <dt>tab</dt>
426 cc9bf8f2 2021-11-05 op <dd>Tab</dd>
427 cc9bf8f2 2021-11-05 op <dt>backtab</dt>
428 cc9bf8f2 2021-11-05 op <dd>Depends on the configuration of the terminal emulator; usually shift
429 cc9bf8f2 2021-11-05 op tab.</dd>
430 cc9bf8f2 2021-11-05 op </dl>
431 cc9bf8f2 2021-11-05 op </div>
432 cc9bf8f2 2021-11-05 op <section class="Ss">
433 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="GNU_Emacs-like_keys"><a class="permalink" href="#GNU_Emacs-like_keys">GNU
434 cc9bf8f2 2021-11-05 op Emacs-like keys</a></h2>
435 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
436 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
437 cc9bf8f2 2021-11-05 op <dt>C-p</dt>
438 cc9bf8f2 2021-11-05 op <dd>previous-line</dd>
439 cc9bf8f2 2021-11-05 op <dt>C-n</dt>
440 cc9bf8f2 2021-11-05 op <dd>next-line</dd>
441 cc9bf8f2 2021-11-05 op <dt>C-f</dt>
442 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
443 cc9bf8f2 2021-11-05 op <dt>C-b</dt>
444 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
445 cc9bf8f2 2021-11-05 op <dt>M-{</dt>
446 cc9bf8f2 2021-11-05 op <dd>backward-paragraph</dd>
447 cc9bf8f2 2021-11-05 op <dt>M-}</dt>
448 cc9bf8f2 2021-11-05 op <dd>forward-paragraph</dd>
449 cc9bf8f2 2021-11-05 op <dt>C-a</dt>
450 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
451 cc9bf8f2 2021-11-05 op <dt>C-e</dt>
452 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
453 cc9bf8f2 2021-11-05 op <dt>M-v, M-space</dt>
454 cc9bf8f2 2021-11-05 op <dd>scroll-up</dd>
455 cc9bf8f2 2021-11-05 op <dt>C-v, space</dt>
456 cc9bf8f2 2021-11-05 op <dd>scroll-down</dd>
457 cc9bf8f2 2021-11-05 op <dt>M-&lt;</dt>
458 cc9bf8f2 2021-11-05 op <dd>beginning-of-buffer</dd>
459 cc9bf8f2 2021-11-05 op <dt>M-&gt;</dt>
460 cc9bf8f2 2021-11-05 op <dd>end-of-buffer</dd>
461 cc9bf8f2 2021-11-05 op <dt>C-x C-c</dt>
462 cc9bf8f2 2021-11-05 op <dd>kill-telescope</dd>
463 cc9bf8f2 2021-11-05 op <dt>C-g</dt>
464 cc9bf8f2 2021-11-05 op <dd>clear-minibuf</dd>
465 cc9bf8f2 2021-11-05 op <dt>M-x</dt>
466 cc9bf8f2 2021-11-05 op <dd>execute-extended-command</dd>
467 cc9bf8f2 2021-11-05 op <dt>C-c {</dt>
468 cc9bf8f2 2021-11-05 op <dd>dec-fill-column</dd>
469 cc9bf8f2 2021-11-05 op <dt>C-c }</dt>
470 cc9bf8f2 2021-11-05 op <dd>inc-fill-column</dd>
471 cc9bf8f2 2021-11-05 op <dt>C-c p</dt>
472 cc9bf8f2 2021-11-05 op <dd>previous-heading</dd>
473 cc9bf8f2 2021-11-05 op <dt>C-c n</dt>
474 cc9bf8f2 2021-11-05 op <dd>next-heading</dd>
475 cc9bf8f2 2021-11-05 op <dt>&gt;</dt>
476 cc9bf8f2 2021-11-05 op <dd>load-url</dd>
477 cc9bf8f2 2021-11-05 op <dt>&lt;</dt>
478 cc9bf8f2 2021-11-05 op <dd>load-current-url</dd>
479 cc9bf8f2 2021-11-05 op <dt>C-x C-f</dt>
480 cc9bf8f2 2021-11-05 op <dd>load-url</dd>
481 cc9bf8f2 2021-11-05 op <dt>C-x M-f</dt>
482 cc9bf8f2 2021-11-05 op <dd>load-current-url</dd>
483 cc9bf8f2 2021-11-05 op <dt>C-x o</dt>
484 cc9bf8f2 2021-11-05 op <dd>other-window</dd>
485 cc9bf8f2 2021-11-05 op <dt>C-x t 0</dt>
486 cc9bf8f2 2021-11-05 op <dd>tab-close</dd>
487 cc9bf8f2 2021-11-05 op <dt>C-x t 1</dt>
488 cc9bf8f2 2021-11-05 op <dd>tab-close-other</dd>
489 cc9bf8f2 2021-11-05 op <dt>C-x t 2</dt>
490 cc9bf8f2 2021-11-05 op <dd>tab-new</dd>
491 cc9bf8f2 2021-11-05 op <dt>C-x t o</dt>
492 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
493 cc9bf8f2 2021-11-05 op <dt>C-x t O</dt>
494 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
495 cc9bf8f2 2021-11-05 op <dt>C-x t m</dt>
496 cc9bf8f2 2021-11-05 op <dd>tab-move</dd>
497 cc9bf8f2 2021-11-05 op <dt>C-x t M</dt>
498 cc9bf8f2 2021-11-05 op <dd>tab-move-to</dd>
499 cc9bf8f2 2021-11-05 op <dt>B, C-M-b</dt>
500 cc9bf8f2 2021-11-05 op <dd>previous-page</dd>
501 cc9bf8f2 2021-11-05 op <dt>F, C-M-f</dt>
502 cc9bf8f2 2021-11-05 op <dd>next-page</dd>
503 cc9bf8f2 2021-11-05 op <dt>&lt;f7&gt; a</dt>
504 cc9bf8f2 2021-11-05 op <dd>bookmark-page</dd>
505 cc9bf8f2 2021-11-05 op <dt>&lt;f7&gt; &lt;f7&gt;</dt>
506 cc9bf8f2 2021-11-05 op <dd>list-bookmarks</dd>
507 cc9bf8f2 2021-11-05 op <dt>C-z</dt>
508 cc9bf8f2 2021-11-05 op <dd>suspend-telescope</dd>
509 cc9bf8f2 2021-11-05 op </dl>
510 cc9bf8f2 2021-11-05 op </div>
511 cc9bf8f2 2021-11-05 op </section>
512 cc9bf8f2 2021-11-05 op <section class="Ss">
513 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="vi_1_-like_keys"><a class="permalink" href="#vi_1_-like_keys"><a class="Xr">vi(1)</a>-like
514 cc9bf8f2 2021-11-05 op keys</a></h2>
515 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
516 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
517 cc9bf8f2 2021-11-05 op <dt>k</dt>
518 cc9bf8f2 2021-11-05 op <dd>previous-line</dd>
519 cc9bf8f2 2021-11-05 op <dt>j</dt>
520 cc9bf8f2 2021-11-05 op <dd>next-line</dd>
521 cc9bf8f2 2021-11-05 op <dt>l</dt>
522 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
523 cc9bf8f2 2021-11-05 op <dt>h</dt>
524 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
525 cc9bf8f2 2021-11-05 op <dt>{</dt>
526 cc9bf8f2 2021-11-05 op <dd>backward-paragraph</dd>
527 cc9bf8f2 2021-11-05 op <dt>}</dt>
528 cc9bf8f2 2021-11-05 op <dd>forward-paragraph</dd>
529 cc9bf8f2 2021-11-05 op <dt>^</dt>
530 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
531 cc9bf8f2 2021-11-05 op <dt>$</dt>
532 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
533 cc9bf8f2 2021-11-05 op <dt>K</dt>
534 cc9bf8f2 2021-11-05 op <dd>scroll-line-up</dd>
535 cc9bf8f2 2021-11-05 op <dt>J</dt>
536 cc9bf8f2 2021-11-05 op <dd>scroll-line-down</dd>
537 cc9bf8f2 2021-11-05 op <dt>g g</dt>
538 cc9bf8f2 2021-11-05 op <dd>beginning-of-buffer</dd>
539 cc9bf8f2 2021-11-05 op <dt>G</dt>
540 cc9bf8f2 2021-11-05 op <dd>end-of-buffer</dd>
541 cc9bf8f2 2021-11-05 op <dt>g D</dt>
542 cc9bf8f2 2021-11-05 op <dd>tab-close</dd>
543 cc9bf8f2 2021-11-05 op <dt>g N</dt>
544 cc9bf8f2 2021-11-05 op <dd>tab-new</dd>
545 cc9bf8f2 2021-11-05 op <dt>g t</dt>
546 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
547 cc9bf8f2 2021-11-05 op <dt>g T</dt>
548 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
549 cc9bf8f2 2021-11-05 op <dt>g M-t</dt>
550 cc9bf8f2 2021-11-05 op <dd>tab-move</dd>
551 cc9bf8f2 2021-11-05 op <dt>g M-T</dt>
552 cc9bf8f2 2021-11-05 op <dd>tab-move-to</dd>
553 cc9bf8f2 2021-11-05 op <dt>H</dt>
554 cc9bf8f2 2021-11-05 op <dd>previous-page</dd>
555 cc9bf8f2 2021-11-05 op <dt>L</dt>
556 cc9bf8f2 2021-11-05 op <dd>next-page</dd>
557 cc9bf8f2 2021-11-05 op <dt>q</dt>
558 cc9bf8f2 2021-11-05 op <dd>kill-telescope</dd>
559 cc9bf8f2 2021-11-05 op <dt>ESC</dt>
560 cc9bf8f2 2021-11-05 op <dd>clear-minibuf</dd>
561 cc9bf8f2 2021-11-05 op <dt>:</dt>
562 cc9bf8f2 2021-11-05 op <dd>execute-extended-command</dd>
563 cc9bf8f2 2021-11-05 op </dl>
564 cc9bf8f2 2021-11-05 op </div>
565 cc9bf8f2 2021-11-05 op </section>
566 cc9bf8f2 2021-11-05 op <section class="Ss">
567 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="CUA-like_keys"><a class="permalink" href="#CUA-like_keys">CUA-like
568 cc9bf8f2 2021-11-05 op keys</a></h2>
569 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
570 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
571 cc9bf8f2 2021-11-05 op <dt>&lt;up&gt;</dt>
572 cc9bf8f2 2021-11-05 op <dd>previous-line</dd>
573 cc9bf8f2 2021-11-05 op <dt>&lt;down&gt;</dt>
574 cc9bf8f2 2021-11-05 op <dd>next-line</dd>
575 cc9bf8f2 2021-11-05 op <dt>&lt;right&gt;</dt>
576 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
577 cc9bf8f2 2021-11-05 op <dt>&lt;left&gt;</dt>
578 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
579 cc9bf8f2 2021-11-05 op <dt>&lt;home&gt;</dt>
580 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
581 cc9bf8f2 2021-11-05 op <dt>&lt;end&gt;</dt>
582 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
583 cc9bf8f2 2021-11-05 op <dt>&lt;prior&gt;</dt>
584 cc9bf8f2 2021-11-05 op <dd>scroll-up</dd>
585 cc9bf8f2 2021-11-05 op <dt>&lt;next&gt;</dt>
586 cc9bf8f2 2021-11-05 op <dd>scroll-down</dd>
587 cc9bf8f2 2021-11-05 op <dt>C-w</dt>
588 cc9bf8f2 2021-11-05 op <dd>tab-close</dd>
589 cc9bf8f2 2021-11-05 op <dt>C-t</dt>
590 cc9bf8f2 2021-11-05 op <dd>tab-new</dd>
591 cc9bf8f2 2021-11-05 op <dt>M-&lt;prior&gt;</dt>
592 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
593 cc9bf8f2 2021-11-05 op <dt>M-&lt;next&gt;</dt>
594 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
595 cc9bf8f2 2021-11-05 op <dt>M-&lt;left&gt;</dt>
596 cc9bf8f2 2021-11-05 op <dd>previous-page</dd>
597 cc9bf8f2 2021-11-05 op <dt>M-&lt;right&gt;</dt>
598 cc9bf8f2 2021-11-05 op <dd>next-page</dd>
599 cc9bf8f2 2021-11-05 op <dt>&lt;f5&gt;</dt>
600 cc9bf8f2 2021-11-05 op <dd>reload-page</dd>
601 cc9bf8f2 2021-11-05 op <dt>r</dt>
602 cc9bf8f2 2021-11-05 op <dd>reload-page</dd>
603 cc9bf8f2 2021-11-05 op </dl>
604 cc9bf8f2 2021-11-05 op </div>
605 cc9bf8f2 2021-11-05 op </section>
606 cc9bf8f2 2021-11-05 op <section class="Ss">
607 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Neither_Emacs_nor_vi_specific"><a class="permalink" href="#Neither_Emacs_nor_vi_specific">Neither
608 cc9bf8f2 2021-11-05 op Emacs nor vi specific</a></h2>
609 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
610 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
611 cc9bf8f2 2021-11-05 op <dt>&lt;f1&gt;</dt>
612 cc9bf8f2 2021-11-05 op <dd>toggle-help</dd>
613 cc9bf8f2 2021-11-05 op <dt>enter</dt>
614 cc9bf8f2 2021-11-05 op <dd>push-button</dd>
615 cc9bf8f2 2021-11-05 op <dt>M-enter</dt>
616 cc9bf8f2 2021-11-05 op <dd>push-button-new-tab</dd>
617 cc9bf8f2 2021-11-05 op <dt>M-tab</dt>
618 cc9bf8f2 2021-11-05 op <dd>previous-button</dd>
619 cc9bf8f2 2021-11-05 op <dt>backtab</dt>
620 cc9bf8f2 2021-11-05 op <dd>previous-button</dd>
621 cc9bf8f2 2021-11-05 op <dt>tab</dt>
622 cc9bf8f2 2021-11-05 op <dd>next-button</dd>
623 cc9bf8f2 2021-11-05 op <dt>M-t</dt>
624 cc9bf8f2 2021-11-05 op <dd>tab-select</dd>
625 cc9bf8f2 2021-11-05 op <dt>[</dt>
626 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
627 cc9bf8f2 2021-11-05 op <dt>]</dt>
628 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
629 cc9bf8f2 2021-11-05 op <dt>M-[</dt>
630 cc9bf8f2 2021-11-05 op <dd>tab-move-to</dd>
631 cc9bf8f2 2021-11-05 op <dt>M-]</dt>
632 cc9bf8f2 2021-11-05 op <dd>tab-move</dd>
633 cc9bf8f2 2021-11-05 op <dt>M-l</dt>
634 cc9bf8f2 2021-11-05 op <dd>link-select</dd>
635 cc9bf8f2 2021-11-05 op <dt>M-/</dt>
636 cc9bf8f2 2021-11-05 op <dd>swiper</dd>
637 cc9bf8f2 2021-11-05 op </dl>
638 cc9bf8f2 2021-11-05 op </div>
639 cc9bf8f2 2021-11-05 op </section>
640 cc9bf8f2 2021-11-05 op <section class="Ss">
641 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Minibuffer-specific_keys"><a class="permalink" href="#Minibuffer-specific_keys">Minibuffer-specific
642 cc9bf8f2 2021-11-05 op keys</a></h2>
643 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
644 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
645 cc9bf8f2 2021-11-05 op <dt>enter</dt>
646 cc9bf8f2 2021-11-05 op <dd>mini-complete-and-exit</dd>
647 cc9bf8f2 2021-11-05 op <dt>C-g</dt>
648 cc9bf8f2 2021-11-05 op <dd>mini-abort</dd>
649 cc9bf8f2 2021-11-05 op <dt>ESC</dt>
650 cc9bf8f2 2021-11-05 op <dd>mini-abort</dd>
651 cc9bf8f2 2021-11-05 op <dt>C-d</dt>
652 cc9bf8f2 2021-11-05 op <dd>mini-delete-char</dd>
653 cc9bf8f2 2021-11-05 op <dt>del</dt>
654 cc9bf8f2 2021-11-05 op <dd>mini-delete-backward-char</dd>
655 cc9bf8f2 2021-11-05 op <dt>backspace</dt>
656 cc9bf8f2 2021-11-05 op <dd>mini-delete-backward-char</dd>
657 cc9bf8f2 2021-11-05 op <dt>C-h</dt>
658 cc9bf8f2 2021-11-05 op <dd>mini-delete-backward-char</dd>
659 cc9bf8f2 2021-11-05 op <dt>C-b</dt>
660 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
661 cc9bf8f2 2021-11-05 op <dt>C-f</dt>
662 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
663 cc9bf8f2 2021-11-05 op <dt>&lt;left&gt;</dt>
664 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
665 cc9bf8f2 2021-11-05 op <dt>&lt;right&gt;</dt>
666 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
667 cc9bf8f2 2021-11-05 op <dt>C-e</dt>
668 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
669 cc9bf8f2 2021-11-05 op <dt>C-a</dt>
670 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
671 cc9bf8f2 2021-11-05 op <dt>&lt;end&gt;</dt>
672 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
673 cc9bf8f2 2021-11-05 op <dt>&lt;home&gt;</dt>
674 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
675 cc9bf8f2 2021-11-05 op <dt>C-k</dt>
676 cc9bf8f2 2021-11-05 op <dd>mini-kill-line</dd>
677 cc9bf8f2 2021-11-05 op <dt>M-p</dt>
678 cc9bf8f2 2021-11-05 op <dd>mini-previous-history-element</dd>
679 cc9bf8f2 2021-11-05 op <dt>M-n</dt>
680 cc9bf8f2 2021-11-05 op <dd>mini-next-history-element</dd>
681 cc9bf8f2 2021-11-05 op <dt>C-p</dt>
682 cc9bf8f2 2021-11-05 op <dd>previous-completion</dd>
683 cc9bf8f2 2021-11-05 op <dt>C-n</dt>
684 cc9bf8f2 2021-11-05 op <dd>next-completion</dd>
685 cc9bf8f2 2021-11-05 op <dt>&lt;up&gt;</dt>
686 cc9bf8f2 2021-11-05 op <dd>previous-completion</dd>
687 cc9bf8f2 2021-11-05 op <dt>&lt;down&gt;</dt>
688 cc9bf8f2 2021-11-05 op <dd>next-completion</dd>
689 cc9bf8f2 2021-11-05 op <dt>tab</dt>
690 cc9bf8f2 2021-11-05 op <dd>insert-current-candidate</dd>
691 cc9bf8f2 2021-11-05 op <dt>M-&lt;</dt>
692 cc9bf8f2 2021-11-05 op <dd>mini-goto-beginning</dd>
693 cc9bf8f2 2021-11-05 op <dt>M-&gt;</dt>
694 cc9bf8f2 2021-11-05 op <dd>mini-goto-end</dd>
695 cc9bf8f2 2021-11-05 op </dl>
696 cc9bf8f2 2021-11-05 op </div>
697 cc9bf8f2 2021-11-05 op </section>
698 cc9bf8f2 2021-11-05 op </section>
699 cc9bf8f2 2021-11-05 op <section class="Sh">
700 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="INTERACTIVE_COMMANDS"><a class="permalink" href="#INTERACTIVE_COMMANDS">INTERACTIVE
701 cc9bf8f2 2021-11-05 op COMMANDS</a></h1>
702 cc9bf8f2 2021-11-05 op <p class="Pp">Follows the documentation for the interactive commands. These
703 cc9bf8f2 2021-11-05 op commands can be bound to a key or executed with
704 cc9bf8f2 2021-11-05 op <code class="Ic">execute-extended-command</code>.</p>
705 cc9bf8f2 2021-11-05 op <section class="Ss">
706 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Movement_commands"><a class="permalink" href="#Movement_commands">Movement
707 cc9bf8f2 2021-11-05 op commands</a></h2>
708 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
709 cc9bf8f2 2021-11-05 op <dt id="backward-char"><a class="permalink" href="#backward-char"><code class="Ic">backward-char</code></a></dt>
710 cc9bf8f2 2021-11-05 op <dd>Move point one character backward.</dd>
711 cc9bf8f2 2021-11-05 op <dt id="backward-paragraph"><a class="permalink" href="#backward-paragraph"><code class="Ic">backward-paragraph</code></a></dt>
712 cc9bf8f2 2021-11-05 op <dd>Move point one paragraph backward.</dd>
713 cc9bf8f2 2021-11-05 op <dt id="beginning-of-buffer"><a class="permalink" href="#beginning-of-buffer"><code class="Ic">beginning-of-buffer</code></a></dt>
714 cc9bf8f2 2021-11-05 op <dd>Move point to the beginning of the buffer.</dd>
715 cc9bf8f2 2021-11-05 op <dt id="end-of-buffer"><a class="permalink" href="#end-of-buffer"><code class="Ic">end-of-buffer</code></a></dt>
716 cc9bf8f2 2021-11-05 op <dd>Move point to the end of the buffer.</dd>
717 cc9bf8f2 2021-11-05 op <dt id="forward-char"><a class="permalink" href="#forward-char"><code class="Ic">forward-char</code></a></dt>
718 cc9bf8f2 2021-11-05 op <dd>Move point one character forward.</dd>
719 cc9bf8f2 2021-11-05 op <dt id="forward-paragraph"><a class="permalink" href="#forward-paragraph"><code class="Ic">forward-paragraph</code></a></dt>
720 cc9bf8f2 2021-11-05 op <dd>Move point one paragraph forward.</dd>
721 cc9bf8f2 2021-11-05 op <dt id="insert-current-candidate"><a class="permalink" href="#insert-current-candidate"><code class="Ic">insert-current-candidate</code></a></dt>
722 cc9bf8f2 2021-11-05 op <dd>Copy the current selection text as minibuffer input.</dd>
723 cc9bf8f2 2021-11-05 op <dt id="move-beginning-of-line"><a class="permalink" href="#move-beginning-of-line"><code class="Ic">move-beginning-of-line</code></a></dt>
724 cc9bf8f2 2021-11-05 op <dd>Move point at the beginning of the current (visual) line.</dd>
725 cc9bf8f2 2021-11-05 op <dt id="move-end-of-line"><a class="permalink" href="#move-end-of-line"><code class="Ic">move-end-of-line</code></a></dt>
726 cc9bf8f2 2021-11-05 op <dd>Move point at the end of the current (visual) line.</dd>
727 cc9bf8f2 2021-11-05 op <dt id="next-button"><a class="permalink" href="#next-button"><code class="Ic">next-button</code></a></dt>
728 cc9bf8f2 2021-11-05 op <dd>Move point to the next link.</dd>
729 cc9bf8f2 2021-11-05 op <dt id="next-completion"><a class="permalink" href="#next-completion"><code class="Ic">next-completion</code></a></dt>
730 cc9bf8f2 2021-11-05 op <dd>Select the next completion.</dd>
731 cc9bf8f2 2021-11-05 op <dt id="next-heading"><a class="permalink" href="#next-heading"><code class="Ic">next-heading</code></a></dt>
732 cc9bf8f2 2021-11-05 op <dd>Move point to the next heading.</dd>
733 cc9bf8f2 2021-11-05 op <dt id="next-line"><a class="permalink" href="#next-line"><code class="Ic">next-line</code></a></dt>
734 cc9bf8f2 2021-11-05 op <dd>Move point to the next (visual) line, in the same column if possible.</dd>
735 cc9bf8f2 2021-11-05 op <dt id="previous-button"><a class="permalink" href="#previous-button"><code class="Ic">previous-button</code></a></dt>
736 cc9bf8f2 2021-11-05 op <dd>Move point to the previous link.</dd>
737 cc9bf8f2 2021-11-05 op <dt id="previous-completion"><a class="permalink" href="#previous-completion"><code class="Ic">previous-completion</code></a></dt>
738 cc9bf8f2 2021-11-05 op <dd>Select the previous completion.</dd>
739 cc9bf8f2 2021-11-05 op <dt id="previous-heading"><a class="permalink" href="#previous-heading"><code class="Ic">previous-heading</code></a></dt>
740 cc9bf8f2 2021-11-05 op <dd>Move point to the previous heading.</dd>
741 cc9bf8f2 2021-11-05 op <dt id="previous-line"><a class="permalink" href="#previous-line"><code class="Ic">previous-line</code></a></dt>
742 cc9bf8f2 2021-11-05 op <dd>Move point to the previous (visual) line.</dd>
743 cc9bf8f2 2021-11-05 op </dl>
744 cc9bf8f2 2021-11-05 op </section>
745 cc9bf8f2 2021-11-05 op <section class="Ss">
746 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Bookmark-related_commands"><a class="permalink" href="#Bookmark-related_commands">Bookmark-related
747 cc9bf8f2 2021-11-05 op commands</a></h2>
748 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
749 cc9bf8f2 2021-11-05 op <dt id="bookmark-page"><a class="permalink" href="#bookmark-page"><code class="Ic">bookmark-page</code></a></dt>
750 cc9bf8f2 2021-11-05 op <dd>Save a page in the bookmark file. It preloads the minibuffer with the
751 cc9bf8f2 2021-11-05 op current URL.</dd>
752 cc9bf8f2 2021-11-05 op <dt id="list-bookmarks"><a class="permalink" href="#list-bookmarks"><code class="Ic">list-bookmarks</code></a></dt>
753 cc9bf8f2 2021-11-05 op <dd>Load the bookmarks page.</dd>
754 cc9bf8f2 2021-11-05 op </dl>
755 cc9bf8f2 2021-11-05 op </section>
756 cc9bf8f2 2021-11-05 op <section class="Ss">
757 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Tab-related_commands"><a class="permalink" href="#Tab-related_commands">Tab-related
758 cc9bf8f2 2021-11-05 op commands</a></h2>
759 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
760 cc9bf8f2 2021-11-05 op <dt id="tab-close"><a class="permalink" href="#tab-close"><code class="Ic">tab-close</code></a></dt>
761 cc9bf8f2 2021-11-05 op <dd>Close the current tab.</dd>
762 cc9bf8f2 2021-11-05 op <dt id="tab-close-other"><a class="permalink" href="#tab-close-other"><code class="Ic">tab-close-other</code></a></dt>
763 cc9bf8f2 2021-11-05 op <dd>Close all tabs but the current one.</dd>
764 cc9bf8f2 2021-11-05 op <dt id="tab-move"><a class="permalink" href="#tab-move"><code class="Ic">tab-move</code></a></dt>
765 cc9bf8f2 2021-11-05 op <dd>Move the current tab after the next one, wrapping around if needed.</dd>
766 cc9bf8f2 2021-11-05 op <dt id="tab-move-to"><a class="permalink" href="#tab-move-to"><code class="Ic">tab-move-to</code></a></dt>
767 cc9bf8f2 2021-11-05 op <dd>Move the current tab before the previous one, wrapping around if
768 cc9bf8f2 2021-11-05 op needed.</dd>
769 cc9bf8f2 2021-11-05 op <dt id="tab-new"><a class="permalink" href="#tab-new"><code class="Ic">tab-new</code></a></dt>
770 cc9bf8f2 2021-11-05 op <dd>Open a new tab.</dd>
771 cc9bf8f2 2021-11-05 op <dt id="tab-next"><a class="permalink" href="#tab-next"><code class="Ic">tab-next</code></a></dt>
772 cc9bf8f2 2021-11-05 op <dd>Focus next tab, wrapping around eventually.</dd>
773 cc9bf8f2 2021-11-05 op <dt id="tab-previous"><a class="permalink" href="#tab-previous"><code class="Ic">tab-previous</code></a></dt>
774 cc9bf8f2 2021-11-05 op <dd>Focus the previous tab, wrapping around eventually.</dd>
775 cc9bf8f2 2021-11-05 op <dt id="tab-select"><a class="permalink" href="#tab-select"><code class="Ic">tab-select</code></a></dt>
776 cc9bf8f2 2021-11-05 op <dd>Switch to a tab using the minibuffer.</dd>
777 cc9bf8f2 2021-11-05 op </dl>
778 cc9bf8f2 2021-11-05 op </section>
779 cc9bf8f2 2021-11-05 op <section class="Ss">
780 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Misc_commands"><a class="permalink" href="#Misc_commands">Misc
781 cc9bf8f2 2021-11-05 op commands</a></h2>
782 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
783 cc9bf8f2 2021-11-05 op <dt id="clear-minibuf"><a class="permalink" href="#clear-minibuf"><code class="Ic">clear-minibuf</code></a></dt>
784 cc9bf8f2 2021-11-05 op <dd>Clear the echo area.</dd>
785 cc9bf8f2 2021-11-05 op <dt id="dec-fill-column"><a class="permalink" href="#dec-fill-column"><code class="Ic">dec-fill-column</code></a></dt>
786 cc9bf8f2 2021-11-05 op <dd>Decrement fill-column by two.</dd>
787 cc9bf8f2 2021-11-05 op <dt id="execute-extended-command"><a class="permalink" href="#execute-extended-command"><code class="Ic">execute-extended-command</code></a></dt>
788 cc9bf8f2 2021-11-05 op <dd>Execute an internal command.</dd>
789 cc9bf8f2 2021-11-05 op <dt id="kill-telescope"><a class="permalink" href="#kill-telescope"><code class="Ic">kill-telescope</code></a></dt>
790 cc9bf8f2 2021-11-05 op <dd>Quit <code class="Nm">telescope</code>.</dd>
791 cc9bf8f2 2021-11-05 op <dt id="inc-fill-column"><a class="permalink" href="#inc-fill-column"><code class="Ic">inc-fill-column</code></a></dt>
792 cc9bf8f2 2021-11-05 op <dd>Increment fill-column by two.</dd>
793 cc9bf8f2 2021-11-05 op <dt id="link-select"><a class="permalink" href="#link-select"><code class="Ic">link-select</code></a></dt>
794 cc9bf8f2 2021-11-05 op <dd>Select and visit a link using the minibuffer.</dd>
795 cc9bf8f2 2021-11-05 op <dt id="load-current-url"><a class="permalink" href="#load-current-url"><code class="Ic">load-current-url</code></a></dt>
796 cc9bf8f2 2021-11-05 op <dd>Edit the current URL.</dd>
797 cc9bf8f2 2021-11-05 op <dt id="load-url"><a class="permalink" href="#load-url"><code class="Ic">load-url</code></a></dt>
798 cc9bf8f2 2021-11-05 op <dd>Prompt for an URL.</dd>
799 cc9bf8f2 2021-11-05 op <dt id="next-page"><a class="permalink" href="#next-page"><code class="Ic">next-page</code></a></dt>
800 cc9bf8f2 2021-11-05 op <dd>Go forward in the page history.</dd>
801 cc9bf8f2 2021-11-05 op <dt id="olivetti-mode"><a class="permalink" href="#olivetti-mode"><code class="Ic">olivetti-mode</code></a></dt>
802 cc9bf8f2 2021-11-05 op <dd>Toggle olivetti mode (i.e. horizontal centering of the lines of the
803 cc9bf8f2 2021-11-05 op window.)</dd>
804 cc9bf8f2 2021-11-05 op <dt id="other-window"><a class="permalink" href="#other-window"><code class="Ic">other-window</code></a></dt>
805 cc9bf8f2 2021-11-05 op <dd>Select the other window.</dd>
806 cc9bf8f2 2021-11-05 op <dt id="previous-page"><a class="permalink" href="#previous-page"><code class="Ic">previous-page</code></a></dt>
807 cc9bf8f2 2021-11-05 op <dd>Go backward in the page history.</dd>
808 cc9bf8f2 2021-11-05 op <dt id="push-button"><a class="permalink" href="#push-button"><code class="Ic">push-button</code></a></dt>
809 cc9bf8f2 2021-11-05 op <dd>Follow link at point, or toggle the visibility of the following
810 cc9bf8f2 2021-11-05 op preformatted block if called when the cursor is on the heading of the
811 cc9bf8f2 2021-11-05 op block.</dd>
812 cc9bf8f2 2021-11-05 op <dt id="push-button-new-tab"><a class="permalink" href="#push-button-new-tab"><code class="Ic">push-button-new-tab</code></a></dt>
813 cc9bf8f2 2021-11-05 op <dd>Follow link at point in a new tab.</dd>
814 cc9bf8f2 2021-11-05 op <dt id="redraw"><a class="permalink" href="#redraw"><code class="Ic">redraw</code></a></dt>
815 cc9bf8f2 2021-11-05 op <dd>Redraw the screen, useful if some background program messed up the
816 cc9bf8f2 2021-11-05 op display.</dd>
817 cc9bf8f2 2021-11-05 op <dt id="reload-page"><a class="permalink" href="#reload-page"><code class="Ic">reload-page</code></a></dt>
818 cc9bf8f2 2021-11-05 op <dd>Reload the current page.</dd>
819 cc9bf8f2 2021-11-05 op <dt id="scroll-down"><a class="permalink" href="#scroll-down"><code class="Ic">scroll-down</code></a></dt>
820 cc9bf8f2 2021-11-05 op <dd>Scroll down by one visual page.</dd>
821 cc9bf8f2 2021-11-05 op <dt id="scroll-line-down"><a class="permalink" href="#scroll-line-down"><code class="Ic">scroll-line-down</code></a></dt>
822 cc9bf8f2 2021-11-05 op <dd>Scroll down by one line.</dd>
823 cc9bf8f2 2021-11-05 op <dt id="scroll-line-up"><a class="permalink" href="#scroll-line-up"><code class="Ic">scroll-line-up</code></a></dt>
824 cc9bf8f2 2021-11-05 op <dd>Scroll up by one line.</dd>
825 cc9bf8f2 2021-11-05 op <dt id="scroll-up"><a class="permalink" href="#scroll-up"><code class="Ic">scroll-up</code></a></dt>
826 cc9bf8f2 2021-11-05 op <dd>Scroll up by one visual page.</dd>
827 cc9bf8f2 2021-11-05 op <dt id="suspend-telescope"><a class="permalink" href="#suspend-telescope"><code class="Ic">suspend-telescope</code></a></dt>
828 cc9bf8f2 2021-11-05 op <dd>Suspend the current <code class="Nm">telescope</code> session.</dd>
829 cc9bf8f2 2021-11-05 op <dt id="swiper"><a class="permalink" href="#swiper"><code class="Ic">swiper</code></a></dt>
830 cc9bf8f2 2021-11-05 op <dd>Jump to a line using the minibuffer.</dd>
831 cc9bf8f2 2021-11-05 op <dt id="toc"><a class="permalink" href="#toc"><code class="Ic">toc</code></a></dt>
832 cc9bf8f2 2021-11-05 op <dd>Jump to a heading using the minibuffer.</dd>
833 cc9bf8f2 2021-11-05 op <dt id="toggle-help"><a class="permalink" href="#toggle-help"><code class="Ic">toggle-help</code></a></dt>
834 cc9bf8f2 2021-11-05 op <dd>Toggle side window with help about available keys and their associated
835 cc9bf8f2 2021-11-05 op interactive command.</dd>
836 cc9bf8f2 2021-11-05 op <dt id="toggle-pre-wrap"><a class="permalink" href="#toggle-pre-wrap"><code class="Ic">toggle-pre-wrap</code></a></dt>
837 cc9bf8f2 2021-11-05 op <dd>Toggle the wrapping of preformatted blocks.</dd>
838 cc9bf8f2 2021-11-05 op </dl>
839 cc9bf8f2 2021-11-05 op </section>
840 cc9bf8f2 2021-11-05 op <section class="Ss">
841 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Minibuffer_commands"><a class="permalink" href="#Minibuffer_commands">Minibuffer
842 cc9bf8f2 2021-11-05 op commands</a></h2>
843 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
844 cc9bf8f2 2021-11-05 op <dt id="mini-abort"><a class="permalink" href="#mini-abort"><code class="Ic">mini-abort</code></a></dt>
845 cc9bf8f2 2021-11-05 op <dd>Abort the current minibuffer action.</dd>
846 cc9bf8f2 2021-11-05 op <dt id="mini-complete-and-exit"><a class="permalink" href="#mini-complete-and-exit"><code class="Ic">mini-complete-and-exit</code></a></dt>
847 cc9bf8f2 2021-11-05 op <dd>Complete the current minibuffer action.</dd>
848 cc9bf8f2 2021-11-05 op <dt id="mini-delete-backward-char"><a class="permalink" href="#mini-delete-backward-char"><code class="Ic">mini-delete-backward-char</code></a></dt>
849 cc9bf8f2 2021-11-05 op <dd>Delete the character before the point.</dd>
850 cc9bf8f2 2021-11-05 op <dt id="mini-delete-char"><a class="permalink" href="#mini-delete-char"><code class="Ic">mini-delete-char</code></a></dt>
851 cc9bf8f2 2021-11-05 op <dd>Delete the character after the point.</dd>
852 cc9bf8f2 2021-11-05 op <dt id="mini-goto-beginning"><a class="permalink" href="#mini-goto-beginning"><code class="Ic">mini-goto-beginning</code></a></dt>
853 cc9bf8f2 2021-11-05 op <dd>Select the first completion, if any.</dd>
854 cc9bf8f2 2021-11-05 op <dt id="mini-goto-end"><a class="permalink" href="#mini-goto-end"><code class="Ic">mini-goto-end</code></a></dt>
855 cc9bf8f2 2021-11-05 op <dd>Select the last completion, if any.</dd>
856 cc9bf8f2 2021-11-05 op <dt id="mini-kill-line"><a class="permalink" href="#mini-kill-line"><code class="Ic">mini-kill-line</code></a></dt>
857 cc9bf8f2 2021-11-05 op <dd>Delete from point until the end of the line.</dd>
858 cc9bf8f2 2021-11-05 op <dt id="mini-next-history-element"><a class="permalink" href="#mini-next-history-element"><code class="Ic">mini-next-history-element</code></a></dt>
859 cc9bf8f2 2021-11-05 op <dd>Load the previous history element.</dd>
860 cc9bf8f2 2021-11-05 op <dt id="mini-previous-history-element"><a class="permalink" href="#mini-previous-history-element"><code class="Ic">mini-previous-history-element</code></a></dt>
861 cc9bf8f2 2021-11-05 op <dd>Load the next history element.</dd>
862 cc9bf8f2 2021-11-05 op </dl>
863 cc9bf8f2 2021-11-05 op </section>
864 cc9bf8f2 2021-11-05 op <section class="Ss">
865 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Aliases"><a class="permalink" href="#Aliases">Aliases</a></h2>
866 cc9bf8f2 2021-11-05 op <p class="Pp">The following aliases are available during
867 cc9bf8f2 2021-11-05 op <code class="Ic">execute-extended-command</code>:</p>
868 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
869 cc9bf8f2 2021-11-05 op <dt id="tabn"><a class="permalink" href="#tabn"><code class="Ic">tabn</code></a></dt>
870 cc9bf8f2 2021-11-05 op <dd><a class="permalink" href="#tab-next~2"><code class="Ic" id="tab-next~2">tab-next</code></a></dd>
871 cc9bf8f2 2021-11-05 op <dt id="tabnew"><a class="permalink" href="#tabnew"><code class="Ic">tabnew</code></a></dt>
872 cc9bf8f2 2021-11-05 op <dd><a class="permalink" href="#tab-new~2"><code class="Ic" id="tab-new~2">tab-new</code></a></dd>
873 cc9bf8f2 2021-11-05 op <dt id="tabp"><a class="permalink" href="#tabp"><code class="Ic">tabp</code></a></dt>
874 cc9bf8f2 2021-11-05 op <dd><a class="permalink" href="#tab-previous~2"><code class="Ic" id="tab-previous~2">tab-previous</code></a></dd>
875 cc9bf8f2 2021-11-05 op <dt id="q"><a class="permalink" href="#q"><code class="Ic">q</code></a>
876 cc9bf8f2 2021-11-05 op <span class="No">and</span> <code class="Ic">wq</code></dt>
877 cc9bf8f2 2021-11-05 op <dd><a class="permalink" href="#kill-telescope~2"><code class="Ic" id="kill-telescope~2">kill-telescope</code></a></dd>
878 cc9bf8f2 2021-11-05 op </dl>
879 cc9bf8f2 2021-11-05 op </section>
880 cc9bf8f2 2021-11-05 op </section>
881 cc9bf8f2 2021-11-05 op <section class="Sh">
882 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="ENVIRONMENT"><a class="permalink" href="#ENVIRONMENT">ENVIRONMENT</a></h1>
883 cc9bf8f2 2021-11-05 op <p class="Pp">When <code class="Nm">telescope</code> is started, it inspects the
884 cc9bf8f2 2021-11-05 op following environment variables:</p>
885 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
886 cc9bf8f2 2021-11-05 op <dt id="HOME"><a class="permalink" href="#HOME"><code class="Ev">HOME</code></a></dt>
887 cc9bf8f2 2021-11-05 op <dd>The user's login directory.</dd>
888 cc9bf8f2 2021-11-05 op <dt id="NO_COLORS"><a class="permalink" href="#NO_COLORS"><code class="Ev">NO_COLORS</code></a></dt>
889 cc9bf8f2 2021-11-05 op <dd>To decide whether to use colors or not. The content of the variable
890 cc9bf8f2 2021-11-05 op doesn't matter.</dd>
891 cc9bf8f2 2021-11-05 op <dt id="TERM"><a class="permalink" href="#TERM"><code class="Ev">TERM</code></a></dt>
892 cc9bf8f2 2021-11-05 op <dd>The user's terminal name.</dd>
893 bfd29c14 2021-12-01 op <dt id="XDG_CACHE_HOME"><a class="permalink" href="#XDG_CACHE_HOME"><code class="Ev">XDG_CACHE_HOME</code></a>,
894 bfd29c14 2021-12-01 op <code class="Ev">XDG_CONFIG_HOME</code>,
895 bfd29c14 2021-12-01 op <code class="Ev">XDG_DATA_HOME</code></dt>
896 bfd29c14 2021-12-01 op <dd>If defined can alter the default location of the files used.</dd>
897 cc9bf8f2 2021-11-05 op </dl>
898 cc9bf8f2 2021-11-05 op </section>
899 cc9bf8f2 2021-11-05 op <section class="Sh">
900 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
901 bfd29c14 2021-12-01 op <p class="Pp">By default <code class="Nm">telescope</code> follows the XDG Base
902 bfd29c14 2021-12-01 op Directory Specification. However, if <span class="Pa">~/.telescope</span>
903 bfd29c14 2021-12-01 op exists, XDG is ignored and all the files are stored inside it. The usage of
904 bfd29c14 2021-12-01 op <code class="Ev">XDG_CACHE_HOME</code>,
905 bfd29c14 2021-12-01 op <code class="Ev">XDG_CONFIG_HOME</code> and
906 bfd29c14 2021-12-01 op <code class="Ev">XDG_DATA_HOME</code> can further alter the location of
907 bfd29c14 2021-12-01 op these files.</p>
908 bfd29c14 2021-12-01 op <p class="Pp"></p>
909 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
910 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.config/telescope/config</span></dt>
911 cc9bf8f2 2021-11-05 op <dd>Default configuration file.</dd>
912 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.local/share/telescope/pages/about_*.gmi</span></dt>
913 bfd29c14 2021-12-01 op <dd>Overrides for built-in about: pages.</dd>
914 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.local/share/telescope/bookmarks.gmi</span></dt>
915 bfd29c14 2021-12-01 op <dd>Bookmarks file.</dd>
916 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.local/share/telescope/known_hosts</span></dt>
917 cc9bf8f2 2021-11-05 op <dd>Hash of the certificates for all the known hosts. Each line contains three
918 cc9bf8f2 2021-11-05 op fields: hostname with optional port number, hash of the certificate and a
919 cc9bf8f2 2021-11-05 op numeric flag.</dd>
920 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.cache/telescope/lock</span></dt>
921 cc9bf8f2 2021-11-05 op <dd>Lock file used to prevent multiple instance of
922 cc9bf8f2 2021-11-05 op <code class="Nm">telescope</code> from running at the same time.</dd>
923 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.cache/telescope/session</span></dt>
924 cc9bf8f2 2021-11-05 op <dd>The list of tabs from the last session. Every line identifies a tab and
925 cc9bf8f2 2021-11-05 op contains three space-separated fields: the full URL, a comma-separated
926 cc9bf8f2 2021-11-05 op list of attributes and the cached title. Is written by
927 cc9bf8f2 2021-11-05 op <code class="Ic">kill-telescope</code> and loaded during startup.</dd>
928 cc9bf8f2 2021-11-05 op </dl>
929 cc9bf8f2 2021-11-05 op </section>
930 cc9bf8f2 2021-11-05 op <section class="Sh">
931 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
932 cc9bf8f2 2021-11-05 op <p class="Pp">It's possible to browse &#x201C;the small web&#x201D; (i.e. simple
933 cc9bf8f2 2021-11-05 op websites) by using programs like the duckling-proxy by defining a proxy in
934 bfd29c14 2021-12-01 op <span class="Pa">~/.config/telescope/config</span>:</p>
935 cc9bf8f2 2021-11-05 op <div class="Bd Pp Bd-indent Li">
936 cc9bf8f2 2021-11-05 op <pre>proxy http via &quot;gemini://127.0.0.1:1965&quot;
937 cc9bf8f2 2021-11-05 op proxy https via &quot;gemini://127.0.0.1:1965&quot;</pre>
938 cc9bf8f2 2021-11-05 op </div>
939 cc9bf8f2 2021-11-05 op <p class="Pp">To load <code class="Nm">telescope</code> without any
940 cc9bf8f2 2021-11-05 op configuration</p>
941 cc9bf8f2 2021-11-05 op <div class="Bd Pp Bd-indent Li">
942 cc9bf8f2 2021-11-05 op <pre>telescope -c /dev/null</pre>
943 cc9bf8f2 2021-11-05 op </div>
944 cc9bf8f2 2021-11-05 op </section>
945 cc9bf8f2 2021-11-05 op <section class="Sh">
946 bfd29c14 2021-12-01 op <h1 class="Sh" id="STANDARDS"><a class="permalink" href="#STANDARDS">STANDARDS</a></h1>
947 bfd29c14 2021-12-01 op <p class="Pp"><cite class="Rs"><i class="RsB">XDG Base Directory
948 bfd29c14 2021-12-01 op Specification</i>,
949 bfd29c14 2021-12-01 op <a class="RsU" href="https://specifications.freedesktop.org/basedir-spec/latest/">https://specifications.freedesktop.org/basedir-spec/latest/</a>.</cite></p>
950 bfd29c14 2021-12-01 op </section>
951 bfd29c14 2021-12-01 op <section class="Sh">
952 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
953 cc9bf8f2 2021-11-05 op <p class="Pp">The <code class="Nm">telescope</code> program was written by
954 cc9bf8f2 2021-11-05 op <span class="An">Omar Polo</span>
955 cc9bf8f2 2021-11-05 op &lt;<a class="Mt" href="mailto:op@omarpolo.com">op@omarpolo.com</a>&gt;.</p>
956 cc9bf8f2 2021-11-05 op </section>
957 cc9bf8f2 2021-11-05 op <section class="Sh">
958 bfd29c14 2021-12-01 op <h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1>
959 bfd29c14 2021-12-01 op <p class="Pp"><code class="Nm">telescope</code> assumes a UTF-8 environment and
960 bfd29c14 2021-12-01 op doesn't do anything to cope with other encodings. This can cause weird
961 bfd29c14 2021-12-01 op rendering issues if you're lucky, or possibly worst things depending on your
962 bfd29c14 2021-12-01 op locale and terminal emulator.</p>
963 bfd29c14 2021-12-01 op </section>
964 bfd29c14 2021-12-01 op <section class="Sh">
965 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
966 cc9bf8f2 2021-11-05 op <p class="Pp">There's no UI for out-of-band certificates validation.</p>
967 cc9bf8f2 2021-11-05 op </section>
968 cc9bf8f2 2021-11-05 op </div>
969 cc9bf8f2 2021-11-05 op <table class="foot">
970 cc9bf8f2 2021-11-05 op <tr>
971 ca5a29bf 2021-12-30 op <td class="foot-date">November 29, 2021</td>
972 cc9bf8f2 2021-11-05 op <td class="foot-os">OpenBSD 7.0</td>
973 cc9bf8f2 2021-11-05 op </tr>
974 cc9bf8f2 2021-11-05 op </table>
975 cc9bf8f2 2021-11-05 op </body>
976 cc9bf8f2 2021-11-05 op </html>