1 cc9bf8f2 2021-11-05 op <!DOCTYPE html>
3 cc9bf8f2 2021-11-05 op <!-- This is an automatically generated file. Do not edit.
4 d9bfe90a 2022-01-13 op Copyright (c) 2021, 2022 Omar Polo <op@omarpolo.com>
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.
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.
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"/>
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;
30 bfd29c14 2021-12-01 op overflow: auto;
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; }
42 cc9bf8f2 2021-11-05 op <title>TELESCOPE(1)</title>
45 cc9bf8f2 2021-11-05 op <table class="head">
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>
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> —
56 cc9bf8f2 2021-11-05 op <span class="Nd">multi-protocol browser</span></p>
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">
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> <var class="Ar">config</var>]
65 cc9bf8f2 2021-11-05 op [<var class="Ar">URL</var>]</td>
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 d9bfe90a 2022-01-13 op <code class="Fl">--colours</code></dt>
79 d9bfe90a 2022-01-13 op <dd>Show all available colors and exit. This option can also be spelled
80 d9bfe90a 2022-01-13 op <code class="Fl">--colors</code>.</dd>
81 cc9bf8f2 2021-11-05 op <dt id="c"><a class="permalink" href="#c"><code class="Fl">-c</code></a>
82 ca5a29bf 2021-12-30 op <var class="Ar">config</var></dt>
83 cc9bf8f2 2021-11-05 op <dd>Specify an alternative configuration file. By default
84 ca5a29bf 2021-12-30 op <span class="Pa">~/.config/telescope/config</span> is loaded.</dd>
85 cc9bf8f2 2021-11-05 op <dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a>,
86 cc9bf8f2 2021-11-05 op <code class="Fl">--help</code></dt>
87 d9bfe90a 2022-01-13 op <dd>Display version, usage and exit.</dd>
88 cc9bf8f2 2021-11-05 op <dt id="n"><a class="permalink" href="#n"><code class="Fl">-n</code></a></dt>
89 cc9bf8f2 2021-11-05 op <dd>Configtest mode. Only check the configuration file for validity.</dd>
90 bfd29c14 2021-12-01 op <dt id="S"><a class="permalink" href="#S"><code class="Fl">-S</code></a>,
91 bfd29c14 2021-12-01 op <code class="Fl">--safe</code></dt>
92 bfd29c14 2021-12-01 op <dd>“Safe” (or “sandbox”) mode. Prevent
93 bfd29c14 2021-12-01 op <code class="Nm">telescope</code> from writing files to the disk and to
94 bfd29c14 2021-12-01 op acquire the lock, allowing to run multiple instances at the same time.
95 bfd29c14 2021-12-01 op <code class="Nm">telescope</code> still loads the session file and the
96 bfd29c14 2021-12-01 op custom about pages.</dd>
97 cc9bf8f2 2021-11-05 op <dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a>,
98 cc9bf8f2 2021-11-05 op <code class="Fl">--version</code></dt>
99 d9bfe90a 2022-01-13 op <dd>Display version and exit.</dd>
102 cc9bf8f2 2021-11-05 op <section class="Sh">
103 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="UI_CONCEPTS"><a class="permalink" href="#UI_CONCEPTS">UI
104 cc9bf8f2 2021-11-05 op CONCEPTS</a></h1>
105 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> interface is divided into four
106 cc9bf8f2 2021-11-05 op areas: the tabline, the body, the modeline and the echoarea/minibuffer.</p>
107 cc9bf8f2 2021-11-05 op <p class="Pp">The tabline is always at the top of the screen and displays the
108 cc9bf8f2 2021-11-05 op tabs separated by a vertical line. When there are more tabs than the size of
109 cc9bf8f2 2021-11-05 op the window allow to display, the characters ‘<’ or
110 cc9bf8f2 2021-11-05 op ‘>’ are shown at the start/end of the tabline to indicate
111 cc9bf8f2 2021-11-05 op that there are more tabs in that direction.</p>
112 cc9bf8f2 2021-11-05 op <p class="Pp">The body occupies the majority of the visible area. It contains
113 cc9bf8f2 2021-11-05 op the current page and optionally a side window.</p>
114 cc9bf8f2 2021-11-05 op <p class="Pp">The modeline is the second to last row of the screen. It shows
115 cc9bf8f2 2021-11-05 op some information about the page: a spinner when the page is loading, the
116 cc9bf8f2 2021-11-05 op trust level, the document type, the scroll offset and the URL.</p>
117 cc9bf8f2 2021-11-05 op <p class="Pp">The echoarea is usually the last line of the screen. Messages are
118 cc9bf8f2 2021-11-05 op often showed there, and link addresses too. The echoarea is also used to
119 cc9bf8f2 2021-11-05 op obtain input from the user. When commands like
120 cc9bf8f2 2021-11-05 op <code class="Ic">swiper</code> or <code class="Ic">link-select</code> are
121 cc9bf8f2 2021-11-05 op invoked, the minibuffer area grows to show possible completions.</p>
123 cc9bf8f2 2021-11-05 op <section class="Sh">
124 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="TOFU"><a class="permalink" href="#TOFU">TOFU</a></h1>
125 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> aims to use the “Trust,
126 cc9bf8f2 2021-11-05 op but Verify (where appropriate)” approach for TOFU (“Trust On
127 cc9bf8f2 2021-11-05 op First Use”). The idea is to define three level of verification for a
128 cc9bf8f2 2021-11-05 op certificate:</p>
129 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
130 cc9bf8f2 2021-11-05 op <dt>untrusted</dt>
131 cc9bf8f2 2021-11-05 op <dd>(‘!’) the server fingerprint does NOT match the stored
133 cc9bf8f2 2021-11-05 op <dt>trusted</dt>
134 cc9bf8f2 2021-11-05 op <dd>(‘v’) the server fingerprint matches the store one.</dd>
135 cc9bf8f2 2021-11-05 op <dt>verified</dt>
136 cc9bf8f2 2021-11-05 op <dd>(‘V’) the fingerprint matches and has been verified
137 cc9bf8f2 2021-11-05 op out-of-band.</dd>
139 cc9bf8f2 2021-11-05 op <p class="Pp">The trust level of the page is indicated in the modeline with the
140 cc9bf8f2 2021-11-05 op indicated character.</p>
141 cc9bf8f2 2021-11-05 op <p class="Pp">Most of the time the “trusted” level is enough, but
142 cc9bf8f2 2021-11-05 op where is appropriate users should be able to verify out-of-band the
143 cc9bf8f2 2021-11-05 op certificate.</p>
144 cc9bf8f2 2021-11-05 op <p class="Pp">At the moment, there is no built-in support for an out-of-band
145 cc9bf8f2 2021-11-05 op verification though.</p>
147 cc9bf8f2 2021-11-05 op <section class="Sh">
148 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="SUPPORTED_PROTOCOLS"><a class="permalink" href="#SUPPORTED_PROTOCOLS">SUPPORTED
149 cc9bf8f2 2021-11-05 op PROTOCOLS</a></h1>
150 cc9bf8f2 2021-11-05 op <p class="Pp">The following protocols are supported:</p>
151 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
152 cc9bf8f2 2021-11-05 op <dt>about:</dt>
153 cc9bf8f2 2021-11-05 op <dd>About pages are <code class="Nm">telescope</code> internal page. See
154 cc9bf8f2 2021-11-05 op about:about for a list of all these pages.</dd>
155 cc9bf8f2 2021-11-05 op <dt>file://</dt>
156 cc9bf8f2 2021-11-05 op <dd>File types know to <code class="Nm">telescope</code>, such as .gmi,
157 cc9bf8f2 2021-11-05 op .gemini, .txt, .md, .markdown, .diff or .patch, can be viewed inside the
158 cc9bf8f2 2021-11-05 op application. Types of local files are detected solely based on the file
159 cc9bf8f2 2021-11-05 op extension. On some systems, such as <span class="Ux">OpenBSD</span>, only
160 cc9bf8f2 2021-11-05 op files inside special directories (like <span class="Pa">/tmp</span>
161 cc9bf8f2 2021-11-05 op <span class="No">or</span> <span class="Pa">~/Downloads</span>) are
162 cc9bf8f2 2021-11-05 op available.</dd>
163 cc9bf8f2 2021-11-05 op <dt>finger://</dt>
164 cc9bf8f2 2021-11-05 op <dd>Finger URLs are interpreted as follows:
165 cc9bf8f2 2021-11-05 op <ul class="Bl-bullet Bl-compact">
166 cc9bf8f2 2021-11-05 op <li>the host is determined by the host name portion of the URL</li>
167 cc9bf8f2 2021-11-05 op <li>if the user portion of the URL is provided, it's interpreted as the
168 cc9bf8f2 2021-11-05 op user to finger, otherwise the path component will be used</li>
170 cc9bf8f2 2021-11-05 op thus <a class="Lk" href="finger://user@hostname">finger://user@hostname</a>
171 cc9bf8f2 2021-11-05 op and <a class="Lk" href="finger://hostname/user">finger://hostname/user</a>
172 cc9bf8f2 2021-11-05 op are treated as the same URL.</dd>
173 cc9bf8f2 2021-11-05 op <dt>gemini://</dt>
174 cc9bf8f2 2021-11-05 op <dd>Gemini is fully supported, with the exception of client-certificates.</dd>
175 cc9bf8f2 2021-11-05 op <dt>gopher://</dt>
176 cc9bf8f2 2021-11-05 op <dd>Gopher support is limited to items type 0, 1 and 7. All text is assumed to
177 cc9bf8f2 2021-11-05 op be encoded in UTF-8 (or ASCII).</dd>
179 cc9bf8f2 2021-11-05 op <p class="Pp">User-entered URLs, given as argument on the command line or
180 cc9bf8f2 2021-11-05 op entered with <code class="Ic">load-url</code>, are intepreted with a simple
181 cc9bf8f2 2021-11-05 op heuristic:</p>
182 cc9bf8f2 2021-11-05 op <ul class="Bl-bullet Bl-compact">
183 cc9bf8f2 2021-11-05 op <li>if it's a proper absolute URL then use it as-is,</li>
184 cc9bf8f2 2021-11-05 op <li>if it starts with “./” or “/” assume it's a
185 cc9bf8f2 2021-11-05 op file:// URL,</li>
186 cc9bf8f2 2021-11-05 op <li>otherwise assume it's a Gemini URL.</li>
189 bfd29c14 2021-12-01 op <section class="Sh">
190 bfd29c14 2021-12-01 op <h1 class="Sh" id="CONFIGURATION_FILE"><a class="permalink" href="#CONFIGURATION_FILE">CONFIGURATION
191 bfd29c14 2021-12-01 op FILE</a></h1>
192 bfd29c14 2021-12-01 op <p class="Pp">During the startup, <code class="Nm">telescope</code> reads the
193 bfd29c14 2021-12-01 op configuration file at <span class="Pa">~/.config/telescope/config</span> or
194 bfd29c14 2021-12-01 op <span class="Pa">~/.telescope/config</span>.</p>
195 bfd29c14 2021-12-01 op <p class="Pp">It's possible to load a custom configuration file using the
196 bfd29c14 2021-12-01 op <code class="Fl">-c</code> flag.</p>
197 bfd29c14 2021-12-01 op <p class="Pp"><code class="Nm">telescope</code> will also load a file called
198 bfd29c14 2021-12-01 op <span class="Pa">config-TERM</span>, where “TERM” is the name
199 bfd29c14 2021-12-01 op of the terminal type (i.e. the TERM environment variable), if it exists.</p>
200 bfd29c14 2021-12-01 op <p class="Pp">The format of the configuration file is fairly flexible. The
201 bfd29c14 2021-12-01 op current line can be extended over multiple ones using a backslash
202 bfd29c14 2021-12-01 op (‘\’). Comments can be put anywhere in the file using a hash
203 bfd29c14 2021-12-01 op mark (‘#’), and extend to the end of the current line, but
204 bfd29c14 2021-12-01 op backslashes can't be used to extend comments over multiple lines.</p>
205 bfd29c14 2021-12-01 op <p class="Pp">The following constructs are available:</p>
206 bfd29c14 2021-12-01 op <dl class="Bl-tag">
207 bfd29c14 2021-12-01 op <dt id="bind"><a class="permalink" href="#bind"><code class="Ic">bind</code></a>
208 bfd29c14 2021-12-01 op <var class="Ar">map</var> <var class="Ar">key</var>
209 bfd29c14 2021-12-01 op <var class="Ar">cmd</var></dt>
210 bfd29c14 2021-12-01 op <dd>Bind <var class="Ar">key</var> to the function <var class="Ar">cmd</var>
211 bfd29c14 2021-12-01 op in the keymap <var class="Ar">map</var>. Valid values for map are
212 bfd29c14 2021-12-01 op “global-map” (i.e. when the user is viewing a page) and
213 bfd29c14 2021-12-01 op “minibuffer-map” (i.e. when the minibuffer has the focus.)
214 bfd29c14 2021-12-01 op <var class="Ar">key</var> follows the same syntax described in
215 bfd29c14 2021-12-01 op <a class="Sx" href="#DEFAULT_KEY_BINDINGS">DEFAULT KEY BINDINGS</a> and
216 bfd29c14 2021-12-01 op all the possible functions are listed in
217 bfd29c14 2021-12-01 op <a class="Sx" href="#INTERACTIVE_COMMANDS">INTERACTIVE COMMANDS</a>.</dd>
218 bfd29c14 2021-12-01 op <dt id="proxy"><a class="permalink" href="#proxy"><code class="Ic">proxy</code></a>
219 bfd29c14 2021-12-01 op <var class="Ar">proto</var> <code class="Ic">via</code>
220 bfd29c14 2021-12-01 op <var class="Ar">url</var></dt>
221 bfd29c14 2021-12-01 op <dd>Use <var class="Ar">url</var> as proxy for all URLs with protocol
222 bfd29c14 2021-12-01 op <var class="Ar">proto</var>. <var class="Ar">url</var> must be a Gemini
223 bfd29c14 2021-12-01 op URI without path, query and fragment component.</dd>
224 bfd29c14 2021-12-01 op <dt id="set"><a class="permalink" href="#set"><code class="Ic">set</code></a>
225 bfd29c14 2021-12-01 op <var class="Ar">opt</var> <span class="No">=</span>
226 bfd29c14 2021-12-01 op <var class="Ar">val</var></dt>
227 bfd29c14 2021-12-01 op <dd>Set the option <var class="Ar">opt</var> to the value
228 bfd29c14 2021-12-01 op <var class="Ar">val</var>. Valid options are:
229 bfd29c14 2021-12-01 op <p class="Pp"></p>
230 bfd29c14 2021-12-01 op <dl class="Bl-tag Bl-compact">
231 4b495710 2022-04-13 op <dt id="autosave"><a class="permalink" href="#autosave"><code class="Ic">autosave</code></a></dt>
232 bfd29c14 2021-12-01 op <dd>(integer) If greater than zero, save the session after the specified
233 bfd29c14 2021-12-01 op amount of seconds after some events happens (new or closed tabs,
234 bfd29c14 2021-12-01 op visited a link ...) Defaults to 20.</dd>
235 4b495710 2022-04-13 op <dt id="dont-wrap-pre"><a class="permalink" href="#dont-wrap-pre"><code class="Ic">dont-wrap-pre</code></a></dt>
236 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, don't wrap preformatted blocks. Defaults to
238 4b495710 2022-04-13 op <dt id="download-path"><a class="permalink" href="#download-path"><code class="Ic">download-path</code></a></dt>
239 bfd29c14 2021-12-01 op <dd>(string) The default download path. Defaults to
240 bfd29c14 2021-12-01 op <span class="Pa">/tmp</span>.</dd>
241 4b495710 2022-04-13 op <dt id="emojify-link"><a class="permalink" href="#emojify-link"><code class="Ic">emojify-link</code></a></dt>
242 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, when the text of a link starts with an emoji
243 bfd29c14 2021-12-01 op followed by a space, use that emoji as line prefix. Defaults to
245 4b495710 2022-04-13 op <dt id="enable-colors"><a class="permalink" href="#enable-colors"><code class="Ic">enable-colors</code></a></dt>
246 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, enable colours. Defaults to 0 if
247 bfd29c14 2021-12-01 op <code class="Ev">NO_COLORS</code> is set, 1 otherwise.</dd>
248 4b495710 2022-04-13 op <dt id="fill-column"><a class="permalink" href="#fill-column"><code class="Ic">fill-column</code></a></dt>
249 bfd29c14 2021-12-01 op <dd>(integer) If greater than zero, lines of text will be formatted in a
250 bfd29c14 2021-12-01 op way that don't exceed the given number of columns. Defaults to
252 4b495710 2022-04-13 op <dt id="fringe-ignore-offset"><a class="permalink" href="#fringe-ignore-offset"><code class="Ic">fringe-ignore-offset</code></a></dt>
253 d9bfe90a 2022-01-13 op <dd>(integer) If nonzero, the fringe doesn't obey to
254 d9bfe90a 2022-01-13 op <code class="Ic">olivetti-mode</code>. Defaults to 1.</dd>
255 4b495710 2022-04-13 op <dt id="hide-pre-blocks"><a class="permalink" href="#hide-pre-blocks"><code class="Ic">hide-pre-blocks</code></a></dt>
256 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, hide by default the body of the preformatted
257 bfd29c14 2021-12-01 op blocks. Defaults to zero. <code class="Ic">push-button</code> can be
258 bfd29c14 2021-12-01 op used to toggle the visibility per-block.</dd>
259 4b495710 2022-04-13 op <dt id="hide-pre-closing-line"><a class="permalink" href="#hide-pre-closing-line"><code class="Ic">hide-pre-closing-line</code></a></dt>
260 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, hide the closing line of preformatted blocks.
261 bfd29c14 2021-12-01 op Defaults to 0.</dd>
262 4b495710 2022-04-13 op <dt id="hide-pre-context"><a class="permalink" href="#hide-pre-context"><code class="Ic">hide-pre-context</code></a></dt>
263 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, hide the start and end line of the preformatted
264 bfd29c14 2021-12-01 op blocks. If both hide-pre-context and hide-pre-blocks are nonzero,
265 bfd29c14 2021-12-01 op preformatted blocks are irremediably hidden. Defaults to zero.</dd>
266 4b495710 2022-04-13 op <dt id="new-tab-url"><a class="permalink" href="#new-tab-url"><code class="Ic">new-tab-url</code></a></dt>
267 bfd29c14 2021-12-01 op <dd>(string) URL for the new tab page. Defaults to
268 bfd29c14 2021-12-01 op “about:new”.</dd>
269 4b495710 2022-04-13 op <dt id="max-killed-tabs"><a class="permalink" href="#max-killed-tabs"><code class="Ic">max-killed-tabs</code></a></dt>
270 d9bfe90a 2022-01-13 op <dd>(integer) The maximum number of closed tabs to keep track of, defaults
271 d9bfe90a 2022-01-13 op to 10. Must be a positive number; if zero, don't save closed tabs at
273 4b495710 2022-04-13 op <dt id="olivetti-mode"><a class="permalink" href="#olivetti-mode"><code class="Ic">olivetti-mode</code></a></dt>
274 bfd29c14 2021-12-01 op <dd>(integer) If nonzero, enable <code class="Ic">olivetti-mode</code>
275 bfd29c14 2021-12-01 op Defaults to 1.</dd>
276 4b495710 2022-04-13 op <dt id="tab-bar-show"><a class="permalink" href="#tab-bar-show"><code class="Ic">tab-bar-show</code></a></dt>
277 bfd29c14 2021-12-01 op <dd>(integer) If tab-bar-show is -1 hide the tab bar permanently, if 0
278 bfd29c14 2021-12-01 op show it unconditionally. If it's 1, show the bar only when there is
279 bfd29c14 2021-12-01 op more than one tab. Defaults to 1.</dd>
280 4b495710 2022-04-13 op <dt id="update-title"><a class="permalink" href="#update-title"><code class="Ic">update-title</code></a></dt>
281 d9bfe90a 2022-01-13 op <dd>(integer) If nonzero, set the terminal title to the page title.
282 d9bfe90a 2022-01-13 op Defaults to 1.</dd>
285 bfd29c14 2021-12-01 op <dt id="style"><a class="permalink" href="#style"><code class="Ic">style</code></a>
286 bfd29c14 2021-12-01 op <var class="Ar">name</var> <var class="Ar">option</var></dt>
287 bfd29c14 2021-12-01 op <dd>Change the styling of the element identified by
288 bfd29c14 2021-12-01 op <var class="Ar">name</var>. Multiple options may be specified within curly
289 bfd29c14 2021-12-01 op braces. Valid style identifiers are:
290 bfd29c14 2021-12-01 op <div class="Bd-indent">
291 bfd29c14 2021-12-01 op <dl class="Bl-tag Bl-compact">
292 bfd29c14 2021-12-01 op <dt>line</dt>
293 bfd29c14 2021-12-01 op <dd>the area outside the lines in the body of the page.</dd>
294 bfd29c14 2021-12-01 op <dt>line.compl</dt>
295 bfd29c14 2021-12-01 op <dd>the completions.</dd>
296 bfd29c14 2021-12-01 op <dt>line.compl.current</dt>
297 bfd29c14 2021-12-01 op <dd>the current completion.</dd>
298 bfd29c14 2021-12-01 op <dt>line.help</dt>
299 bfd29c14 2021-12-01 op <dd>text in the *Help* buffer.</dd>
300 bfd29c14 2021-12-01 op <dt>line.download.ongoing</dt>
301 bfd29c14 2021-12-01 op <dd>an ongoing download</dd>
302 bfd29c14 2021-12-01 op <dt>line.download.done</dt>
303 bfd29c14 2021-12-01 op <dd>a completed download</dd>
304 bfd29c14 2021-12-01 op <dt>line.download.info</dt>
305 bfd29c14 2021-12-01 op <dd>informational text in the *Downloads* buffer.</dd>
306 d9bfe90a 2022-01-13 op <dt>line.fringe</dt>
307 d9bfe90a 2022-01-13 op <dd>(virtual) lines draw after the end of a buffer.</dd>
308 bfd29c14 2021-12-01 op <dt>line.text</dt>
309 bfd29c14 2021-12-01 op <dd>text lines.</dd>
310 bfd29c14 2021-12-01 op <dt>line.link</dt>
311 bfd29c14 2021-12-01 op <dd>link lines.</dd>
312 bfd29c14 2021-12-01 op <dt>line.title1..3</dt>
313 bfd29c14 2021-12-01 op <dd>headings</dd>
314 bfd29c14 2021-12-01 op <dt>line.item</dt>
315 bfd29c14 2021-12-01 op <dd>item lines.</dd>
316 bfd29c14 2021-12-01 op <dt>line.quote</dt>
317 bfd29c14 2021-12-01 op <dd>quotes.</dd>
318 bfd29c14 2021-12-01 op <dt>line.pre.start</dt>
319 bfd29c14 2021-12-01 op <dd>the heading of a preformatted block.</dd>
320 bfd29c14 2021-12-01 op <dt>line.pre</dt>
321 bfd29c14 2021-12-01 op <dd>the content of a preformatted block.</dd>
322 bfd29c14 2021-12-01 op <dt>line.pre.end</dt>
323 bfd29c14 2021-12-01 op <dd>the closing line of a preformatted block.</dd>
324 bfd29c14 2021-12-01 op <dt>download</dt>
325 bfd29c14 2021-12-01 op <dd>the download pane</dd>
326 bfd29c14 2021-12-01 op <dt>minibuffer</dt>
327 bfd29c14 2021-12-01 op <dd>the minibuffer.</dd>
328 bfd29c14 2021-12-01 op <dt>modeline</dt>
329 bfd29c14 2021-12-01 op <dd>the modeline.</dd>
330 bfd29c14 2021-12-01 op <dt>tabline</dt>
331 bfd29c14 2021-12-01 op <dd>the tabline.</dd>
332 bfd29c14 2021-12-01 op <dt>tabline.tab</dt>
333 bfd29c14 2021-12-01 op <dd>the non-focused tabs.</dd>
334 bfd29c14 2021-12-01 op <dt>tabline.current</dt>
335 bfd29c14 2021-12-01 op <dd>the focused tab.</dd>
338 bfd29c14 2021-12-01 op <p class="Pp">Valid options are:</p>
339 bfd29c14 2021-12-01 op <dl class="Bl-tag">
340 bfd29c14 2021-12-01 op <dt id="attr"><a class="permalink" href="#attr"><code class="Ic">attr</code></a>
341 bfd29c14 2021-12-01 op <var class="Ar">prefix</var> [<var class="Ar">line</var>
342 bfd29c14 2021-12-01 op [<var class="Ar">trail</var>]]</dt>
343 bfd29c14 2021-12-01 op <dd>Sets the text attributes. If only one value is given,
344 bfd29c14 2021-12-01 op <var class="Ar">line</var> and <var class="Ar">trail</var> default to
345 bfd29c14 2021-12-01 op that; if two values are given then <var class="Ar">trail</var>
346 bfd29c14 2021-12-01 op defaults to <var class="Ar">prefix</var>. Each attribute is a
347 bfd29c14 2021-12-01 op comma-separated list of keywords:
348 bfd29c14 2021-12-01 op <div class="Bd-indent">
349 bfd29c14 2021-12-01 op <dl class="Bl-tag Bl-compact">
350 bfd29c14 2021-12-01 op <dt id="normal"><a class="permalink" href="#normal"><code class="Ic">normal</code></a></dt>
351 bfd29c14 2021-12-01 op <dd>no attributes.</dd>
352 bfd29c14 2021-12-01 op <dt id="standout"><a class="permalink" href="#standout"><code class="Ic">standout</code></a></dt>
353 bfd29c14 2021-12-01 op <dd>best highlighting mode for the terminal.</dd>
354 bfd29c14 2021-12-01 op <dt id="underline"><a class="permalink" href="#underline"><code class="Ic">underline</code></a></dt>
355 bfd29c14 2021-12-01 op <dd>underlines the text.</dd>
356 bfd29c14 2021-12-01 op <dt id="reverse"><a class="permalink" href="#reverse"><code class="Ic">reverse</code></a></dt>
357 bfd29c14 2021-12-01 op <dd>reverses background/foreground colors.</dd>
358 bfd29c14 2021-12-01 op <dt id="blink"><a class="permalink" href="#blink"><code class="Ic">blink</code></a></dt>
359 bfd29c14 2021-12-01 op <dd>makes the text blinking.</dd>
360 bfd29c14 2021-12-01 op <dt id="dim"><a class="permalink" href="#dim"><code class="Ic">dim</code></a></dt>
361 bfd29c14 2021-12-01 op <dd>half bright.</dd>
362 bfd29c14 2021-12-01 op <dt id="bold"><a class="permalink" href="#bold"><code class="Ic">bold</code></a></dt>
363 bfd29c14 2021-12-01 op <dd>extra bright or bold.</dd>
366 bfd29c14 2021-12-01 op <p class="Pp">Only the style identifiers with the “line.”
367 bfd29c14 2021-12-01 op prefix accept up to three attributes. The other will only use the
368 bfd29c14 2021-12-01 op first one given.</p>
370 bfd29c14 2021-12-01 op <dt id="bg"><a class="permalink" href="#bg"><code class="Ic">bg</code></a>
371 bfd29c14 2021-12-01 op <var class="Ar">prefix</var> [<var class="Ar">line</var>
372 bfd29c14 2021-12-01 op [<var class="Ar">trail</var>]]</dt>
373 bfd29c14 2021-12-01 op <dd>Sets the background color. Follows the same behaviour as
374 bfd29c14 2021-12-01 op <code class="Ic">attr</code> regarding the optional parameters. The
375 bfd29c14 2021-12-01 op colour is one of black, red, green, yellow, blue, magenta, cyan and
376 bfd29c14 2021-12-01 op white; colour0 to colour255 (or color0 to color255) from the
377 bfd29c14 2021-12-01 op 256-colour set; default for the default colour.</dd>
378 bfd29c14 2021-12-01 op <dt id="fg"><a class="permalink" href="#fg"><code class="Ic">fg</code></a>
379 bfd29c14 2021-12-01 op <var class="Ar">prefix</var> [<var class="Ar">line</var>
380 bfd29c14 2021-12-01 op [<var class="Ar">trail</var>]]</dt>
381 bfd29c14 2021-12-01 op <dd>Sets the foreground color. It behaves just like
382 bfd29c14 2021-12-01 op <code class="Ic">bg</code>.</dd>
383 bfd29c14 2021-12-01 op <dt id="prefix"><a class="permalink" href="#prefix"><code class="Ic">prefix</code></a>
384 bfd29c14 2021-12-01 op <var class="Ar">prfx</var> [<var class="Ar">cont</var>]</dt>
385 bfd29c14 2021-12-01 op <dd>Sets the prefix for the current line type to
386 bfd29c14 2021-12-01 op <var class="Ar">prfx</var> and <var class="Ar">cont</var> as the
387 bfd29c14 2021-12-01 op prefix for the continuation lines (i.e. when a long line gets
388 bfd29c14 2021-12-01 op wrapped.) If <var class="Ar">cont</var> is not given its value will be
389 bfd29c14 2021-12-01 op the same of <var class="Ar">prfx</var>.</dd>
394 cc9bf8f2 2021-11-05 op <section class="Sh">
395 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="DEFAULT_KEY_BINDINGS"><a class="permalink" href="#DEFAULT_KEY_BINDINGS">DEFAULT
396 cc9bf8f2 2021-11-05 op KEY BINDINGS</a></h1>
397 cc9bf8f2 2021-11-05 op <p class="Pp">The default key bindings are very similar to GNU Emacs, but care
398 cc9bf8f2 2021-11-05 op has been taken to include also bindings familiar for <a class="Xr">vi(1)</a>
399 cc9bf8f2 2021-11-05 op and “CUA” users. In the following examples, C-x means
400 cc9bf8f2 2021-11-05 op Control-x, M-x means Meta-x, where the Meta key may be either a special key
401 cc9bf8f2 2021-11-05 op on the keyboard or the ALT key; otherwise ESC followed by the key X works as
402 cc9bf8f2 2021-11-05 op well, and C-M-x means to press the key X together with both Control and
404 cc9bf8f2 2021-11-05 op <p class="Pp">Keys are usually a single character, like ‘p’ or
405 cc9bf8f2 2021-11-05 op ‘n’, but some special keys are accepted as well.</p>
406 cc9bf8f2 2021-11-05 op <p class="Pp"></p>
407 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
408 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
409 cc9bf8f2 2021-11-05 op <dt><up></dt>
410 cc9bf8f2 2021-11-05 op <dd>Up arrow</dd>
411 cc9bf8f2 2021-11-05 op <dt><down></dt>
412 cc9bf8f2 2021-11-05 op <dd>Down arrow</dd>
413 cc9bf8f2 2021-11-05 op <dt><left></dt>
414 cc9bf8f2 2021-11-05 op <dd>Left arrow</dd>
415 cc9bf8f2 2021-11-05 op <dt><right></dt>
416 cc9bf8f2 2021-11-05 op <dd>Right arrow</dd>
417 cc9bf8f2 2021-11-05 op <dt><prior></dt>
418 cc9bf8f2 2021-11-05 op <dd>Previous page/Page up</dd>
419 cc9bf8f2 2021-11-05 op <dt><next></dt>
420 cc9bf8f2 2021-11-05 op <dd>Next page/Page down</dd>
421 cc9bf8f2 2021-11-05 op <dt><home></dt>
422 cc9bf8f2 2021-11-05 op <dd>Home</dd>
423 cc9bf8f2 2021-11-05 op <dt><end></dt>
425 cc9bf8f2 2021-11-05 op <dt><f0> thru <f63></dt>
426 cc9bf8f2 2021-11-05 op <dd>Function keys</dd>
427 cc9bf8f2 2021-11-05 op <dt>del or backspace</dt>
428 cc9bf8f2 2021-11-05 op <dd>Backspace</dd>
430 cc9bf8f2 2021-11-05 op <dd>Escape</dd>
431 cc9bf8f2 2021-11-05 op <dt>space or spc</dt>
432 cc9bf8f2 2021-11-05 op <dd>Space</dd>
433 cc9bf8f2 2021-11-05 op <dt>enter or ret</dt>
434 cc9bf8f2 2021-11-05 op <dd>Enter</dd>
437 cc9bf8f2 2021-11-05 op <dt>backtab</dt>
438 cc9bf8f2 2021-11-05 op <dd>Depends on the configuration of the terminal emulator; usually shift
442 cc9bf8f2 2021-11-05 op <section class="Ss">
443 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="GNU_Emacs-like_keys"><a class="permalink" href="#GNU_Emacs-like_keys">GNU
444 cc9bf8f2 2021-11-05 op Emacs-like keys</a></h2>
445 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
446 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
448 cc9bf8f2 2021-11-05 op <dd>previous-line</dd>
450 cc9bf8f2 2021-11-05 op <dd>next-line</dd>
452 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
454 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
456 cc9bf8f2 2021-11-05 op <dd>backward-paragraph</dd>
458 cc9bf8f2 2021-11-05 op <dd>forward-paragraph</dd>
460 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
462 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
463 cc9bf8f2 2021-11-05 op <dt>M-v, M-space</dt>
464 cc9bf8f2 2021-11-05 op <dd>scroll-up</dd>
465 cc9bf8f2 2021-11-05 op <dt>C-v, space</dt>
466 cc9bf8f2 2021-11-05 op <dd>scroll-down</dd>
467 cc9bf8f2 2021-11-05 op <dt>M-<</dt>
468 cc9bf8f2 2021-11-05 op <dd>beginning-of-buffer</dd>
469 cc9bf8f2 2021-11-05 op <dt>M-></dt>
470 cc9bf8f2 2021-11-05 op <dd>end-of-buffer</dd>
471 cc9bf8f2 2021-11-05 op <dt>C-x C-c</dt>
472 cc9bf8f2 2021-11-05 op <dd>kill-telescope</dd>
474 cc9bf8f2 2021-11-05 op <dd>clear-minibuf</dd>
476 cc9bf8f2 2021-11-05 op <dd>execute-extended-command</dd>
477 cc9bf8f2 2021-11-05 op <dt>C-c {</dt>
478 cc9bf8f2 2021-11-05 op <dd>dec-fill-column</dd>
479 cc9bf8f2 2021-11-05 op <dt>C-c }</dt>
480 cc9bf8f2 2021-11-05 op <dd>inc-fill-column</dd>
481 cc9bf8f2 2021-11-05 op <dt>C-c p</dt>
482 cc9bf8f2 2021-11-05 op <dd>previous-heading</dd>
483 cc9bf8f2 2021-11-05 op <dt>C-c n</dt>
484 cc9bf8f2 2021-11-05 op <dd>next-heading</dd>
485 cc9bf8f2 2021-11-05 op <dt>></dt>
486 cc9bf8f2 2021-11-05 op <dd>load-url</dd>
487 cc9bf8f2 2021-11-05 op <dt><</dt>
488 cc9bf8f2 2021-11-05 op <dd>load-current-url</dd>
489 cc9bf8f2 2021-11-05 op <dt>C-x C-f</dt>
490 cc9bf8f2 2021-11-05 op <dd>load-url</dd>
491 cc9bf8f2 2021-11-05 op <dt>C-x M-f</dt>
492 cc9bf8f2 2021-11-05 op <dd>load-current-url</dd>
493 cc9bf8f2 2021-11-05 op <dt>C-x o</dt>
494 cc9bf8f2 2021-11-05 op <dd>other-window</dd>
495 cc9bf8f2 2021-11-05 op <dt>C-x t 0</dt>
496 cc9bf8f2 2021-11-05 op <dd>tab-close</dd>
497 cc9bf8f2 2021-11-05 op <dt>C-x t 1</dt>
498 cc9bf8f2 2021-11-05 op <dd>tab-close-other</dd>
499 cc9bf8f2 2021-11-05 op <dt>C-x t 2</dt>
500 cc9bf8f2 2021-11-05 op <dd>tab-new</dd>
501 cc9bf8f2 2021-11-05 op <dt>C-x t o</dt>
502 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
503 cc9bf8f2 2021-11-05 op <dt>C-x t O</dt>
504 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
505 cc9bf8f2 2021-11-05 op <dt>C-x t m</dt>
506 cc9bf8f2 2021-11-05 op <dd>tab-move</dd>
507 cc9bf8f2 2021-11-05 op <dt>C-x t M</dt>
508 cc9bf8f2 2021-11-05 op <dd>tab-move-to</dd>
509 cc9bf8f2 2021-11-05 op <dt>B, C-M-b</dt>
510 cc9bf8f2 2021-11-05 op <dd>previous-page</dd>
511 cc9bf8f2 2021-11-05 op <dt>F, C-M-f</dt>
512 cc9bf8f2 2021-11-05 op <dd>next-page</dd>
513 cc9bf8f2 2021-11-05 op <dt><f7> a</dt>
514 cc9bf8f2 2021-11-05 op <dd>bookmark-page</dd>
515 cc9bf8f2 2021-11-05 op <dt><f7> <f7></dt>
516 cc9bf8f2 2021-11-05 op <dd>list-bookmarks</dd>
518 cc9bf8f2 2021-11-05 op <dd>suspend-telescope</dd>
522 cc9bf8f2 2021-11-05 op <section class="Ss">
523 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
524 cc9bf8f2 2021-11-05 op keys</a></h2>
525 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
526 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
528 cc9bf8f2 2021-11-05 op <dd>previous-line</dd>
530 cc9bf8f2 2021-11-05 op <dd>next-line</dd>
532 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
534 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
536 cc9bf8f2 2021-11-05 op <dd>backward-paragraph</dd>
538 cc9bf8f2 2021-11-05 op <dd>forward-paragraph</dd>
540 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
542 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
544 cc9bf8f2 2021-11-05 op <dd>scroll-line-up</dd>
546 cc9bf8f2 2021-11-05 op <dd>scroll-line-down</dd>
548 cc9bf8f2 2021-11-05 op <dd>beginning-of-buffer</dd>
550 cc9bf8f2 2021-11-05 op <dd>end-of-buffer</dd>
552 cc9bf8f2 2021-11-05 op <dd>tab-close</dd>
554 cc9bf8f2 2021-11-05 op <dd>tab-new</dd>
556 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
558 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
559 cc9bf8f2 2021-11-05 op <dt>g M-t</dt>
560 cc9bf8f2 2021-11-05 op <dd>tab-move</dd>
561 cc9bf8f2 2021-11-05 op <dt>g M-T</dt>
562 cc9bf8f2 2021-11-05 op <dd>tab-move-to</dd>
564 cc9bf8f2 2021-11-05 op <dd>previous-page</dd>
566 cc9bf8f2 2021-11-05 op <dd>next-page</dd>
568 d9bfe90a 2022-01-13 op <dd>tab-undo-close</dd>
570 cc9bf8f2 2021-11-05 op <dd>kill-telescope</dd>
572 cc9bf8f2 2021-11-05 op <dd>clear-minibuf</dd>
574 cc9bf8f2 2021-11-05 op <dd>execute-extended-command</dd>
578 cc9bf8f2 2021-11-05 op <section class="Ss">
579 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="CUA-like_keys"><a class="permalink" href="#CUA-like_keys">CUA-like
580 cc9bf8f2 2021-11-05 op keys</a></h2>
581 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
582 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
583 cc9bf8f2 2021-11-05 op <dt><up></dt>
584 cc9bf8f2 2021-11-05 op <dd>previous-line</dd>
585 cc9bf8f2 2021-11-05 op <dt><down></dt>
586 cc9bf8f2 2021-11-05 op <dd>next-line</dd>
587 cc9bf8f2 2021-11-05 op <dt><right></dt>
588 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
589 cc9bf8f2 2021-11-05 op <dt><left></dt>
590 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
591 cc9bf8f2 2021-11-05 op <dt><home></dt>
592 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
593 cc9bf8f2 2021-11-05 op <dt><end></dt>
594 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
595 cc9bf8f2 2021-11-05 op <dt><prior></dt>
596 cc9bf8f2 2021-11-05 op <dd>scroll-up</dd>
597 cc9bf8f2 2021-11-05 op <dt><next></dt>
598 cc9bf8f2 2021-11-05 op <dd>scroll-down</dd>
600 cc9bf8f2 2021-11-05 op <dd>tab-close</dd>
602 cc9bf8f2 2021-11-05 op <dd>tab-new</dd>
603 cc9bf8f2 2021-11-05 op <dt>M-<prior></dt>
604 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
605 cc9bf8f2 2021-11-05 op <dt>M-<next></dt>
606 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
608 d9bfe90a 2022-01-13 op <dd>previous-page</dd>
609 cc9bf8f2 2021-11-05 op <dt>M-<left></dt>
610 cc9bf8f2 2021-11-05 op <dd>previous-page</dd>
611 cc9bf8f2 2021-11-05 op <dt>M-<right></dt>
612 cc9bf8f2 2021-11-05 op <dd>next-page</dd>
613 cc9bf8f2 2021-11-05 op <dt><f5></dt>
614 cc9bf8f2 2021-11-05 op <dd>reload-page</dd>
616 cc9bf8f2 2021-11-05 op <dd>reload-page</dd>
620 cc9bf8f2 2021-11-05 op <section class="Ss">
621 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Neither_Emacs_nor_vi_specific"><a class="permalink" href="#Neither_Emacs_nor_vi_specific">Neither
622 cc9bf8f2 2021-11-05 op Emacs nor vi specific</a></h2>
623 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
624 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
625 cc9bf8f2 2021-11-05 op <dt><f1></dt>
626 cc9bf8f2 2021-11-05 op <dd>toggle-help</dd>
627 cc9bf8f2 2021-11-05 op <dt>enter</dt>
628 cc9bf8f2 2021-11-05 op <dd>push-button</dd>
629 cc9bf8f2 2021-11-05 op <dt>M-enter</dt>
630 cc9bf8f2 2021-11-05 op <dd>push-button-new-tab</dd>
631 cc9bf8f2 2021-11-05 op <dt>M-tab</dt>
632 cc9bf8f2 2021-11-05 op <dd>previous-button</dd>
633 cc9bf8f2 2021-11-05 op <dt>backtab</dt>
634 cc9bf8f2 2021-11-05 op <dd>previous-button</dd>
636 cc9bf8f2 2021-11-05 op <dd>next-button</dd>
638 cc9bf8f2 2021-11-05 op <dd>tab-select</dd>
640 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
642 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
644 cc9bf8f2 2021-11-05 op <dd>tab-move-to</dd>
646 cc9bf8f2 2021-11-05 op <dd>tab-move</dd>
648 cc9bf8f2 2021-11-05 op <dd>link-select</dd>
650 cc9bf8f2 2021-11-05 op <dd>swiper</dd>
652 4b495710 2022-04-13 op <dd>reply-last-input</dd>
656 cc9bf8f2 2021-11-05 op <section class="Ss">
657 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Minibuffer-specific_keys"><a class="permalink" href="#Minibuffer-specific_keys">Minibuffer-specific
658 cc9bf8f2 2021-11-05 op keys</a></h2>
659 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
660 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
661 cc9bf8f2 2021-11-05 op <dt>enter</dt>
662 cc9bf8f2 2021-11-05 op <dd>mini-complete-and-exit</dd>
664 cc9bf8f2 2021-11-05 op <dd>mini-abort</dd>
666 cc9bf8f2 2021-11-05 op <dd>mini-abort</dd>
668 cc9bf8f2 2021-11-05 op <dd>mini-delete-char</dd>
670 cc9bf8f2 2021-11-05 op <dd>mini-delete-backward-char</dd>
671 cc9bf8f2 2021-11-05 op <dt>backspace</dt>
672 cc9bf8f2 2021-11-05 op <dd>mini-delete-backward-char</dd>
674 cc9bf8f2 2021-11-05 op <dd>mini-delete-backward-char</dd>
676 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
678 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
679 cc9bf8f2 2021-11-05 op <dt><left></dt>
680 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
681 cc9bf8f2 2021-11-05 op <dt><right></dt>
682 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
684 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
686 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
687 cc9bf8f2 2021-11-05 op <dt><end></dt>
688 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
689 cc9bf8f2 2021-11-05 op <dt><home></dt>
690 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
692 cc9bf8f2 2021-11-05 op <dd>mini-kill-line</dd>
694 cc9bf8f2 2021-11-05 op <dd>mini-previous-history-element</dd>
696 cc9bf8f2 2021-11-05 op <dd>mini-next-history-element</dd>
698 cc9bf8f2 2021-11-05 op <dd>previous-completion</dd>
700 cc9bf8f2 2021-11-05 op <dd>next-completion</dd>
701 cc9bf8f2 2021-11-05 op <dt><up></dt>
702 cc9bf8f2 2021-11-05 op <dd>previous-completion</dd>
703 cc9bf8f2 2021-11-05 op <dt><down></dt>
704 cc9bf8f2 2021-11-05 op <dd>next-completion</dd>
706 cc9bf8f2 2021-11-05 op <dd>insert-current-candidate</dd>
707 cc9bf8f2 2021-11-05 op <dt>M-<</dt>
708 cc9bf8f2 2021-11-05 op <dd>mini-goto-beginning</dd>
709 cc9bf8f2 2021-11-05 op <dt>M-></dt>
710 cc9bf8f2 2021-11-05 op <dd>mini-goto-end</dd>
715 cc9bf8f2 2021-11-05 op <section class="Sh">
716 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="INTERACTIVE_COMMANDS"><a class="permalink" href="#INTERACTIVE_COMMANDS">INTERACTIVE
717 cc9bf8f2 2021-11-05 op COMMANDS</a></h1>
718 cc9bf8f2 2021-11-05 op <p class="Pp">Follows the documentation for the interactive commands. These
719 cc9bf8f2 2021-11-05 op commands can be bound to a key or executed with
720 cc9bf8f2 2021-11-05 op <code class="Ic">execute-extended-command</code>.</p>
721 cc9bf8f2 2021-11-05 op <section class="Ss">
722 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Movement_commands"><a class="permalink" href="#Movement_commands">Movement
723 cc9bf8f2 2021-11-05 op commands</a></h2>
724 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
725 cc9bf8f2 2021-11-05 op <dt id="backward-char"><a class="permalink" href="#backward-char"><code class="Ic">backward-char</code></a></dt>
726 cc9bf8f2 2021-11-05 op <dd>Move point one character backward.</dd>
727 cc9bf8f2 2021-11-05 op <dt id="backward-paragraph"><a class="permalink" href="#backward-paragraph"><code class="Ic">backward-paragraph</code></a></dt>
728 cc9bf8f2 2021-11-05 op <dd>Move point one paragraph backward.</dd>
729 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>
730 cc9bf8f2 2021-11-05 op <dd>Move point to the beginning of the buffer.</dd>
731 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>
732 cc9bf8f2 2021-11-05 op <dd>Move point to the end of the buffer.</dd>
733 cc9bf8f2 2021-11-05 op <dt id="forward-char"><a class="permalink" href="#forward-char"><code class="Ic">forward-char</code></a></dt>
734 cc9bf8f2 2021-11-05 op <dd>Move point one character forward.</dd>
735 cc9bf8f2 2021-11-05 op <dt id="forward-paragraph"><a class="permalink" href="#forward-paragraph"><code class="Ic">forward-paragraph</code></a></dt>
736 cc9bf8f2 2021-11-05 op <dd>Move point one paragraph forward.</dd>
737 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>
738 cc9bf8f2 2021-11-05 op <dd>Copy the current selection text as minibuffer input.</dd>
739 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>
740 cc9bf8f2 2021-11-05 op <dd>Move point at the beginning of the current (visual) line.</dd>
741 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>
742 cc9bf8f2 2021-11-05 op <dd>Move point at the end of the current (visual) line.</dd>
743 cc9bf8f2 2021-11-05 op <dt id="next-button"><a class="permalink" href="#next-button"><code class="Ic">next-button</code></a></dt>
744 cc9bf8f2 2021-11-05 op <dd>Move point to the next link.</dd>
745 cc9bf8f2 2021-11-05 op <dt id="next-completion"><a class="permalink" href="#next-completion"><code class="Ic">next-completion</code></a></dt>
746 cc9bf8f2 2021-11-05 op <dd>Select the next completion.</dd>
747 cc9bf8f2 2021-11-05 op <dt id="next-heading"><a class="permalink" href="#next-heading"><code class="Ic">next-heading</code></a></dt>
748 cc9bf8f2 2021-11-05 op <dd>Move point to the next heading.</dd>
749 cc9bf8f2 2021-11-05 op <dt id="next-line"><a class="permalink" href="#next-line"><code class="Ic">next-line</code></a></dt>
750 cc9bf8f2 2021-11-05 op <dd>Move point to the next (visual) line, in the same column if possible.</dd>
751 cc9bf8f2 2021-11-05 op <dt id="previous-button"><a class="permalink" href="#previous-button"><code class="Ic">previous-button</code></a></dt>
752 cc9bf8f2 2021-11-05 op <dd>Move point to the previous link.</dd>
753 cc9bf8f2 2021-11-05 op <dt id="previous-completion"><a class="permalink" href="#previous-completion"><code class="Ic">previous-completion</code></a></dt>
754 cc9bf8f2 2021-11-05 op <dd>Select the previous completion.</dd>
755 cc9bf8f2 2021-11-05 op <dt id="previous-heading"><a class="permalink" href="#previous-heading"><code class="Ic">previous-heading</code></a></dt>
756 cc9bf8f2 2021-11-05 op <dd>Move point to the previous heading.</dd>
757 cc9bf8f2 2021-11-05 op <dt id="previous-line"><a class="permalink" href="#previous-line"><code class="Ic">previous-line</code></a></dt>
758 cc9bf8f2 2021-11-05 op <dd>Move point to the previous (visual) line.</dd>
761 cc9bf8f2 2021-11-05 op <section class="Ss">
762 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Bookmark-related_commands"><a class="permalink" href="#Bookmark-related_commands">Bookmark-related
763 cc9bf8f2 2021-11-05 op commands</a></h2>
764 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
765 cc9bf8f2 2021-11-05 op <dt id="bookmark-page"><a class="permalink" href="#bookmark-page"><code class="Ic">bookmark-page</code></a></dt>
766 cc9bf8f2 2021-11-05 op <dd>Save a page in the bookmark file. It preloads the minibuffer with the
767 cc9bf8f2 2021-11-05 op current URL.</dd>
768 cc9bf8f2 2021-11-05 op <dt id="list-bookmarks"><a class="permalink" href="#list-bookmarks"><code class="Ic">list-bookmarks</code></a></dt>
769 cc9bf8f2 2021-11-05 op <dd>Load the bookmarks page.</dd>
772 cc9bf8f2 2021-11-05 op <section class="Ss">
773 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Tab-related_commands"><a class="permalink" href="#Tab-related_commands">Tab-related
774 cc9bf8f2 2021-11-05 op commands</a></h2>
775 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
776 cc9bf8f2 2021-11-05 op <dt id="tab-close"><a class="permalink" href="#tab-close"><code class="Ic">tab-close</code></a></dt>
777 cc9bf8f2 2021-11-05 op <dd>Close the current tab.</dd>
778 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>
779 cc9bf8f2 2021-11-05 op <dd>Close all tabs but the current one.</dd>
780 cc9bf8f2 2021-11-05 op <dt id="tab-move"><a class="permalink" href="#tab-move"><code class="Ic">tab-move</code></a></dt>
781 cc9bf8f2 2021-11-05 op <dd>Move the current tab after the next one, wrapping around if needed.</dd>
782 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>
783 cc9bf8f2 2021-11-05 op <dd>Move the current tab before the previous one, wrapping around if
785 cc9bf8f2 2021-11-05 op <dt id="tab-new"><a class="permalink" href="#tab-new"><code class="Ic">tab-new</code></a></dt>
786 cc9bf8f2 2021-11-05 op <dd>Open a new tab.</dd>
787 cc9bf8f2 2021-11-05 op <dt id="tab-next"><a class="permalink" href="#tab-next"><code class="Ic">tab-next</code></a></dt>
788 cc9bf8f2 2021-11-05 op <dd>Focus next tab, wrapping around eventually.</dd>
789 cc9bf8f2 2021-11-05 op <dt id="tab-previous"><a class="permalink" href="#tab-previous"><code class="Ic">tab-previous</code></a></dt>
790 cc9bf8f2 2021-11-05 op <dd>Focus the previous tab, wrapping around eventually.</dd>
791 cc9bf8f2 2021-11-05 op <dt id="tab-select"><a class="permalink" href="#tab-select"><code class="Ic">tab-select</code></a></dt>
792 cc9bf8f2 2021-11-05 op <dd>Switch to a tab using the minibuffer.</dd>
793 d9bfe90a 2022-01-13 op <dt id="tab-undo-close"><a class="permalink" href="#tab-undo-close"><code class="Ic">tab-undo-close</code></a></dt>
794 d9bfe90a 2022-01-13 op <dd>Re-open the most recently closed tab, if any.</dd>
797 cc9bf8f2 2021-11-05 op <section class="Ss">
798 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Misc_commands"><a class="permalink" href="#Misc_commands">Misc
799 cc9bf8f2 2021-11-05 op commands</a></h2>
800 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
801 d9bfe90a 2022-01-13 op <dt id="cache-info"><a class="permalink" href="#cache-info"><code class="Ic">cache-info</code></a></dt>
802 d9bfe90a 2022-01-13 op <dd>Show cache stats.</dd>
803 cc9bf8f2 2021-11-05 op <dt id="clear-minibuf"><a class="permalink" href="#clear-minibuf"><code class="Ic">clear-minibuf</code></a></dt>
804 cc9bf8f2 2021-11-05 op <dd>Clear the echo area.</dd>
805 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>
806 cc9bf8f2 2021-11-05 op <dd>Decrement fill-column by two.</dd>
807 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>
808 cc9bf8f2 2021-11-05 op <dd>Execute an internal command.</dd>
809 cc9bf8f2 2021-11-05 op <dt id="kill-telescope"><a class="permalink" href="#kill-telescope"><code class="Ic">kill-telescope</code></a></dt>
810 cc9bf8f2 2021-11-05 op <dd>Quit <code class="Nm">telescope</code>.</dd>
811 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>
812 cc9bf8f2 2021-11-05 op <dd>Increment fill-column by two.</dd>
813 cc9bf8f2 2021-11-05 op <dt id="link-select"><a class="permalink" href="#link-select"><code class="Ic">link-select</code></a></dt>
814 cc9bf8f2 2021-11-05 op <dd>Select and visit a link using the minibuffer.</dd>
815 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>
816 cc9bf8f2 2021-11-05 op <dd>Edit the current URL.</dd>
817 cc9bf8f2 2021-11-05 op <dt id="load-url"><a class="permalink" href="#load-url"><code class="Ic">load-url</code></a></dt>
818 cc9bf8f2 2021-11-05 op <dd>Prompt for an URL.</dd>
819 cc9bf8f2 2021-11-05 op <dt id="next-page"><a class="permalink" href="#next-page"><code class="Ic">next-page</code></a></dt>
820 cc9bf8f2 2021-11-05 op <dd>Go forward in the page history.</dd>
821 4b495710 2022-04-13 op <dt id="olivetti-mode~2"><a class="permalink" href="#olivetti-mode~2"><code class="Ic">olivetti-mode</code></a></dt>
822 cc9bf8f2 2021-11-05 op <dd>Toggle olivetti mode (i.e. horizontal centering of the lines of the
823 cc9bf8f2 2021-11-05 op window.)</dd>
824 cc9bf8f2 2021-11-05 op <dt id="other-window"><a class="permalink" href="#other-window"><code class="Ic">other-window</code></a></dt>
825 cc9bf8f2 2021-11-05 op <dd>Select the other window.</dd>
826 cc9bf8f2 2021-11-05 op <dt id="previous-page"><a class="permalink" href="#previous-page"><code class="Ic">previous-page</code></a></dt>
827 cc9bf8f2 2021-11-05 op <dd>Go backward in the page history.</dd>
828 cc9bf8f2 2021-11-05 op <dt id="push-button"><a class="permalink" href="#push-button"><code class="Ic">push-button</code></a></dt>
829 cc9bf8f2 2021-11-05 op <dd>Follow link at point, or toggle the visibility of the following
830 cc9bf8f2 2021-11-05 op preformatted block if called when the cursor is on the heading of the
832 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>
833 cc9bf8f2 2021-11-05 op <dd>Follow link at point in a new tab.</dd>
834 cc9bf8f2 2021-11-05 op <dt id="redraw"><a class="permalink" href="#redraw"><code class="Ic">redraw</code></a></dt>
835 cc9bf8f2 2021-11-05 op <dd>Redraw the screen, useful if some background program messed up the
836 cc9bf8f2 2021-11-05 op display.</dd>
837 cc9bf8f2 2021-11-05 op <dt id="reload-page"><a class="permalink" href="#reload-page"><code class="Ic">reload-page</code></a></dt>
838 cc9bf8f2 2021-11-05 op <dd>Reload the current page.</dd>
839 4b495710 2022-04-13 op <dt id="reply-last-input"><a class="permalink" href="#reply-last-input"><code class="Ic">reply-last-input</code></a></dt>
840 4b495710 2022-04-13 op <dd>Reply the last input request.</dd>
841 cc9bf8f2 2021-11-05 op <dt id="scroll-down"><a class="permalink" href="#scroll-down"><code class="Ic">scroll-down</code></a></dt>
842 cc9bf8f2 2021-11-05 op <dd>Scroll down by one visual page.</dd>
843 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>
844 cc9bf8f2 2021-11-05 op <dd>Scroll down by one line.</dd>
845 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>
846 cc9bf8f2 2021-11-05 op <dd>Scroll up by one line.</dd>
847 cc9bf8f2 2021-11-05 op <dt id="scroll-up"><a class="permalink" href="#scroll-up"><code class="Ic">scroll-up</code></a></dt>
848 cc9bf8f2 2021-11-05 op <dd>Scroll up by one visual page.</dd>
849 cc9bf8f2 2021-11-05 op <dt id="suspend-telescope"><a class="permalink" href="#suspend-telescope"><code class="Ic">suspend-telescope</code></a></dt>
850 cc9bf8f2 2021-11-05 op <dd>Suspend the current <code class="Nm">telescope</code> session.</dd>
851 cc9bf8f2 2021-11-05 op <dt id="swiper"><a class="permalink" href="#swiper"><code class="Ic">swiper</code></a></dt>
852 cc9bf8f2 2021-11-05 op <dd>Jump to a line using the minibuffer.</dd>
853 cc9bf8f2 2021-11-05 op <dt id="toc"><a class="permalink" href="#toc"><code class="Ic">toc</code></a></dt>
854 cc9bf8f2 2021-11-05 op <dd>Jump to a heading using the minibuffer.</dd>
855 cc9bf8f2 2021-11-05 op <dt id="toggle-help"><a class="permalink" href="#toggle-help"><code class="Ic">toggle-help</code></a></dt>
856 cc9bf8f2 2021-11-05 op <dd>Toggle side window with help about available keys and their associated
857 cc9bf8f2 2021-11-05 op interactive command.</dd>
858 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>
859 cc9bf8f2 2021-11-05 op <dd>Toggle the wrapping of preformatted blocks.</dd>
862 cc9bf8f2 2021-11-05 op <section class="Ss">
863 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Minibuffer_commands"><a class="permalink" href="#Minibuffer_commands">Minibuffer
864 cc9bf8f2 2021-11-05 op commands</a></h2>
865 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
866 cc9bf8f2 2021-11-05 op <dt id="mini-abort"><a class="permalink" href="#mini-abort"><code class="Ic">mini-abort</code></a></dt>
867 cc9bf8f2 2021-11-05 op <dd>Abort the current minibuffer action.</dd>
868 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>
869 cc9bf8f2 2021-11-05 op <dd>Complete the current minibuffer action.</dd>
870 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>
871 cc9bf8f2 2021-11-05 op <dd>Delete the character before the point.</dd>
872 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>
873 cc9bf8f2 2021-11-05 op <dd>Delete the character after the point.</dd>
874 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>
875 cc9bf8f2 2021-11-05 op <dd>Select the first completion, if any.</dd>
876 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>
877 cc9bf8f2 2021-11-05 op <dd>Select the last completion, if any.</dd>
878 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>
879 cc9bf8f2 2021-11-05 op <dd>Delete from point until the end of the line.</dd>
880 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>
881 cc9bf8f2 2021-11-05 op <dd>Load the previous history element.</dd>
882 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>
883 cc9bf8f2 2021-11-05 op <dd>Load the next history element.</dd>
886 cc9bf8f2 2021-11-05 op <section class="Ss">
887 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Aliases"><a class="permalink" href="#Aliases">Aliases</a></h2>
888 cc9bf8f2 2021-11-05 op <p class="Pp">The following aliases are available during
889 cc9bf8f2 2021-11-05 op <code class="Ic">execute-extended-command</code>:</p>
890 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
891 4b495710 2022-04-13 op <dt id="open"><a class="permalink" href="#open"><code class="Ic">open</code></a></dt>
892 4b495710 2022-04-13 op <dd><a class="permalink" href="#load-url~2"><code class="Ic" id="load-url~2">load-url</code></a></dd>
893 cc9bf8f2 2021-11-05 op <dt id="tabn"><a class="permalink" href="#tabn"><code class="Ic">tabn</code></a></dt>
894 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>
895 cc9bf8f2 2021-11-05 op <dt id="tabnew"><a class="permalink" href="#tabnew"><code class="Ic">tabnew</code></a></dt>
896 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>
897 cc9bf8f2 2021-11-05 op <dt id="tabp"><a class="permalink" href="#tabp"><code class="Ic">tabp</code></a></dt>
898 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>
899 cc9bf8f2 2021-11-05 op <dt id="q"><a class="permalink" href="#q"><code class="Ic">q</code></a>
900 cc9bf8f2 2021-11-05 op <span class="No">and</span> <code class="Ic">wq</code></dt>
901 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>
905 cc9bf8f2 2021-11-05 op <section class="Sh">
906 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="ENVIRONMENT"><a class="permalink" href="#ENVIRONMENT">ENVIRONMENT</a></h1>
907 cc9bf8f2 2021-11-05 op <p class="Pp">When <code class="Nm">telescope</code> is started, it inspects the
908 cc9bf8f2 2021-11-05 op following environment variables:</p>
909 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
910 cc9bf8f2 2021-11-05 op <dt id="HOME"><a class="permalink" href="#HOME"><code class="Ev">HOME</code></a></dt>
911 cc9bf8f2 2021-11-05 op <dd>The user's login directory.</dd>
912 cc9bf8f2 2021-11-05 op <dt id="NO_COLORS"><a class="permalink" href="#NO_COLORS"><code class="Ev">NO_COLORS</code></a></dt>
913 cc9bf8f2 2021-11-05 op <dd>To decide whether to use colors or not. The content of the variable
914 cc9bf8f2 2021-11-05 op doesn't matter.</dd>
915 cc9bf8f2 2021-11-05 op <dt id="TERM"><a class="permalink" href="#TERM"><code class="Ev">TERM</code></a></dt>
916 cc9bf8f2 2021-11-05 op <dd>The user's terminal name.</dd>
917 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>,
918 bfd29c14 2021-12-01 op <code class="Ev">XDG_CONFIG_HOME</code>,
919 bfd29c14 2021-12-01 op <code class="Ev">XDG_DATA_HOME</code></dt>
920 bfd29c14 2021-12-01 op <dd>If defined can alter the default location of the files used.</dd>
923 cc9bf8f2 2021-11-05 op <section class="Sh">
924 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
925 bfd29c14 2021-12-01 op <p class="Pp">By default <code class="Nm">telescope</code> follows the XDG Base
926 bfd29c14 2021-12-01 op Directory Specification. However, if <span class="Pa">~/.telescope</span>
927 bfd29c14 2021-12-01 op exists, XDG is ignored and all the files are stored inside it. The usage of
928 bfd29c14 2021-12-01 op <code class="Ev">XDG_CACHE_HOME</code>,
929 bfd29c14 2021-12-01 op <code class="Ev">XDG_CONFIG_HOME</code> and
930 bfd29c14 2021-12-01 op <code class="Ev">XDG_DATA_HOME</code> can further alter the location of
931 bfd29c14 2021-12-01 op these files.</p>
932 bfd29c14 2021-12-01 op <p class="Pp"></p>
933 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
934 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.config/telescope/config</span></dt>
935 cc9bf8f2 2021-11-05 op <dd>Default configuration file.</dd>
936 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.local/share/telescope/pages/about_*.gmi</span></dt>
937 bfd29c14 2021-12-01 op <dd>Overrides for built-in about: pages.</dd>
938 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.local/share/telescope/bookmarks.gmi</span></dt>
939 bfd29c14 2021-12-01 op <dd>Bookmarks file.</dd>
940 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.local/share/telescope/known_hosts</span></dt>
941 cc9bf8f2 2021-11-05 op <dd>Hash of the certificates for all the known hosts. Each line contains three
942 cc9bf8f2 2021-11-05 op fields: hostname with optional port number, hash of the certificate and a
943 cc9bf8f2 2021-11-05 op numeric flag.</dd>
944 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.cache/telescope/lock</span></dt>
945 cc9bf8f2 2021-11-05 op <dd>Lock file used to prevent multiple instance of
946 cc9bf8f2 2021-11-05 op <code class="Nm">telescope</code> from running at the same time.</dd>
947 bfd29c14 2021-12-01 op <dt><span class="Pa">~/.cache/telescope/session</span></dt>
948 d9bfe90a 2022-01-13 op <dd>The list of tabs from the last session.</dd>
951 cc9bf8f2 2021-11-05 op <section class="Sh">
952 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
953 cc9bf8f2 2021-11-05 op <p class="Pp">It's possible to browse “the small web” (i.e. simple
954 cc9bf8f2 2021-11-05 op websites) by using programs like the duckling-proxy by defining a proxy in
955 bfd29c14 2021-12-01 op <span class="Pa">~/.config/telescope/config</span>:</p>
956 cc9bf8f2 2021-11-05 op <div class="Bd Pp Bd-indent Li">
957 cc9bf8f2 2021-11-05 op <pre>proxy http via "gemini://127.0.0.1:1965"
958 cc9bf8f2 2021-11-05 op proxy https via "gemini://127.0.0.1:1965"</pre>
960 cc9bf8f2 2021-11-05 op <p class="Pp">To load <code class="Nm">telescope</code> without any
961 cc9bf8f2 2021-11-05 op configuration</p>
962 cc9bf8f2 2021-11-05 op <div class="Bd Pp Bd-indent Li">
963 cc9bf8f2 2021-11-05 op <pre>telescope -c /dev/null</pre>
966 cc9bf8f2 2021-11-05 op <section class="Sh">
967 bfd29c14 2021-12-01 op <h1 class="Sh" id="STANDARDS"><a class="permalink" href="#STANDARDS">STANDARDS</a></h1>
968 bfd29c14 2021-12-01 op <p class="Pp"><cite class="Rs"><i class="RsB">XDG Base Directory
969 bfd29c14 2021-12-01 op Specification</i>,
970 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>
972 d9bfe90a 2022-01-13 op <section class="Sh">
973 d9bfe90a 2022-01-13 op <h1 class="Sh" id="ACKNOWLEDGEMENTS"><a class="permalink" href="#ACKNOWLEDGEMENTS">ACKNOWLEDGEMENTS</a></h1>
974 d9bfe90a 2022-01-13 op <p class="Pp">The “Trust, but verify (where appropriate)” TOFU
975 d9bfe90a 2022-01-13 op scheme was firstly suggested by thfr:
976 d9bfe90a 2022-01-13 op <a class="Lk" href="gemini://thfr.info/gemini/modified-trust-verify.gmi">gemini://thfr.info/gemini/modified-trust-verify.gmi</a>.</p>
978 bfd29c14 2021-12-01 op <section class="Sh">
979 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
980 cc9bf8f2 2021-11-05 op <p class="Pp">The <code class="Nm">telescope</code> program was written by
981 cc9bf8f2 2021-11-05 op <span class="An">Omar Polo</span>
982 cc9bf8f2 2021-11-05 op <<a class="Mt" href="mailto:op@omarpolo.com">op@omarpolo.com</a>>.</p>
984 cc9bf8f2 2021-11-05 op <section class="Sh">
985 bfd29c14 2021-12-01 op <h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1>
986 bfd29c14 2021-12-01 op <p class="Pp"><code class="Nm">telescope</code> assumes a UTF-8 environment and
987 d9bfe90a 2022-01-13 op doesn't try to cope with other encodings. This can cause strange rendering
988 d9bfe90a 2022-01-13 op issues if you're lucky, or possibly weird thing happening depending on your
989 bfd29c14 2021-12-01 op locale and terminal emulator.</p>
990 d9bfe90a 2022-01-13 op <p class="Pp">The algorithm used for text-wrapping is naive and doesn't really
991 d9bfe90a 2022-01-13 op work for languages that make heavily use of glyphs composed by multiple
992 d9bfe90a 2022-01-13 op UNICODE codepoints.</p>
994 bfd29c14 2021-12-01 op <section class="Sh">
995 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
996 cc9bf8f2 2021-11-05 op <p class="Pp">There's no UI for out-of-band certificates validation.</p>
999 cc9bf8f2 2021-11-05 op <table class="foot">
1001 d9bfe90a 2022-01-13 op <td class="foot-date">January 5, 2022</td>
1002 4b495710 2022-04-13 op <td class="foot-os">OpenBSD 7.1</td>
