1 cc9bf8f2 2021-11-05 op <!DOCTYPE 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>
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 cc9bf8f2 2021-11-05 op max-width: 960px;
24 cc9bf8f2 2021-11-05 op margin: 0 auto;
25 cc9bf8f2 2021-11-05 op padding: 0 1rem;
26 cc9bf8f2 2021-11-05 op font-family: monospace;
27 cc9bf8f2 2021-11-05 op font-size: 1rem;
29 cc9bf8f2 2021-11-05 op table.head, table.foot { width: 100%; }
30 cc9bf8f2 2021-11-05 op td.head-rtitle, td.foot-os { text-align: right; }
31 cc9bf8f2 2021-11-05 op td.head-vol { text-align: center; }
32 cc9bf8f2 2021-11-05 op .Nd, .Bf, .Op { display: inline; }
33 cc9bf8f2 2021-11-05 op .Pa, .Ad { font-style: italic; }
34 cc9bf8f2 2021-11-05 op .Ms { font-weight: bold; }
35 cc9bf8f2 2021-11-05 op .Bl-diag > dt { font-weight: bold; }
36 cc9bf8f2 2021-11-05 op code.Nm, .Fl, .Cm, .Ic, code.In, .Fd, .Fn, .Cd { font-weight: bold;
37 cc9bf8f2 2021-11-05 op font-family: inherit; }
39 cc9bf8f2 2021-11-05 op <title>TELESCOPE(1)</title>
42 cc9bf8f2 2021-11-05 op <table class="head">
44 cc9bf8f2 2021-11-05 op <td class="head-ltitle">TELESCOPE(1)</td>
45 cc9bf8f2 2021-11-05 op <td class="head-vol">General Commands Manual</td>
46 cc9bf8f2 2021-11-05 op <td class="head-rtitle">TELESCOPE(1)</td>
49 cc9bf8f2 2021-11-05 op <div class="manual-text">
50 cc9bf8f2 2021-11-05 op <section class="Sh">
51 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
52 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> —
53 cc9bf8f2 2021-11-05 op <span class="Nd">multi-protocol browser</span></p>
55 cc9bf8f2 2021-11-05 op <section class="Sh">
56 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
57 cc9bf8f2 2021-11-05 op <table class="Nm">
59 cc9bf8f2 2021-11-05 op <td><code class="Nm">telescope</code></td>
60 cc9bf8f2 2021-11-05 op <td>[<code class="Fl">-Chnv</code>]
61 cc9bf8f2 2021-11-05 op [<code class="Fl">-c</code> <span class="Pa">config</span>]
62 cc9bf8f2 2021-11-05 op [<var class="Ar">URL</var>]</td>
66 cc9bf8f2 2021-11-05 op <section class="Sh">
67 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
68 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> is an interactive browser that
69 cc9bf8f2 2021-11-05 op supports the Finger, Gemini and Gopher protocols.
70 cc9bf8f2 2021-11-05 op <code class="Nm">telescope</code> features tabs, a minibuffer, interactive
71 cc9bf8f2 2021-11-05 op completions, bookmarks and out-of-band TOFU verification.</p>
72 cc9bf8f2 2021-11-05 op <p class="Pp">The arguments are as follows:</p>
73 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
74 cc9bf8f2 2021-11-05 op <dt id="C"><a class="permalink" href="#C"><code class="Fl">-C</code></a>,
75 cc9bf8f2 2021-11-05 op <code class="Fl">--colors</code></dt>
76 cc9bf8f2 2021-11-05 op <dd>Show all available colors and exit.</dd>
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 <span class="Pa">config</span></dt>
79 cc9bf8f2 2021-11-05 op <dd>Specify an alternative configuration file. By default
80 cc9bf8f2 2021-11-05 op <span class="Pa">$HOME/.telescope/config</span> is loaded.</dd>
81 cc9bf8f2 2021-11-05 op <dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a>,
82 cc9bf8f2 2021-11-05 op <code class="Fl">--help</code></dt>
83 cc9bf8f2 2021-11-05 op <dd>Display version and usage.</dd>
84 cc9bf8f2 2021-11-05 op <dt id="n"><a class="permalink" href="#n"><code class="Fl">-n</code></a></dt>
85 cc9bf8f2 2021-11-05 op <dd>Configtest mode. Only check the configuration file for validity.</dd>
86 cc9bf8f2 2021-11-05 op <dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a>,
87 cc9bf8f2 2021-11-05 op <code class="Fl">--version</code></dt>
88 cc9bf8f2 2021-11-05 op <dd>Display version.</dd>
91 cc9bf8f2 2021-11-05 op <section class="Sh">
92 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="UI_CONCEPTS"><a class="permalink" href="#UI_CONCEPTS">UI
93 cc9bf8f2 2021-11-05 op CONCEPTS</a></h1>
94 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> interface is divided into four
95 cc9bf8f2 2021-11-05 op areas: the tabline, the body, the modeline and the echoarea/minibuffer.</p>
96 cc9bf8f2 2021-11-05 op <p class="Pp">The tabline is always at the top of the screen and displays the
97 cc9bf8f2 2021-11-05 op tabs separated by a vertical line. When there are more tabs than the size of
98 cc9bf8f2 2021-11-05 op the window allow to display, the characters ‘<’ or
99 cc9bf8f2 2021-11-05 op ‘>’ are shown at the start/end of the tabline to indicate
100 cc9bf8f2 2021-11-05 op that there are more tabs in that direction.</p>
101 cc9bf8f2 2021-11-05 op <p class="Pp">The body occupies the majority of the visible area. It contains
102 cc9bf8f2 2021-11-05 op the current page and optionally a side window.</p>
103 cc9bf8f2 2021-11-05 op <p class="Pp">The modeline is the second to last row of the screen. It shows
104 cc9bf8f2 2021-11-05 op some information about the page: a spinner when the page is loading, the
105 cc9bf8f2 2021-11-05 op trust level, the document type, the scroll offset and the URL.</p>
106 cc9bf8f2 2021-11-05 op <p class="Pp">The echoarea is usually the last line of the screen. Messages are
107 cc9bf8f2 2021-11-05 op often showed there, and link addresses too. The echoarea is also used to
108 cc9bf8f2 2021-11-05 op obtain input from the user. When commands like
109 cc9bf8f2 2021-11-05 op <code class="Ic">swiper</code> or <code class="Ic">link-select</code> are
110 cc9bf8f2 2021-11-05 op invoked, the minibuffer area grows to show possible completions.</p>
112 cc9bf8f2 2021-11-05 op <section class="Sh">
113 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="TOFU"><a class="permalink" href="#TOFU">TOFU</a></h1>
114 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> aims to use the “Trust,
115 cc9bf8f2 2021-11-05 op but Verify (where appropriate)” approach for TOFU (“Trust On
116 cc9bf8f2 2021-11-05 op First Use”). The idea is to define three level of verification for a
117 cc9bf8f2 2021-11-05 op certificate:</p>
118 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
119 cc9bf8f2 2021-11-05 op <dt>untrusted</dt>
120 cc9bf8f2 2021-11-05 op <dd>(‘!’) the server fingerprint does NOT match the stored
122 cc9bf8f2 2021-11-05 op <dt>trusted</dt>
123 cc9bf8f2 2021-11-05 op <dd>(‘v’) the server fingerprint matches the store one.</dd>
124 cc9bf8f2 2021-11-05 op <dt>verified</dt>
125 cc9bf8f2 2021-11-05 op <dd>(‘V’) the fingerprint matches and has been verified
126 cc9bf8f2 2021-11-05 op out-of-band.</dd>
128 cc9bf8f2 2021-11-05 op <p class="Pp">The trust level of the page is indicated in the modeline with the
129 cc9bf8f2 2021-11-05 op indicated character.</p>
130 cc9bf8f2 2021-11-05 op <p class="Pp">Most of the time the “trusted” level is enough, but
131 cc9bf8f2 2021-11-05 op where is appropriate users should be able to verify out-of-band the
132 cc9bf8f2 2021-11-05 op certificate.</p>
133 cc9bf8f2 2021-11-05 op <p class="Pp">At the moment, there is no built-in support for an out-of-band
134 cc9bf8f2 2021-11-05 op verification though.</p>
136 cc9bf8f2 2021-11-05 op <section class="Sh">
137 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="SUPPORTED_PROTOCOLS"><a class="permalink" href="#SUPPORTED_PROTOCOLS">SUPPORTED
138 cc9bf8f2 2021-11-05 op PROTOCOLS</a></h1>
139 cc9bf8f2 2021-11-05 op <p class="Pp">The following protocols are supported:</p>
140 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
141 cc9bf8f2 2021-11-05 op <dt>about:</dt>
142 cc9bf8f2 2021-11-05 op <dd>About pages are <code class="Nm">telescope</code> internal page. See
143 cc9bf8f2 2021-11-05 op about:about for a list of all these pages.</dd>
144 cc9bf8f2 2021-11-05 op <dt>file://</dt>
145 cc9bf8f2 2021-11-05 op <dd>File types know to <code class="Nm">telescope</code>, such as .gmi,
146 cc9bf8f2 2021-11-05 op .gemini, .txt, .md, .markdown, .diff or .patch, can be viewed inside the
147 cc9bf8f2 2021-11-05 op application. Types of local files are detected solely based on the file
148 cc9bf8f2 2021-11-05 op extension. On some systems, such as <span class="Ux">OpenBSD</span>, only
149 cc9bf8f2 2021-11-05 op files inside special directories (like <span class="Pa">/tmp</span>
150 cc9bf8f2 2021-11-05 op <span class="No">or</span> <span class="Pa">~/Downloads</span>) are
151 cc9bf8f2 2021-11-05 op available.</dd>
152 cc9bf8f2 2021-11-05 op <dt>finger://</dt>
153 cc9bf8f2 2021-11-05 op <dd>Finger URLs are interpreted as follows:
154 cc9bf8f2 2021-11-05 op <ul class="Bl-bullet Bl-compact">
155 cc9bf8f2 2021-11-05 op <li>the host is determined by the host name portion of the URL</li>
156 cc9bf8f2 2021-11-05 op <li>if the user portion of the URL is provided, it's interpreted as the
157 cc9bf8f2 2021-11-05 op user to finger, otherwise the path component will be used</li>
159 cc9bf8f2 2021-11-05 op thus <a class="Lk" href="finger://user@hostname">finger://user@hostname</a>
160 cc9bf8f2 2021-11-05 op and <a class="Lk" href="finger://hostname/user">finger://hostname/user</a>
161 cc9bf8f2 2021-11-05 op are treated as the same URL.</dd>
162 cc9bf8f2 2021-11-05 op <dt>gemini://</dt>
163 cc9bf8f2 2021-11-05 op <dd>Gemini is fully supported, with the exception of client-certificates.</dd>
164 cc9bf8f2 2021-11-05 op <dt>gopher://</dt>
165 cc9bf8f2 2021-11-05 op <dd>Gopher support is limited to items type 0, 1 and 7. All text is assumed to
166 cc9bf8f2 2021-11-05 op be encoded in UTF-8 (or ASCII).</dd>
168 cc9bf8f2 2021-11-05 op <p class="Pp">User-entered URLs, given as argument on the command line or
169 cc9bf8f2 2021-11-05 op entered with <code class="Ic">load-url</code>, are intepreted with a simple
170 cc9bf8f2 2021-11-05 op heuristic:</p>
171 cc9bf8f2 2021-11-05 op <ul class="Bl-bullet Bl-compact">
172 cc9bf8f2 2021-11-05 op <li>if it's a proper absolute URL then use it as-is,</li>
173 cc9bf8f2 2021-11-05 op <li>if it starts with “./” or “/” assume it's a
174 cc9bf8f2 2021-11-05 op file:// URL,</li>
175 cc9bf8f2 2021-11-05 op <li>otherwise assume it's a Gemini URL.</li>
178 cc9bf8f2 2021-11-05 op <section class="Sh">
179 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="DEFAULT_KEY_BINDINGS"><a class="permalink" href="#DEFAULT_KEY_BINDINGS">DEFAULT
180 cc9bf8f2 2021-11-05 op KEY BINDINGS</a></h1>
181 cc9bf8f2 2021-11-05 op <p class="Pp">The default key bindings are very similar to GNU Emacs, but care
182 cc9bf8f2 2021-11-05 op has been taken to include also bindings familiar for <a class="Xr">vi(1)</a>
183 cc9bf8f2 2021-11-05 op and “CUA” users. In the following examples, C-x means
184 cc9bf8f2 2021-11-05 op Control-x, M-x means Meta-x, where the Meta key may be either a special key
185 cc9bf8f2 2021-11-05 op on the keyboard or the ALT key; otherwise ESC followed by the key X works as
186 cc9bf8f2 2021-11-05 op well, and C-M-x means to press the key X together with both Control and
188 cc9bf8f2 2021-11-05 op <p class="Pp">Keys are usually a single character, like ‘p’ or
189 cc9bf8f2 2021-11-05 op ‘n’, but some special keys are accepted as well.</p>
190 cc9bf8f2 2021-11-05 op <p class="Pp"></p>
191 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
192 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
193 cc9bf8f2 2021-11-05 op <dt><up></dt>
194 cc9bf8f2 2021-11-05 op <dd>Up arrow</dd>
195 cc9bf8f2 2021-11-05 op <dt><down></dt>
196 cc9bf8f2 2021-11-05 op <dd>Down arrow</dd>
197 cc9bf8f2 2021-11-05 op <dt><left></dt>
198 cc9bf8f2 2021-11-05 op <dd>Left arrow</dd>
199 cc9bf8f2 2021-11-05 op <dt><right></dt>
200 cc9bf8f2 2021-11-05 op <dd>Right arrow</dd>
201 cc9bf8f2 2021-11-05 op <dt><prior></dt>
202 cc9bf8f2 2021-11-05 op <dd>Previous page/Page up</dd>
203 cc9bf8f2 2021-11-05 op <dt><next></dt>
204 cc9bf8f2 2021-11-05 op <dd>Next page/Page down</dd>
205 cc9bf8f2 2021-11-05 op <dt><home></dt>
206 cc9bf8f2 2021-11-05 op <dd>Home</dd>
207 cc9bf8f2 2021-11-05 op <dt><end></dt>
209 cc9bf8f2 2021-11-05 op <dt><f0> thru <f63></dt>
210 cc9bf8f2 2021-11-05 op <dd>Function keys</dd>
211 cc9bf8f2 2021-11-05 op <dt>del or backspace</dt>
212 cc9bf8f2 2021-11-05 op <dd>Backspace</dd>
214 cc9bf8f2 2021-11-05 op <dd>Escape</dd>
215 cc9bf8f2 2021-11-05 op <dt>space or spc</dt>
216 cc9bf8f2 2021-11-05 op <dd>Space</dd>
217 cc9bf8f2 2021-11-05 op <dt>enter or ret</dt>
218 cc9bf8f2 2021-11-05 op <dd>Enter</dd>
221 cc9bf8f2 2021-11-05 op <dt>backtab</dt>
222 cc9bf8f2 2021-11-05 op <dd>Depends on the configuration of the terminal emulator; usually shift
226 cc9bf8f2 2021-11-05 op <section class="Ss">
227 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="GNU_Emacs-like_keys"><a class="permalink" href="#GNU_Emacs-like_keys">GNU
228 cc9bf8f2 2021-11-05 op Emacs-like keys</a></h2>
229 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
230 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
232 cc9bf8f2 2021-11-05 op <dd>previous-line</dd>
234 cc9bf8f2 2021-11-05 op <dd>next-line</dd>
236 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
238 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
240 cc9bf8f2 2021-11-05 op <dd>backward-paragraph</dd>
242 cc9bf8f2 2021-11-05 op <dd>forward-paragraph</dd>
244 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
246 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
247 cc9bf8f2 2021-11-05 op <dt>M-v, M-space</dt>
248 cc9bf8f2 2021-11-05 op <dd>scroll-up</dd>
249 cc9bf8f2 2021-11-05 op <dt>C-v, space</dt>
250 cc9bf8f2 2021-11-05 op <dd>scroll-down</dd>
251 cc9bf8f2 2021-11-05 op <dt>M-<</dt>
252 cc9bf8f2 2021-11-05 op <dd>beginning-of-buffer</dd>
253 cc9bf8f2 2021-11-05 op <dt>M-></dt>
254 cc9bf8f2 2021-11-05 op <dd>end-of-buffer</dd>
255 cc9bf8f2 2021-11-05 op <dt>C-x C-c</dt>
256 cc9bf8f2 2021-11-05 op <dd>kill-telescope</dd>
258 cc9bf8f2 2021-11-05 op <dd>clear-minibuf</dd>
260 cc9bf8f2 2021-11-05 op <dd>execute-extended-command</dd>
261 cc9bf8f2 2021-11-05 op <dt>C-c {</dt>
262 cc9bf8f2 2021-11-05 op <dd>dec-fill-column</dd>
263 cc9bf8f2 2021-11-05 op <dt>C-c }</dt>
264 cc9bf8f2 2021-11-05 op <dd>inc-fill-column</dd>
265 cc9bf8f2 2021-11-05 op <dt>C-c p</dt>
266 cc9bf8f2 2021-11-05 op <dd>previous-heading</dd>
267 cc9bf8f2 2021-11-05 op <dt>C-c n</dt>
268 cc9bf8f2 2021-11-05 op <dd>next-heading</dd>
269 cc9bf8f2 2021-11-05 op <dt>></dt>
270 cc9bf8f2 2021-11-05 op <dd>load-url</dd>
271 cc9bf8f2 2021-11-05 op <dt><</dt>
272 cc9bf8f2 2021-11-05 op <dd>load-current-url</dd>
273 cc9bf8f2 2021-11-05 op <dt>C-x C-f</dt>
274 cc9bf8f2 2021-11-05 op <dd>load-url</dd>
275 cc9bf8f2 2021-11-05 op <dt>C-x M-f</dt>
276 cc9bf8f2 2021-11-05 op <dd>load-current-url</dd>
277 cc9bf8f2 2021-11-05 op <dt>C-x o</dt>
278 cc9bf8f2 2021-11-05 op <dd>other-window</dd>
279 cc9bf8f2 2021-11-05 op <dt>C-x t 0</dt>
280 cc9bf8f2 2021-11-05 op <dd>tab-close</dd>
281 cc9bf8f2 2021-11-05 op <dt>C-x t 1</dt>
282 cc9bf8f2 2021-11-05 op <dd>tab-close-other</dd>
283 cc9bf8f2 2021-11-05 op <dt>C-x t 2</dt>
284 cc9bf8f2 2021-11-05 op <dd>tab-new</dd>
285 cc9bf8f2 2021-11-05 op <dt>C-x t o</dt>
286 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
287 cc9bf8f2 2021-11-05 op <dt>C-x t O</dt>
288 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
289 cc9bf8f2 2021-11-05 op <dt>C-x t m</dt>
290 cc9bf8f2 2021-11-05 op <dd>tab-move</dd>
291 cc9bf8f2 2021-11-05 op <dt>C-x t M</dt>
292 cc9bf8f2 2021-11-05 op <dd>tab-move-to</dd>
293 cc9bf8f2 2021-11-05 op <dt>B, C-M-b</dt>
294 cc9bf8f2 2021-11-05 op <dd>previous-page</dd>
295 cc9bf8f2 2021-11-05 op <dt>F, C-M-f</dt>
296 cc9bf8f2 2021-11-05 op <dd>next-page</dd>
297 cc9bf8f2 2021-11-05 op <dt><f7> a</dt>
298 cc9bf8f2 2021-11-05 op <dd>bookmark-page</dd>
299 cc9bf8f2 2021-11-05 op <dt><f7> <f7></dt>
300 cc9bf8f2 2021-11-05 op <dd>list-bookmarks</dd>
302 cc9bf8f2 2021-11-05 op <dd>suspend-telescope</dd>
306 cc9bf8f2 2021-11-05 op <section class="Ss">
307 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
308 cc9bf8f2 2021-11-05 op keys</a></h2>
309 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
310 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
312 cc9bf8f2 2021-11-05 op <dd>previous-line</dd>
314 cc9bf8f2 2021-11-05 op <dd>next-line</dd>
316 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
318 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
320 cc9bf8f2 2021-11-05 op <dd>backward-paragraph</dd>
322 cc9bf8f2 2021-11-05 op <dd>forward-paragraph</dd>
324 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
326 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
328 cc9bf8f2 2021-11-05 op <dd>scroll-line-up</dd>
330 cc9bf8f2 2021-11-05 op <dd>scroll-line-down</dd>
332 cc9bf8f2 2021-11-05 op <dd>beginning-of-buffer</dd>
334 cc9bf8f2 2021-11-05 op <dd>end-of-buffer</dd>
336 cc9bf8f2 2021-11-05 op <dd>tab-close</dd>
338 cc9bf8f2 2021-11-05 op <dd>tab-new</dd>
340 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
342 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
343 cc9bf8f2 2021-11-05 op <dt>g M-t</dt>
344 cc9bf8f2 2021-11-05 op <dd>tab-move</dd>
345 cc9bf8f2 2021-11-05 op <dt>g M-T</dt>
346 cc9bf8f2 2021-11-05 op <dd>tab-move-to</dd>
348 cc9bf8f2 2021-11-05 op <dd>previous-page</dd>
350 cc9bf8f2 2021-11-05 op <dd>next-page</dd>
352 cc9bf8f2 2021-11-05 op <dd>kill-telescope</dd>
354 cc9bf8f2 2021-11-05 op <dd>clear-minibuf</dd>
356 cc9bf8f2 2021-11-05 op <dd>execute-extended-command</dd>
360 cc9bf8f2 2021-11-05 op <section class="Ss">
361 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="CUA-like_keys"><a class="permalink" href="#CUA-like_keys">CUA-like
362 cc9bf8f2 2021-11-05 op keys</a></h2>
363 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
364 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
365 cc9bf8f2 2021-11-05 op <dt><up></dt>
366 cc9bf8f2 2021-11-05 op <dd>previous-line</dd>
367 cc9bf8f2 2021-11-05 op <dt><down></dt>
368 cc9bf8f2 2021-11-05 op <dd>next-line</dd>
369 cc9bf8f2 2021-11-05 op <dt><right></dt>
370 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
371 cc9bf8f2 2021-11-05 op <dt><left></dt>
372 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
373 cc9bf8f2 2021-11-05 op <dt><home></dt>
374 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
375 cc9bf8f2 2021-11-05 op <dt><end></dt>
376 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
377 cc9bf8f2 2021-11-05 op <dt><prior></dt>
378 cc9bf8f2 2021-11-05 op <dd>scroll-up</dd>
379 cc9bf8f2 2021-11-05 op <dt><next></dt>
380 cc9bf8f2 2021-11-05 op <dd>scroll-down</dd>
382 cc9bf8f2 2021-11-05 op <dd>tab-close</dd>
384 cc9bf8f2 2021-11-05 op <dd>tab-new</dd>
385 cc9bf8f2 2021-11-05 op <dt>M-<prior></dt>
386 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
387 cc9bf8f2 2021-11-05 op <dt>M-<next></dt>
388 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
389 cc9bf8f2 2021-11-05 op <dt>M-<left></dt>
390 cc9bf8f2 2021-11-05 op <dd>previous-page</dd>
391 cc9bf8f2 2021-11-05 op <dt>M-<right></dt>
392 cc9bf8f2 2021-11-05 op <dd>next-page</dd>
393 cc9bf8f2 2021-11-05 op <dt><f5></dt>
394 cc9bf8f2 2021-11-05 op <dd>reload-page</dd>
396 cc9bf8f2 2021-11-05 op <dd>reload-page</dd>
400 cc9bf8f2 2021-11-05 op <section class="Ss">
401 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Neither_Emacs_nor_vi_specific"><a class="permalink" href="#Neither_Emacs_nor_vi_specific">Neither
402 cc9bf8f2 2021-11-05 op Emacs nor vi specific</a></h2>
403 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
404 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
405 cc9bf8f2 2021-11-05 op <dt><f1></dt>
406 cc9bf8f2 2021-11-05 op <dd>toggle-help</dd>
407 cc9bf8f2 2021-11-05 op <dt>enter</dt>
408 cc9bf8f2 2021-11-05 op <dd>push-button</dd>
409 cc9bf8f2 2021-11-05 op <dt>M-enter</dt>
410 cc9bf8f2 2021-11-05 op <dd>push-button-new-tab</dd>
411 cc9bf8f2 2021-11-05 op <dt>M-tab</dt>
412 cc9bf8f2 2021-11-05 op <dd>previous-button</dd>
413 cc9bf8f2 2021-11-05 op <dt>backtab</dt>
414 cc9bf8f2 2021-11-05 op <dd>previous-button</dd>
416 cc9bf8f2 2021-11-05 op <dd>next-button</dd>
418 cc9bf8f2 2021-11-05 op <dd>tab-select</dd>
420 cc9bf8f2 2021-11-05 op <dd>tab-previous</dd>
422 cc9bf8f2 2021-11-05 op <dd>tab-next</dd>
424 cc9bf8f2 2021-11-05 op <dd>tab-move-to</dd>
426 cc9bf8f2 2021-11-05 op <dd>tab-move</dd>
428 cc9bf8f2 2021-11-05 op <dd>link-select</dd>
430 cc9bf8f2 2021-11-05 op <dd>swiper</dd>
434 cc9bf8f2 2021-11-05 op <section class="Ss">
435 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Minibuffer-specific_keys"><a class="permalink" href="#Minibuffer-specific_keys">Minibuffer-specific
436 cc9bf8f2 2021-11-05 op keys</a></h2>
437 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
438 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
439 cc9bf8f2 2021-11-05 op <dt>enter</dt>
440 cc9bf8f2 2021-11-05 op <dd>mini-complete-and-exit</dd>
442 cc9bf8f2 2021-11-05 op <dd>mini-abort</dd>
444 cc9bf8f2 2021-11-05 op <dd>mini-abort</dd>
446 cc9bf8f2 2021-11-05 op <dd>mini-delete-char</dd>
448 cc9bf8f2 2021-11-05 op <dd>mini-delete-backward-char</dd>
449 cc9bf8f2 2021-11-05 op <dt>backspace</dt>
450 cc9bf8f2 2021-11-05 op <dd>mini-delete-backward-char</dd>
452 cc9bf8f2 2021-11-05 op <dd>mini-delete-backward-char</dd>
454 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
456 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
457 cc9bf8f2 2021-11-05 op <dt><left></dt>
458 cc9bf8f2 2021-11-05 op <dd>backward-char</dd>
459 cc9bf8f2 2021-11-05 op <dt><right></dt>
460 cc9bf8f2 2021-11-05 op <dd>forward-char</dd>
462 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
464 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
465 cc9bf8f2 2021-11-05 op <dt><end></dt>
466 cc9bf8f2 2021-11-05 op <dd>move-end-of-line</dd>
467 cc9bf8f2 2021-11-05 op <dt><home></dt>
468 cc9bf8f2 2021-11-05 op <dd>move-beginning-of-line</dd>
470 cc9bf8f2 2021-11-05 op <dd>mini-kill-line</dd>
472 cc9bf8f2 2021-11-05 op <dd>mini-previous-history-element</dd>
474 cc9bf8f2 2021-11-05 op <dd>mini-next-history-element</dd>
476 cc9bf8f2 2021-11-05 op <dd>previous-completion</dd>
478 cc9bf8f2 2021-11-05 op <dd>next-completion</dd>
479 cc9bf8f2 2021-11-05 op <dt><up></dt>
480 cc9bf8f2 2021-11-05 op <dd>previous-completion</dd>
481 cc9bf8f2 2021-11-05 op <dt><down></dt>
482 cc9bf8f2 2021-11-05 op <dd>next-completion</dd>
484 cc9bf8f2 2021-11-05 op <dd>insert-current-candidate</dd>
485 cc9bf8f2 2021-11-05 op <dt>M-<</dt>
486 cc9bf8f2 2021-11-05 op <dd>mini-goto-beginning</dd>
487 cc9bf8f2 2021-11-05 op <dt>M-></dt>
488 cc9bf8f2 2021-11-05 op <dd>mini-goto-end</dd>
493 cc9bf8f2 2021-11-05 op <section class="Sh">
494 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="INTERACTIVE_COMMANDS"><a class="permalink" href="#INTERACTIVE_COMMANDS">INTERACTIVE
495 cc9bf8f2 2021-11-05 op COMMANDS</a></h1>
496 cc9bf8f2 2021-11-05 op <p class="Pp">Follows the documentation for the interactive commands. These
497 cc9bf8f2 2021-11-05 op commands can be bound to a key or executed with
498 cc9bf8f2 2021-11-05 op <code class="Ic">execute-extended-command</code>.</p>
499 cc9bf8f2 2021-11-05 op <section class="Ss">
500 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Movement_commands"><a class="permalink" href="#Movement_commands">Movement
501 cc9bf8f2 2021-11-05 op commands</a></h2>
502 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
503 cc9bf8f2 2021-11-05 op <dt id="backward-char"><a class="permalink" href="#backward-char"><code class="Ic">backward-char</code></a></dt>
504 cc9bf8f2 2021-11-05 op <dd>Move point one character backward.</dd>
505 cc9bf8f2 2021-11-05 op <dt id="backward-paragraph"><a class="permalink" href="#backward-paragraph"><code class="Ic">backward-paragraph</code></a></dt>
506 cc9bf8f2 2021-11-05 op <dd>Move point one paragraph backward.</dd>
507 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>
508 cc9bf8f2 2021-11-05 op <dd>Move point to the beginning of the buffer.</dd>
509 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>
510 cc9bf8f2 2021-11-05 op <dd>Move point to the end of the buffer.</dd>
511 cc9bf8f2 2021-11-05 op <dt id="forward-char"><a class="permalink" href="#forward-char"><code class="Ic">forward-char</code></a></dt>
512 cc9bf8f2 2021-11-05 op <dd>Move point one character forward.</dd>
513 cc9bf8f2 2021-11-05 op <dt id="forward-paragraph"><a class="permalink" href="#forward-paragraph"><code class="Ic">forward-paragraph</code></a></dt>
514 cc9bf8f2 2021-11-05 op <dd>Move point one paragraph forward.</dd>
515 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>
516 cc9bf8f2 2021-11-05 op <dd>Copy the current selection text as minibuffer input.</dd>
517 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>
518 cc9bf8f2 2021-11-05 op <dd>Move point at the beginning of the current (visual) line.</dd>
519 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>
520 cc9bf8f2 2021-11-05 op <dd>Move point at the end of the current (visual) line.</dd>
521 cc9bf8f2 2021-11-05 op <dt id="next-button"><a class="permalink" href="#next-button"><code class="Ic">next-button</code></a></dt>
522 cc9bf8f2 2021-11-05 op <dd>Move point to the next link.</dd>
523 cc9bf8f2 2021-11-05 op <dt id="next-completion"><a class="permalink" href="#next-completion"><code class="Ic">next-completion</code></a></dt>
524 cc9bf8f2 2021-11-05 op <dd>Select the next completion.</dd>
525 cc9bf8f2 2021-11-05 op <dt id="next-heading"><a class="permalink" href="#next-heading"><code class="Ic">next-heading</code></a></dt>
526 cc9bf8f2 2021-11-05 op <dd>Move point to the next heading.</dd>
527 cc9bf8f2 2021-11-05 op <dt id="next-line"><a class="permalink" href="#next-line"><code class="Ic">next-line</code></a></dt>
528 cc9bf8f2 2021-11-05 op <dd>Move point to the next (visual) line, in the same column if possible.</dd>
529 cc9bf8f2 2021-11-05 op <dt id="previous-button"><a class="permalink" href="#previous-button"><code class="Ic">previous-button</code></a></dt>
530 cc9bf8f2 2021-11-05 op <dd>Move point to the previous link.</dd>
531 cc9bf8f2 2021-11-05 op <dt id="previous-completion"><a class="permalink" href="#previous-completion"><code class="Ic">previous-completion</code></a></dt>
532 cc9bf8f2 2021-11-05 op <dd>Select the previous completion.</dd>
533 cc9bf8f2 2021-11-05 op <dt id="previous-heading"><a class="permalink" href="#previous-heading"><code class="Ic">previous-heading</code></a></dt>
534 cc9bf8f2 2021-11-05 op <dd>Move point to the previous heading.</dd>
535 cc9bf8f2 2021-11-05 op <dt id="previous-line"><a class="permalink" href="#previous-line"><code class="Ic">previous-line</code></a></dt>
536 cc9bf8f2 2021-11-05 op <dd>Move point to the previous (visual) line.</dd>
539 cc9bf8f2 2021-11-05 op <section class="Ss">
540 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Bookmark-related_commands"><a class="permalink" href="#Bookmark-related_commands">Bookmark-related
541 cc9bf8f2 2021-11-05 op commands</a></h2>
542 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
543 cc9bf8f2 2021-11-05 op <dt id="bookmark-page"><a class="permalink" href="#bookmark-page"><code class="Ic">bookmark-page</code></a></dt>
544 cc9bf8f2 2021-11-05 op <dd>Save a page in the bookmark file. It preloads the minibuffer with the
545 cc9bf8f2 2021-11-05 op current URL.</dd>
546 cc9bf8f2 2021-11-05 op <dt id="list-bookmarks"><a class="permalink" href="#list-bookmarks"><code class="Ic">list-bookmarks</code></a></dt>
547 cc9bf8f2 2021-11-05 op <dd>Load the bookmarks page.</dd>
550 cc9bf8f2 2021-11-05 op <section class="Ss">
551 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Tab-related_commands"><a class="permalink" href="#Tab-related_commands">Tab-related
552 cc9bf8f2 2021-11-05 op commands</a></h2>
553 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
554 cc9bf8f2 2021-11-05 op <dt id="tab-close"><a class="permalink" href="#tab-close"><code class="Ic">tab-close</code></a></dt>
555 cc9bf8f2 2021-11-05 op <dd>Close the current tab.</dd>
556 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>
557 cc9bf8f2 2021-11-05 op <dd>Close all tabs but the current one.</dd>
558 cc9bf8f2 2021-11-05 op <dt id="tab-move"><a class="permalink" href="#tab-move"><code class="Ic">tab-move</code></a></dt>
559 cc9bf8f2 2021-11-05 op <dd>Move the current tab after the next one, wrapping around if needed.</dd>
560 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>
561 cc9bf8f2 2021-11-05 op <dd>Move the current tab before the previous one, wrapping around if
563 cc9bf8f2 2021-11-05 op <dt id="tab-new"><a class="permalink" href="#tab-new"><code class="Ic">tab-new</code></a></dt>
564 cc9bf8f2 2021-11-05 op <dd>Open a new tab.</dd>
565 cc9bf8f2 2021-11-05 op <dt id="tab-next"><a class="permalink" href="#tab-next"><code class="Ic">tab-next</code></a></dt>
566 cc9bf8f2 2021-11-05 op <dd>Focus next tab, wrapping around eventually.</dd>
567 cc9bf8f2 2021-11-05 op <dt id="tab-previous"><a class="permalink" href="#tab-previous"><code class="Ic">tab-previous</code></a></dt>
568 cc9bf8f2 2021-11-05 op <dd>Focus the previous tab, wrapping around eventually.</dd>
569 cc9bf8f2 2021-11-05 op <dt id="tab-select"><a class="permalink" href="#tab-select"><code class="Ic">tab-select</code></a></dt>
570 cc9bf8f2 2021-11-05 op <dd>Switch to a tab using the minibuffer.</dd>
573 cc9bf8f2 2021-11-05 op <section class="Ss">
574 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Misc_commands"><a class="permalink" href="#Misc_commands">Misc
575 cc9bf8f2 2021-11-05 op commands</a></h2>
576 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
577 cc9bf8f2 2021-11-05 op <dt id="clear-minibuf"><a class="permalink" href="#clear-minibuf"><code class="Ic">clear-minibuf</code></a></dt>
578 cc9bf8f2 2021-11-05 op <dd>Clear the echo area.</dd>
579 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>
580 cc9bf8f2 2021-11-05 op <dd>Decrement fill-column by two.</dd>
581 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>
582 cc9bf8f2 2021-11-05 op <dd>Execute an internal command.</dd>
583 cc9bf8f2 2021-11-05 op <dt id="kill-telescope"><a class="permalink" href="#kill-telescope"><code class="Ic">kill-telescope</code></a></dt>
584 cc9bf8f2 2021-11-05 op <dd>Quit <code class="Nm">telescope</code>.</dd>
585 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>
586 cc9bf8f2 2021-11-05 op <dd>Increment fill-column by two.</dd>
587 cc9bf8f2 2021-11-05 op <dt id="link-select"><a class="permalink" href="#link-select"><code class="Ic">link-select</code></a></dt>
588 cc9bf8f2 2021-11-05 op <dd>Select and visit a link using the minibuffer.</dd>
589 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>
590 cc9bf8f2 2021-11-05 op <dd>Edit the current URL.</dd>
591 cc9bf8f2 2021-11-05 op <dt id="load-url"><a class="permalink" href="#load-url"><code class="Ic">load-url</code></a></dt>
592 cc9bf8f2 2021-11-05 op <dd>Prompt for an URL.</dd>
593 cc9bf8f2 2021-11-05 op <dt id="next-page"><a class="permalink" href="#next-page"><code class="Ic">next-page</code></a></dt>
594 cc9bf8f2 2021-11-05 op <dd>Go forward in the page history.</dd>
595 cc9bf8f2 2021-11-05 op <dt id="olivetti-mode"><a class="permalink" href="#olivetti-mode"><code class="Ic">olivetti-mode</code></a></dt>
596 cc9bf8f2 2021-11-05 op <dd>Toggle olivetti mode (i.e. horizontal centering of the lines of the
597 cc9bf8f2 2021-11-05 op window.)</dd>
598 cc9bf8f2 2021-11-05 op <dt id="other-window"><a class="permalink" href="#other-window"><code class="Ic">other-window</code></a></dt>
599 cc9bf8f2 2021-11-05 op <dd>Select the other window.</dd>
600 cc9bf8f2 2021-11-05 op <dt id="previous-page"><a class="permalink" href="#previous-page"><code class="Ic">previous-page</code></a></dt>
601 cc9bf8f2 2021-11-05 op <dd>Go backward in the page history.</dd>
602 cc9bf8f2 2021-11-05 op <dt id="push-button"><a class="permalink" href="#push-button"><code class="Ic">push-button</code></a></dt>
603 cc9bf8f2 2021-11-05 op <dd>Follow link at point, or toggle the visibility of the following
604 cc9bf8f2 2021-11-05 op preformatted block if called when the cursor is on the heading of the
606 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>
607 cc9bf8f2 2021-11-05 op <dd>Follow link at point in a new tab.</dd>
608 cc9bf8f2 2021-11-05 op <dt id="redraw"><a class="permalink" href="#redraw"><code class="Ic">redraw</code></a></dt>
609 cc9bf8f2 2021-11-05 op <dd>Redraw the screen, useful if some background program messed up the
610 cc9bf8f2 2021-11-05 op display.</dd>
611 cc9bf8f2 2021-11-05 op <dt id="reload-page"><a class="permalink" href="#reload-page"><code class="Ic">reload-page</code></a></dt>
612 cc9bf8f2 2021-11-05 op <dd>Reload the current page.</dd>
613 cc9bf8f2 2021-11-05 op <dt id="scroll-down"><a class="permalink" href="#scroll-down"><code class="Ic">scroll-down</code></a></dt>
614 cc9bf8f2 2021-11-05 op <dd>Scroll down by one visual page.</dd>
615 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>
616 cc9bf8f2 2021-11-05 op <dd>Scroll down by one line.</dd>
617 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>
618 cc9bf8f2 2021-11-05 op <dd>Scroll up by one line.</dd>
619 cc9bf8f2 2021-11-05 op <dt id="scroll-up"><a class="permalink" href="#scroll-up"><code class="Ic">scroll-up</code></a></dt>
620 cc9bf8f2 2021-11-05 op <dd>Scroll up by one visual page.</dd>
621 cc9bf8f2 2021-11-05 op <dt id="suspend-telescope"><a class="permalink" href="#suspend-telescope"><code class="Ic">suspend-telescope</code></a></dt>
622 cc9bf8f2 2021-11-05 op <dd>Suspend the current <code class="Nm">telescope</code> session.</dd>
623 cc9bf8f2 2021-11-05 op <dt id="swiper"><a class="permalink" href="#swiper"><code class="Ic">swiper</code></a></dt>
624 cc9bf8f2 2021-11-05 op <dd>Jump to a line using the minibuffer.</dd>
625 cc9bf8f2 2021-11-05 op <dt id="toc"><a class="permalink" href="#toc"><code class="Ic">toc</code></a></dt>
626 cc9bf8f2 2021-11-05 op <dd>Jump to a heading using the minibuffer.</dd>
627 cc9bf8f2 2021-11-05 op <dt id="toggle-help"><a class="permalink" href="#toggle-help"><code class="Ic">toggle-help</code></a></dt>
628 cc9bf8f2 2021-11-05 op <dd>Toggle side window with help about available keys and their associated
629 cc9bf8f2 2021-11-05 op interactive command.</dd>
630 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>
631 cc9bf8f2 2021-11-05 op <dd>Toggle the wrapping of preformatted blocks.</dd>
634 cc9bf8f2 2021-11-05 op <section class="Ss">
635 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Minibuffer_commands"><a class="permalink" href="#Minibuffer_commands">Minibuffer
636 cc9bf8f2 2021-11-05 op commands</a></h2>
637 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
638 cc9bf8f2 2021-11-05 op <dt id="mini-abort"><a class="permalink" href="#mini-abort"><code class="Ic">mini-abort</code></a></dt>
639 cc9bf8f2 2021-11-05 op <dd>Abort the current minibuffer action.</dd>
640 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>
641 cc9bf8f2 2021-11-05 op <dd>Complete the current minibuffer action.</dd>
642 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>
643 cc9bf8f2 2021-11-05 op <dd>Delete the character before the point.</dd>
644 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>
645 cc9bf8f2 2021-11-05 op <dd>Delete the character after the point.</dd>
646 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>
647 cc9bf8f2 2021-11-05 op <dd>Select the first completion, if any.</dd>
648 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>
649 cc9bf8f2 2021-11-05 op <dd>Select the last completion, if any.</dd>
650 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>
651 cc9bf8f2 2021-11-05 op <dd>Delete from point until the end of the line.</dd>
652 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>
653 cc9bf8f2 2021-11-05 op <dd>Load the previous history element.</dd>
654 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>
655 cc9bf8f2 2021-11-05 op <dd>Load the next history element.</dd>
658 cc9bf8f2 2021-11-05 op <section class="Ss">
659 cc9bf8f2 2021-11-05 op <h2 class="Ss" id="Aliases"><a class="permalink" href="#Aliases">Aliases</a></h2>
660 cc9bf8f2 2021-11-05 op <p class="Pp">The following aliases are available during
661 cc9bf8f2 2021-11-05 op <code class="Ic">execute-extended-command</code>:</p>
662 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
663 cc9bf8f2 2021-11-05 op <dt id="tabn"><a class="permalink" href="#tabn"><code class="Ic">tabn</code></a></dt>
664 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>
665 cc9bf8f2 2021-11-05 op <dt id="tabnew"><a class="permalink" href="#tabnew"><code class="Ic">tabnew</code></a></dt>
666 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>
667 cc9bf8f2 2021-11-05 op <dt id="tabp"><a class="permalink" href="#tabp"><code class="Ic">tabp</code></a></dt>
668 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>
669 cc9bf8f2 2021-11-05 op <dt id="q"><a class="permalink" href="#q"><code class="Ic">q</code></a>
670 cc9bf8f2 2021-11-05 op <span class="No">and</span> <code class="Ic">wq</code></dt>
671 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>
675 cc9bf8f2 2021-11-05 op <section class="Sh">
676 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="CONFIGURATION_FILE"><a class="permalink" href="#CONFIGURATION_FILE">CONFIGURATION
677 cc9bf8f2 2021-11-05 op FILE</a></h1>
678 cc9bf8f2 2021-11-05 op <p class="Pp">During the startup, <code class="Nm">telescope</code> reads the
679 cc9bf8f2 2021-11-05 op configuration file at <span class="Pa">~/.telescope/config</span> or the one
680 cc9bf8f2 2021-11-05 op given with the <code class="Fl">-c</code> flag.</p>
681 cc9bf8f2 2021-11-05 op <p class="Pp"><code class="Nm">telescope</code> will also load a file called
682 cc9bf8f2 2021-11-05 op <span class="Pa">config-TERM</span>, where “TERM” is the name
683 cc9bf8f2 2021-11-05 op of the terminal type (i.e. the TERM environment variable), if it exists.</p>
684 cc9bf8f2 2021-11-05 op <p class="Pp">The format of the configuration file is fairly flexible. The
685 cc9bf8f2 2021-11-05 op current line can be extended over multiple ones using a backslash
686 cc9bf8f2 2021-11-05 op (‘\’). Comments can be put anywhere in the file using a hash
687 cc9bf8f2 2021-11-05 op mark (‘#’), and extend to the end of the current line, but
688 cc9bf8f2 2021-11-05 op backslashes can't be used to extend comments over multiple lines.</p>
689 cc9bf8f2 2021-11-05 op <p class="Pp">The following constructs are available:</p>
690 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
691 cc9bf8f2 2021-11-05 op <dt id="bind"><a class="permalink" href="#bind"><code class="Ic">bind</code></a>
692 cc9bf8f2 2021-11-05 op <var class="Ar">map</var> <var class="Ar">key</var>
693 cc9bf8f2 2021-11-05 op <var class="Ar">cmd</var></dt>
694 cc9bf8f2 2021-11-05 op <dd>Bind <var class="Ar">key</var> to the function <var class="Ar">cmd</var>
695 cc9bf8f2 2021-11-05 op in the keymap <var class="Ar">map</var>. Valid values for map are
696 cc9bf8f2 2021-11-05 op “global-map” (i.e. when the user is viewing a page) and
697 cc9bf8f2 2021-11-05 op “minibuffer-map” (i.e. when the minibuffer has the focus.)
698 cc9bf8f2 2021-11-05 op <var class="Ar">key</var> follows the same syntax described in
699 cc9bf8f2 2021-11-05 op <a class="Sx" href="#DEFAULT_KEY_BINDINGS">DEFAULT KEY BINDINGS</a> and
700 cc9bf8f2 2021-11-05 op all the possible functions are listed in
701 cc9bf8f2 2021-11-05 op <a class="Sx" href="#INTERACTIVE_COMMANDS">INTERACTIVE COMMANDS</a>.</dd>
702 cc9bf8f2 2021-11-05 op <dt id="proxy"><a class="permalink" href="#proxy"><code class="Ic">proxy</code></a>
703 cc9bf8f2 2021-11-05 op <var class="Ar">proto</var> <code class="Ic">via</code>
704 cc9bf8f2 2021-11-05 op <var class="Ar">url</var></dt>
705 cc9bf8f2 2021-11-05 op <dd>Use <var class="Ar">url</var> as proxy for all URLs with protocol
706 cc9bf8f2 2021-11-05 op <var class="Ar">proto</var>. <var class="Ar">url</var> must be a Gemini
707 cc9bf8f2 2021-11-05 op URI without path, query and fragment component.</dd>
708 cc9bf8f2 2021-11-05 op <dt id="set"><a class="permalink" href="#set"><code class="Ic">set</code></a>
709 cc9bf8f2 2021-11-05 op <var class="Ar">opt</var> <span class="No">=</span>
710 cc9bf8f2 2021-11-05 op <var class="Ar">val</var></dt>
711 cc9bf8f2 2021-11-05 op <dd>Set the option <var class="Ar">opt</var> to the value
712 cc9bf8f2 2021-11-05 op <var class="Ar">val</var>. Valid options are:
713 cc9bf8f2 2021-11-05 op <p class="Pp"></p>
714 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
715 cc9bf8f2 2021-11-05 op <dt>autosave</dt>
716 cc9bf8f2 2021-11-05 op <dd>(integer) If greater than zero, save the session after the specified
717 cc9bf8f2 2021-11-05 op amount of seconds after some events happens (new or closed tabs,
718 cc9bf8f2 2021-11-05 op visited a link ...) Defaults to 20.</dd>
719 cc9bf8f2 2021-11-05 op <dt>dont-wrap-pre</dt>
720 cc9bf8f2 2021-11-05 op <dd>(integer) If nonzero, don't wrap preformatted blocks. Defaults to
722 cc9bf8f2 2021-11-05 op <dt>emojify-link</dt>
723 cc9bf8f2 2021-11-05 op <dd>(integer) If nonzero, when the text of a link starts with an emoji
724 cc9bf8f2 2021-11-05 op followed by a space, use that emoji as line prefix. Defaults to
726 cc9bf8f2 2021-11-05 op <dt>enable-colors</dt>
727 cc9bf8f2 2021-11-05 op <dd>(integer) If nonzero, enable colours. Defaults to 0 if
728 cc9bf8f2 2021-11-05 op <code class="Ev">NO_COLORS</code> is set, 1 otherwise.</dd>
729 cc9bf8f2 2021-11-05 op <dt>fill-column</dt>
730 cc9bf8f2 2021-11-05 op <dd>(integer) If greater than zero, lines of text will be formatted in a
731 cc9bf8f2 2021-11-05 op way that don't exceed the given number of columns. Defaults to
733 cc9bf8f2 2021-11-05 op <dt>hide-pre-blocks</dt>
734 cc9bf8f2 2021-11-05 op <dd>(integer) If nonzero, hide by default the body of the preformatted
735 cc9bf8f2 2021-11-05 op blocks. Defaults to zero. <code class="Ic">push-button</code> can be
736 cc9bf8f2 2021-11-05 op used to toggle the visibility per-block.</dd>
737 cc9bf8f2 2021-11-05 op <dt>hide-pre-closing-line</dt>
738 cc9bf8f2 2021-11-05 op <dd>(integer) If nonzero, hide the closing line of preformatted blocks.
739 cc9bf8f2 2021-11-05 op Defaults to 0.</dd>
740 cc9bf8f2 2021-11-05 op <dt>hide-pre-context</dt>
741 cc9bf8f2 2021-11-05 op <dd>(integer) If nonzero, hide the start and end line of the preformatted
742 cc9bf8f2 2021-11-05 op blocks. If both hide-pre-context and hide-pre-blocks are nonzero,
743 cc9bf8f2 2021-11-05 op preformatted blocks are irremediably hidden. Defaults to zero.</dd>
744 cc9bf8f2 2021-11-05 op <dt>new-tab-url</dt>
745 cc9bf8f2 2021-11-05 op <dd>(string) URL for the new tab page. Defaults to
746 cc9bf8f2 2021-11-05 op “about:new”.</dd>
747 cc9bf8f2 2021-11-05 op <dt>olivetti-mode</dt>
748 cc9bf8f2 2021-11-05 op <dd>(integer) If nonzero, enable <code class="Ic">olivetti-mode</code>
749 cc9bf8f2 2021-11-05 op Defaults to 1.</dd>
750 cc9bf8f2 2021-11-05 op <dt>set-title</dt>
751 cc9bf8f2 2021-11-05 op <dd>(integer) If nonzero, set the terminal title to the page title.
752 cc9bf8f2 2021-11-05 op Defaults to 1.</dd>
753 cc9bf8f2 2021-11-05 op <dt>tab-bar-show</dt>
754 cc9bf8f2 2021-11-05 op <dd>(integer) If tab-bar-show is -1 hide the tab bar permanently, if 0
755 cc9bf8f2 2021-11-05 op show it unconditionally. If it's 1, show the bar only when there is
756 cc9bf8f2 2021-11-05 op more than one tab. Defaults to 1.</dd>
759 cc9bf8f2 2021-11-05 op <dt id="style"><a class="permalink" href="#style"><code class="Ic">style</code></a>
760 cc9bf8f2 2021-11-05 op <var class="Ar">name</var> <var class="Ar">option</var></dt>
761 cc9bf8f2 2021-11-05 op <dd>Change the styling of the element identified by
762 cc9bf8f2 2021-11-05 op <var class="Ar">name</var>. Multiple options may be specified within curly
763 cc9bf8f2 2021-11-05 op braces. Valid style identifiers are:
764 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
765 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
766 cc9bf8f2 2021-11-05 op <dt>line</dt>
767 cc9bf8f2 2021-11-05 op <dd>the area outside the lines in the body of the page.</dd>
768 cc9bf8f2 2021-11-05 op <dt>line.compl</dt>
769 cc9bf8f2 2021-11-05 op <dd>the completions.</dd>
770 cc9bf8f2 2021-11-05 op <dt>line.compl.current</dt>
771 cc9bf8f2 2021-11-05 op <dd>the current completion.</dd>
772 cc9bf8f2 2021-11-05 op <dt>line.help</dt>
773 cc9bf8f2 2021-11-05 op <dd>text in the *Help* buffer.</dd>
774 cc9bf8f2 2021-11-05 op <dt>line.text</dt>
775 cc9bf8f2 2021-11-05 op <dd>text lines.</dd>
776 cc9bf8f2 2021-11-05 op <dt>line.link</dt>
777 cc9bf8f2 2021-11-05 op <dd>link lines.</dd>
778 cc9bf8f2 2021-11-05 op <dt>line.title1..3</dt>
779 cc9bf8f2 2021-11-05 op <dd>headings</dd>
780 cc9bf8f2 2021-11-05 op <dt>line.item</dt>
781 cc9bf8f2 2021-11-05 op <dd>item lines.</dd>
782 cc9bf8f2 2021-11-05 op <dt>line.quote</dt>
783 cc9bf8f2 2021-11-05 op <dd>quotes.</dd>
784 cc9bf8f2 2021-11-05 op <dt>line.pre.start</dt>
785 cc9bf8f2 2021-11-05 op <dd>the heading of a preformatted block.</dd>
786 cc9bf8f2 2021-11-05 op <dt>line.pre</dt>
787 cc9bf8f2 2021-11-05 op <dd>the content of a preformatted block.</dd>
788 cc9bf8f2 2021-11-05 op <dt>line.pre.end</dt>
789 cc9bf8f2 2021-11-05 op <dd>the closing line of a preformatted block.</dd>
790 cc9bf8f2 2021-11-05 op <dt>minibuffer</dt>
791 cc9bf8f2 2021-11-05 op <dd>the minibuffer.</dd>
792 cc9bf8f2 2021-11-05 op <dt>modeline</dt>
793 cc9bf8f2 2021-11-05 op <dd>the modeline.</dd>
794 cc9bf8f2 2021-11-05 op <dt>tabline</dt>
795 cc9bf8f2 2021-11-05 op <dd>the tabline.</dd>
796 cc9bf8f2 2021-11-05 op <dt>tabline.tab</dt>
797 cc9bf8f2 2021-11-05 op <dd>the non-focused tabs.</dd>
798 cc9bf8f2 2021-11-05 op <dt>tabline.current</dt>
799 cc9bf8f2 2021-11-05 op <dd>the focused tab.</dd>
802 cc9bf8f2 2021-11-05 op <p class="Pp">Valid options are:</p>
803 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
804 cc9bf8f2 2021-11-05 op <dt id="attr"><a class="permalink" href="#attr"><code class="Ic">attr</code></a>
805 cc9bf8f2 2021-11-05 op <var class="Ar">prefix</var> [<var class="Ar">line</var>
806 cc9bf8f2 2021-11-05 op [<var class="Ar">trail</var>]]</dt>
807 cc9bf8f2 2021-11-05 op <dd>Sets the text attributes. If only one value is given,
808 cc9bf8f2 2021-11-05 op <var class="Ar">line</var> and <var class="Ar">trail</var> default to
809 cc9bf8f2 2021-11-05 op that; if two values are given then <var class="Ar">trail</var>
810 cc9bf8f2 2021-11-05 op defaults to <var class="Ar">prefix</var>. Each attribute is a
811 cc9bf8f2 2021-11-05 op comma-separated list of keywords:
812 cc9bf8f2 2021-11-05 op <div class="Bd-indent">
813 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
814 cc9bf8f2 2021-11-05 op <dt id="normal"><a class="permalink" href="#normal"><code class="Ic">normal</code></a></dt>
815 cc9bf8f2 2021-11-05 op <dd>no attributes.</dd>
816 cc9bf8f2 2021-11-05 op <dt id="standout"><a class="permalink" href="#standout"><code class="Ic">standout</code></a></dt>
817 cc9bf8f2 2021-11-05 op <dd>best highlighting mode for the terminal.</dd>
818 cc9bf8f2 2021-11-05 op <dt id="underline"><a class="permalink" href="#underline"><code class="Ic">underline</code></a></dt>
819 cc9bf8f2 2021-11-05 op <dd>underlines the text.</dd>
820 cc9bf8f2 2021-11-05 op <dt id="reverse"><a class="permalink" href="#reverse"><code class="Ic">reverse</code></a></dt>
821 cc9bf8f2 2021-11-05 op <dd>reverses background/foreground colors.</dd>
822 cc9bf8f2 2021-11-05 op <dt id="blink"><a class="permalink" href="#blink"><code class="Ic">blink</code></a></dt>
823 cc9bf8f2 2021-11-05 op <dd>makes the text blinking.</dd>
824 cc9bf8f2 2021-11-05 op <dt id="dim"><a class="permalink" href="#dim"><code class="Ic">dim</code></a></dt>
825 cc9bf8f2 2021-11-05 op <dd>half bright.</dd>
826 cc9bf8f2 2021-11-05 op <dt id="bold"><a class="permalink" href="#bold"><code class="Ic">bold</code></a></dt>
827 cc9bf8f2 2021-11-05 op <dd>extra bright or bold.</dd>
830 cc9bf8f2 2021-11-05 op <p class="Pp">Only the style identifiers with the “line.”
831 cc9bf8f2 2021-11-05 op prefix accept up to three attributes. The other will only use the
832 cc9bf8f2 2021-11-05 op first one given.</p>
834 cc9bf8f2 2021-11-05 op <dt id="bg"><a class="permalink" href="#bg"><code class="Ic">bg</code></a>
835 cc9bf8f2 2021-11-05 op <var class="Ar">prefix</var> [<var class="Ar">line</var>
836 cc9bf8f2 2021-11-05 op [<var class="Ar">trail</var>]]</dt>
837 cc9bf8f2 2021-11-05 op <dd>Sets the background color. Follows the same behaviour as
838 cc9bf8f2 2021-11-05 op <code class="Ic">attr</code> regarding the optional parameters. The
839 cc9bf8f2 2021-11-05 op colour is one of black, red, green, yellow, blue, magenta, cyan and
840 cc9bf8f2 2021-11-05 op white; colour0 to colour255 (or color0 to color255) from the
841 cc9bf8f2 2021-11-05 op 256-colour set; default for the default colour.</dd>
842 cc9bf8f2 2021-11-05 op <dt id="fg"><a class="permalink" href="#fg"><code class="Ic">fg</code></a>
843 cc9bf8f2 2021-11-05 op <var class="Ar">prefix</var> [<var class="Ar">line</var>
844 cc9bf8f2 2021-11-05 op [<var class="Ar">trail</var>]]</dt>
845 cc9bf8f2 2021-11-05 op <dd>Sets the foreground color. It behaves just like
846 cc9bf8f2 2021-11-05 op <code class="Ic">bg</code>.</dd>
847 cc9bf8f2 2021-11-05 op <dt id="prefix"><a class="permalink" href="#prefix"><code class="Ic">prefix</code></a>
848 cc9bf8f2 2021-11-05 op <var class="Ar">prfx</var> [<var class="Ar">cont</var>]</dt>
849 cc9bf8f2 2021-11-05 op <dd>Sets the prefix for the current line type to
850 cc9bf8f2 2021-11-05 op <var class="Ar">prfx</var> and <var class="Ar">cont</var> as the
851 cc9bf8f2 2021-11-05 op prefix for the continuation lines (i.e. when a long line gets
852 cc9bf8f2 2021-11-05 op wrapped.) If <var class="Ar">cont</var> is not given its value will be
853 cc9bf8f2 2021-11-05 op the same of <var class="Ar">prfx</var>.</dd>
858 cc9bf8f2 2021-11-05 op <section class="Sh">
859 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="ENVIRONMENT"><a class="permalink" href="#ENVIRONMENT">ENVIRONMENT</a></h1>
860 cc9bf8f2 2021-11-05 op <p class="Pp">When <code class="Nm">telescope</code> is started, it inspects the
861 cc9bf8f2 2021-11-05 op following environment variables:</p>
862 cc9bf8f2 2021-11-05 op <dl class="Bl-tag">
863 cc9bf8f2 2021-11-05 op <dt id="HOME"><a class="permalink" href="#HOME"><code class="Ev">HOME</code></a></dt>
864 cc9bf8f2 2021-11-05 op <dd>The user's login directory.</dd>
865 cc9bf8f2 2021-11-05 op <dt id="NO_COLORS"><a class="permalink" href="#NO_COLORS"><code class="Ev">NO_COLORS</code></a></dt>
866 cc9bf8f2 2021-11-05 op <dd>To decide whether to use colors or not. The content of the variable
867 cc9bf8f2 2021-11-05 op doesn't matter.</dd>
868 cc9bf8f2 2021-11-05 op <dt id="TERM"><a class="permalink" href="#TERM"><code class="Ev">TERM</code></a></dt>
869 cc9bf8f2 2021-11-05 op <dd>The user's terminal name.</dd>
872 cc9bf8f2 2021-11-05 op <section class="Sh">
873 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
874 cc9bf8f2 2021-11-05 op <dl class="Bl-tag Bl-compact">
875 cc9bf8f2 2021-11-05 op <dt><span class="Pa">~/.telescope/bookmarks.gmi</span></dt>
876 cc9bf8f2 2021-11-05 op <dd>Bookmarks file.</dd>
877 cc9bf8f2 2021-11-05 op <dt><span class="Pa">~/.telescope/config</span></dt>
878 cc9bf8f2 2021-11-05 op <dd>Default configuration file.</dd>
879 cc9bf8f2 2021-11-05 op <dt><span class="Pa">~/.telescope/known_hosts</span></dt>
880 cc9bf8f2 2021-11-05 op <dd>Hash of the certificates for all the known hosts. Each line contains three
881 cc9bf8f2 2021-11-05 op fields: hostname with optional port number, hash of the certificate and a
882 cc9bf8f2 2021-11-05 op numeric flag.</dd>
883 cc9bf8f2 2021-11-05 op <dt><span class="Pa">~/.telescope/lock</span></dt>
884 cc9bf8f2 2021-11-05 op <dd>Lock file used to prevent multiple instance of
885 cc9bf8f2 2021-11-05 op <code class="Nm">telescope</code> from running at the same time.</dd>
886 cc9bf8f2 2021-11-05 op <dt><span class="Pa">~/.telescope/pages/about_*.gmi</span></dt>
887 cc9bf8f2 2021-11-05 op <dd>Overrides for built-in about: pages.</dd>
888 cc9bf8f2 2021-11-05 op <dt><span class="Pa">~/.telescope/session</span></dt>
889 cc9bf8f2 2021-11-05 op <dd>The list of tabs from the last session. Every line identifies a tab and
890 cc9bf8f2 2021-11-05 op contains three space-separated fields: the full URL, a comma-separated
891 cc9bf8f2 2021-11-05 op list of attributes and the cached title. Is written by
892 cc9bf8f2 2021-11-05 op <code class="Ic">kill-telescope</code> and loaded during startup.</dd>
895 cc9bf8f2 2021-11-05 op <section class="Sh">
896 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
897 cc9bf8f2 2021-11-05 op <p class="Pp">It's possible to browse “the small web” (i.e. simple
898 cc9bf8f2 2021-11-05 op websites) by using programs like the duckling-proxy by defining a proxy in
899 cc9bf8f2 2021-11-05 op <span class="Pa">~/.telescope/config</span>:</p>
900 cc9bf8f2 2021-11-05 op <div class="Bd Pp Bd-indent Li">
901 cc9bf8f2 2021-11-05 op <pre>proxy http via "gemini://127.0.0.1:1965"
902 cc9bf8f2 2021-11-05 op proxy https via "gemini://127.0.0.1:1965"</pre>
904 cc9bf8f2 2021-11-05 op <p class="Pp">To load <code class="Nm">telescope</code> without any
905 cc9bf8f2 2021-11-05 op configuration</p>
906 cc9bf8f2 2021-11-05 op <div class="Bd Pp Bd-indent Li">
907 cc9bf8f2 2021-11-05 op <pre>telescope -c /dev/null</pre>
910 cc9bf8f2 2021-11-05 op <section class="Sh">
911 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
912 cc9bf8f2 2021-11-05 op <p class="Pp">The <code class="Nm">telescope</code> program was written by
913 cc9bf8f2 2021-11-05 op <span class="An">Omar Polo</span>
914 cc9bf8f2 2021-11-05 op <<a class="Mt" href="mailto:op@omarpolo.com">op@omarpolo.com</a>>.</p>
916 cc9bf8f2 2021-11-05 op <section class="Sh">
917 cc9bf8f2 2021-11-05 op <h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
918 cc9bf8f2 2021-11-05 op <p class="Pp">There's no UI for out-of-band certificates validation.</p>
921 cc9bf8f2 2021-11-05 op <table class="foot">
923 cc9bf8f2 2021-11-05 op <td class="foot-date">August 27, 2021</td>
924 cc9bf8f2 2021-11-05 op <td class="foot-os">OpenBSD 7.0</td>
