Blame
Date:
Fri Apr 15 09:13:28 2022 UTC
Message:
add mini-kill-whole-line
0001
2021-01-02
op
.\" Copyright (c) 2021, 2022 Omar Polo <op@omarpolo.com>
0002
2021-03-28
op
.\"
0003
2021-03-28
op
.\" Permission to use, copy, modify, and distribute this software for any
0004
2021-03-28
op
.\" purpose with or without fee is hereby granted, provided that the above
0005
2021-03-28
op
.\" copyright notice and this permission notice appear in all copies.
0006
2021-03-28
op
.\"
0007
2021-03-28
op
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
0008
2021-03-28
op
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
0009
2021-03-28
op
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
0010
2021-03-28
op
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
0011
2021-03-28
op
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
0012
2021-03-28
op
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
0013
2021-03-28
op
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
0014
2022-01-05
op
.Dd $Mdocdate: January 05 2022$
0015
2021-03-28
op
.Dt TELESCOPE 1
0016
2021-03-28
op
.Os
0017
2021-03-28
op
.Sh NAME
0018
2021-03-28
op
.Nm telescope
0019
2021-08-03
op
.Nd multi-protocol browser
0020
2021-03-28
op
.Sh SYNOPSIS
0021
2021-03-28
op
.Nm
0022
2021-03-28
op
.Bk -words
0023
2021-09-15
op
.Op Fl ChnSv
0024
2021-11-29
op
.Op Fl c Ar config
0025
2021-03-28
op
.Op Ar URL
0026
2021-03-28
op
.Ek
0027
2021-03-28
op
.Sh DESCRIPTION
0028
2021-03-28
op
.Nm
0029
2021-08-03
op
is an interactive browser that supports the Finger, Gemini and Gopher
0030
2021-08-03
op
protocols.
0031
2021-03-28
op
.Nm
0032
2021-08-03
op
features tabs, a minibuffer, interactive completions, bookmarks and
0033
2021-08-03
op
out-of-band TOFU verification.
0034
2021-06-15
op
.Pp
0035
2021-06-15
op
The arguments are as follows:
0036
2021-07-15
op
.Bl -tag -width xxxxxxxxxxxxx
0037
2021-01-02
op
.It Fl C , Fl -colours
0038
2021-07-15
op
Show all available colors and exit.
0039
2021-01-02
op
This option can also be spelled
0040
2021-01-02
op
.Fl -colors .
0041
2021-11-29
op
.It Fl c Ar config
0042
2021-06-15
op
Specify an alternative configuration file.
0043
2021-06-15
op
By default
0044
2021-11-29
op
.Pa ~/.config/telescope/config
0045
2021-06-15
op
is loaded.
0046
2021-07-15
op
.It Fl h , Fl -help
0047
2022-01-06
op
Display version, usage and exit.
0048
2021-07-15
op
.It Fl n
0049
2021-07-15
op
Configtest mode.
0050
2021-07-15
op
Only check the configuration file for validity.
0051
2021-09-15
op
.It Fl S , Fl -safe
0052
2021-09-15
op
.Dq Safe
0053
2021-09-15
op
.Pq or Dq sandbox
0054
2021-09-15
op
mode.
0055
2021-09-15
op
Prevent
0056
2021-09-15
op
.Nm
0057
2021-09-15
op
from writing files to the disk and to acquire the lock, allowing to
0058
2021-09-15
op
run multiple instances at the same time.
0059
2021-09-15
op
.Nm
0060
2021-09-15
op
still loads the session file and the custom about pages.
0061
2021-07-15
op
.It Fl v , Fl -version
0062
2022-01-06
op
Display version and exit.
0063
2021-06-15
op
.El
0064
2021-07-21
op
.Sh UI CONCEPTS
0065
2021-07-21
op
.Nm
0066
2021-07-21
op
interface is divided into four areas: the tabline, the body, the
0067
2021-07-21
op
modeline and the echoarea/minibuffer.
0068
2021-07-21
op
.Pp
0069
2021-07-21
op
The tabline is always at the top of the screen and displays the tabs
0070
2021-07-21
op
separated by a vertical line.
0071
2021-07-21
op
When there are more tabs than the size of the window allow to display,
0072
2021-07-21
op
the characters
0073
2021-07-21
op
.Sq \&<
0074
2021-07-21
op
or
0075
2021-07-21
op
.Sq \&>
0076
2021-07-21
op
are shown at the start/end of the tabline to indicate that there are
0077
2021-07-21
op
more tabs in that direction.
0078
2021-07-21
op
.Pp
0079
2021-07-21
op
The body occupies the majority of the visible area.
0080
2021-07-21
op
It contains the current page and optionally a side window.
0081
2021-07-21
op
.Pp
0082
2021-07-21
op
The modeline is the second to last row of the screen.
0083
2021-07-21
op
It shows some information about the page: a spinner when the page is
0084
2021-07-21
op
loading, the trust level, the document type, the scroll offset and the
0085
2021-07-21
op
URL.
0086
2021-07-21
op
.Pp
0087
2021-07-21
op
The echoarea is usually the last line of the screen.
0088
2021-07-21
op
Messages are often showed there, and link addresses too.
0089
2021-07-21
op
The echoarea is also used to obtain input from the user.
0090
2021-07-21
op
When commands like
0091
2021-07-21
op
.Ic swiper
0092
2021-07-21
op
or
0093
2021-07-21
op
.Ic link-select
0094
2021-08-03
op
are invoked, the minibuffer area grows to show possible completions.
0095
2021-03-28
op
.Sh TOFU
0096
2021-03-28
op
.Nm
0097
2021-07-21
op
aims to use the
0098
2021-07-21
op
.Dq Trust, but Verify Pq where appropriate
0099
2021-07-21
op
approach for
0100
2021-07-21
op
TOFU
0101
2021-07-21
op
.Pq Dq Trust On First Use .
0102
2021-03-28
op
The idea is to define three level of verification for a certificate:
0103
2021-03-28
op
.Bl -tag -width 12m
0104
2021-03-28
op
.It untrusted
0105
2021-07-21
op
.Pq Sq \&!
0106
2021-07-21
op
the server fingerprint does NOT match the stored value.
0107
2021-03-28
op
.It trusted
0108
2021-07-21
op
.Pq Sq v
0109
2021-07-21
op
the server fingerprint matches the store one.
0110
2021-03-28
op
.It verified
0111
2021-07-21
op
.Pq Sq V
0112
2021-07-21
op
the fingerprint matches and has been verified out-of-band.
0113
2021-03-28
op
.El
0114
2021-03-28
op
.Pp
0115
2021-07-21
op
The trust level of the page is indicated in the modeline with the
0116
2021-07-21
op
indicated character.
0117
2021-07-21
op
.Pp
0118
2021-03-28
op
Most of the time the
0119
2021-03-28
op
.Dq trusted
0120
2021-03-28
op
level is enough, but where is appropriate users should be able to
0121
2021-03-28
op
verify out-of-band the certificate.
0122
2021-03-28
op
.Pp
0123
2021-03-28
op
At the moment, there is no built-in support for an out-of-band
0124
2021-03-28
op
verification though.
0125
2021-08-13
op
.Sh SUPPORTED PROTOCOLS
0126
2021-08-13
op
The following protocols are supported:
0127
2021-08-13
op
.Bl -tag -width gemini://
0128
2021-08-13
op
.It about:
0129
2021-08-13
op
About pages are
0130
2021-08-03
op
.Nm
0131
2021-08-13
op
internal page.
0132
2021-08-13
op
See about:about for a list of all these pages.
0133
2021-08-13
op
.It file://
0134
2021-08-13
op
File types know to
0135
2021-08-13
op
.Nm ,
0136
2021-08-13
op
such as .gmi, .gemini, .txt, .md, .markdown, .diff or .patch, can be
0137
2021-08-13
op
viewed inside the application.
0138
2021-08-13
op
Types of local files are detected solely based on the file extension.
0139
2021-08-13
op
On some systems, such as
0140
2021-08-13
op
.Ox ,
0141
2021-08-13
op
only files inside special directories
0142
2021-08-13
op
.Pq like Pa /tmp No or Pa ~/Downloads
0143
2021-08-13
op
are available.
0144
2021-08-13
op
.It finger://
0145
2021-08-13
op
Finger URLs are interpreted as follows:
0146
2021-08-03
op
.Bl -bullet -compact
0147
2021-08-03
op
.It
0148
2021-08-03
op
the host is determined by the host name portion of the URL
0149
2021-08-03
op
.It
0150
2021-08-03
op
if the user portion of the URL is provided, it's interpreted as the
0151
2021-08-03
op
user to finger, otherwise the path component will be used
0152
2021-08-03
op
.El
0153
2021-08-03
op
thus
0154
2021-08-03
op
.Lk finger://user@hostname
0155
2021-08-03
op
and
0156
2021-08-03
op
.Lk finger://hostname/user
0157
2021-08-13
op
are treated as the same URL.
0158
2021-08-13
op
.It gemini://
0159
2021-08-13
op
Gemini is fully supported, with the exception of client-certificates.
0160
2021-08-13
op
.It gopher://
0161
2021-08-03
op
Gopher support is limited to items type 0, 1 and 7.
0162
2021-08-03
op
All text is assumed to be encoded in UTF-8 (or ASCII).
0163
2021-08-13
op
.El
0164
2021-08-16
op
.Pp
0165
2021-08-16
op
User-entered URLs, given as argument on the command line or entered
0166
2021-08-16
op
with
0167
2021-08-16
op
.Ic load-url ,
0168
2021-08-16
op
are intepreted with a simple heuristic:
0169
2021-08-16
op
.Bl -bullet -compact
0170
2021-08-16
op
.It
0171
2021-08-16
op
if it's a proper absolute URL then use it as-is,
0172
2021-08-16
op
.It
0173
2021-08-16
op
if it starts with
0174
2021-08-16
op
.Dq ./
0175
2021-08-16
op
or
0176
2021-08-16
op
.Dq /
0177
2021-08-16
op
assume it's a file:// URL,
0178
2021-08-16
op
.It
0179
2021-08-16
op
otherwise assume it's a Gemini URL.
0180
2021-10-08
op
.El
0181
2021-10-08
op
.Sh CONFIGURATION FILE
0182
2021-10-08
op
During the startup,
0183
2021-10-08
op
.Nm
0184
2021-10-08
op
reads the configuration file at
0185
2021-10-08
op
.Pa ~/.config/telescope/config
0186
2021-10-08
op
or
0187
2021-10-08
op
.Pa ~/.telescope/config .
0188
2021-10-08
op
.Pp
0189
2021-10-08
op
It's possible to load a custom configuration file using the
0190
2021-10-08
op
.Fl c
0191
2021-10-08
op
flag.
0192
2021-10-08
op
.Pp
0193
2021-10-08
op
.Nm
0194
2021-10-08
op
will also load a file called
0195
2021-10-08
op
.Pa config-TERM ,
0196
2021-10-08
op
where
0197
2021-10-08
op
.Dq TERM
0198
2021-10-08
op
is the name of the terminal type
0199
2021-10-08
op
.Pq i.e. the TERM environment variable ,
0200
2021-10-08
op
if it exists.
0201
2021-10-08
op
.Pp
0202
2021-10-08
op
The format of the configuration file is fairly flexible.
0203
2021-10-08
op
The current line can be extended over multiple ones using a
0204
2021-10-08
op
backslash
0205
2021-10-08
op
.Pq Sq \e .
0206
2021-10-08
op
Comments can be put anywhere in the file using a hash mark
0207
2021-10-08
op
.Pq Sq # ,
0208
2021-10-08
op
and extend to the end of the current line, but backslashes can't be
0209
2021-10-08
op
used to extend comments over multiple lines.
0210
2021-10-08
op
.Pp
0211
2021-10-08
op
The following constructs are available:
0212
2021-10-08
op
.Bl -tag -width Ds
0213
2021-10-08
op
.It Ic bind Ar map Ar key Ar cmd
0214
2021-10-08
op
Bind
0215
2021-10-08
op
.Ar key
0216
2021-10-08
op
to the function
0217
2021-10-08
op
.Ar cmd
0218
2021-10-08
op
in the keymap
0219
2021-10-08
op
.Ar map .
0220
2021-10-08
op
Valid values for map are
0221
2021-10-08
op
.Dq global-map
0222
2021-10-08
op
.Pq i.e. when the user is viewing a page
0223
2021-10-08
op
and
0224
2021-10-08
op
.Dq minibuffer-map
0225
2021-10-08
op
.Pq i.e. when the minibuffer has the focus.
0226
2021-10-08
op
.Ar key
0227
2021-10-08
op
follows the same syntax described in
0228
2021-10-08
op
.Sx DEFAULT KEY BINDINGS
0229
2021-10-08
op
and all the possible functions are listed in
0230
2021-10-08
op
.Sx INTERACTIVE COMMANDS .
0231
2021-10-08
op
.It Ic proxy Ar proto Ic via Ar url
0232
2021-10-08
op
Use
0233
2021-10-08
op
.Ar url
0234
2021-10-08
op
as proxy for all URLs with
0235
2021-10-08
op
protocol
0236
2021-10-08
op
.Ar proto .
0237
2021-10-08
op
.Ar url
0238
2021-10-08
op
must be a Gemini URI without path, query and fragment component.
0239
2021-10-08
op
.It Ic set Ar opt No = Ar val
0240
2021-10-08
op
Set the option
0241
2021-10-08
op
.Ar opt
0242
2021-10-08
op
to the value
0243
2021-10-08
op
.Ar val .
0244
2021-10-08
op
Valid options are:
0245
2021-10-08
op
.Pp
0246
2021-10-08
op
.Bl -tag -width twelveletters -compact
0247
2022-02-26
op
.It Ic autosave
0248
2021-10-08
op
.Pq integer
0249
2021-10-08
op
If greater than zero, save the session after the specified amount of
0250
2021-10-08
op
seconds after some events happens
0251
2021-10-08
op
.Pq new or closed tabs, visited a link ...
0252
2021-10-08
op
Defaults to 20.
0253
2022-02-26
op
.It Ic dont-wrap-pre
0254
2021-10-08
op
.Pq integer
0255
2021-10-08
op
If nonzero, don't wrap preformatted blocks.
0256
2021-10-08
op
Defaults to 0.
0257
2022-02-26
op
.It Ic download-path
0258
2021-10-08
op
.Pq string
0259
2021-10-08
op
The default download path.
0260
2021-10-08
op
Defaults to
0261
2021-10-08
op
.Pa /tmp .
0262
2022-02-26
op
.It Ic emojify-link
0263
2021-10-08
op
.Pq integer
0264
2021-10-08
op
If nonzero, when the text of a link starts with an emoji followed by a
0265
2021-10-08
op
space, use that emoji as line prefix.
0266
2021-10-08
op
Defaults to 1.
0267
2022-02-26
op
.It Ic enable-colors
0268
2021-10-08
op
.Pq integer
0269
2021-10-08
op
If nonzero, enable colours.
0270
2021-10-08
op
Defaults to 0 if
0271
2021-10-08
op
.Ev NO_COLORS
0272
2021-10-08
op
is set, 1 otherwise.
0273
2022-02-26
op
.It Ic fill-column
0274
2021-10-08
op
.Pq integer
0275
2021-10-08
op
If greater than zero, lines of text will be formatted in a way that
0276
2021-10-08
op
don't exceed the given number of columns.
0277
2021-10-08
op
Defaults to 80.
0278
2022-02-26
op
.It Ic fringe-ignore-offset
0279
2022-01-10
op
.Pq integer
0280
2022-01-10
op
If nonzero, the fringe doesn't obey to
0281
2022-01-10
op
.Ic olivetti-mode .
0282
2022-01-10
op
Defaults to 1.
0283
2022-02-26
op
.It Ic hide-pre-blocks
0284
2021-10-08
op
.Pq integer
0285
2021-10-08
op
If nonzero, hide by default the body of the preformatted blocks.
0286
2021-10-08
op
Defaults to zero.
0287
2021-10-08
op
.Ic push-button
0288
2021-10-08
op
can be used to toggle the visibility per-block.
0289
2022-02-26
op
.It Ic hide-pre-closing-line
0290
2021-10-08
op
.Pq integer
0291
2021-10-08
op
If nonzero, hide the closing line of preformatted blocks.
0292
2021-10-08
op
Defaults to 0.
0293
2022-02-26
op
.It Ic hide-pre-context
0294
2021-10-08
op
.Pq integer
0295
2021-10-08
op
If nonzero, hide the start and end line of the preformatted blocks.
0296
2021-10-08
op
If both hide-pre-context and hide-pre-blocks are nonzero, preformatted
0297
2021-10-08
op
blocks are irremediably hidden.
0298
2021-10-08
op
Defaults to zero.
0299
2022-02-26
op
.It Ic new-tab-url
0300
2021-10-08
op
.Pq string
0301
2021-10-08
op
URL for the new tab page.
0302
2021-10-08
op
Defaults to
0303
2021-10-08
op
.Dq about:new .
0304
2022-02-26
op
.It Ic max-killed-tabs
0305
2022-01-05
op
.Pq integer
0306
2022-01-05
op
The maximum number of closed tabs to keep track of, defaults to 10.
0307
2022-01-05
op
Must be a positive number; if zero, don't save closed tabs at all.
0308
2022-02-26
op
.It Ic olivetti-mode
0309
2021-10-08
op
.Pq integer
0310
2021-10-08
op
If nonzero, enable
0311
2021-10-08
op
.Ic olivetti-mode
0312
2021-10-08
op
Defaults to 1.
0313
2022-02-26
op
.It Ic tab-bar-show
0314
2021-10-08
op
.Pq integer
0315
2021-10-08
op
If tab-bar-show is -1 hide the tab bar permanently, if 0 show it
0316
2021-10-08
op
unconditionally.
0317
2021-10-08
op
If it's 1, show the bar only when there is more than one tab.
0318
2022-01-04
op
Defaults to 1.
0319
2022-02-26
op
.It Ic update-title
0320
2022-01-04
op
.Pq integer
0321
2022-01-04
op
If nonzero, set the terminal title to the page title.
0322
2021-10-08
op
Defaults to 1.
0323
2021-10-08
op
.El
0324
2021-10-08
op
.It Ic style Ar name Ar option
0325
2021-10-08
op
Change the styling of the element identified by
0326
2021-10-08
op
.Ar name .
0327
2021-10-08
op
Multiple options may be specified within curly braces.
0328
2021-10-08
op
Valid style identifiers are:
0329
2021-11-05
op
.Bl -tag -width line.download.ongoing -compact -offset Ds
0330
2021-10-08
op
.It line
0331
2021-10-08
op
the area outside the lines in the body of the page.
0332
2021-10-08
op
.It line.compl
0333
2021-10-08
op
the completions.
0334
2021-10-08
op
.It line.compl.current
0335
2021-10-08
op
the current completion.
0336
2021-10-08
op
.It line.help
0337
2021-10-08
op
text in the *Help* buffer.
0338
2021-11-05
op
.It line.download.ongoing
0339
2021-11-05
op
an ongoing download
0340
2021-11-05
op
.It line.download.done
0341
2021-11-05
op
a completed download
0342
2021-11-05
op
.It line.download.info
0343
2021-11-05
op
informational text in the *Downloads* buffer.
0344
2022-01-10
op
.It line.fringe
0345
2022-01-10
op
.Pq virtual
0346
2022-01-10
op
lines draw after the end of a buffer.
0347
2021-10-08
op
.It line.text
0348
2021-10-08
op
text lines.
0349
2021-10-08
op
.It line.link
0350
2021-10-08
op
link lines.
0351
2021-10-08
op
.It line.title1..3
0352
2021-10-08
op
headings
0353
2021-10-08
op
.It line.item
0354
2021-10-08
op
item lines.
0355
2021-10-08
op
.It line.quote
0356
2021-10-08
op
quotes.
0357
2021-10-08
op
.It line.pre.start
0358
2021-10-08
op
the heading of a preformatted block.
0359
2021-10-08
op
.It line.pre
0360
2021-10-08
op
the content of a preformatted block.
0361
2021-10-08
op
.It line.pre.end
0362
2021-10-08
op
the closing line of a preformatted block.
0363
2021-11-05
op
.It download
0364
2021-11-05
op
the download pane
0365
2021-10-08
op
.It minibuffer
0366
2021-10-08
op
the minibuffer.
0367
2021-10-08
op
.It modeline
0368
2021-10-08
op
the modeline.
0369
2021-10-08
op
.It tabline
0370
2021-10-08
op
the tabline.
0371
2021-10-08
op
.It tabline.tab
0372
2021-10-08
op
the non-focused tabs.
0373
2021-10-08
op
.It tabline.current
0374
2021-10-08
op
the focused tab.
0375
2021-10-08
op
.El
0376
2021-10-08
op
.Pp
0377
2021-10-08
op
Valid options are:
0378
2021-10-08
op
.Bl -tag -width Ds
0379
2021-10-08
op
.It Ic attr Ar prefix Oo Ar line Oo Ar trail Oc Oc
0380
2021-10-08
op
Sets the text attributes.
0381
2021-10-08
op
If only one value is given,
0382
2021-10-08
op
.Ar line
0383
2021-10-08
op
and
0384
2021-10-08
op
.Ar trail
0385
2021-10-08
op
default to that; if two values are given then
0386
2021-10-08
op
.Ar trail
0387
2021-10-08
op
defaults to
0388
2021-10-08
op
.Ar prefix .
0389
2021-10-08
op
Each attribute is a comma-separated list of keywords:
0390
2021-10-08
op
.Bl -tag -width underline -compact -offset Ds
0391
2021-10-08
op
.It Ic normal
0392
2021-10-08
op
no attributes.
0393
2021-10-08
op
.It Ic standout
0394
2021-10-08
op
best highlighting mode for the terminal.
0395
2021-10-08
op
.It Ic underline
0396
2021-10-08
op
underlines the text.
0397
2021-10-08
op
.It Ic reverse
0398
2021-10-08
op
reverses background/foreground colors.
0399
2021-10-08
op
.It Ic blink
0400
2021-10-08
op
makes the text blinking.
0401
2021-10-08
op
.It Ic dim
0402
2021-10-08
op
half bright.
0403
2021-10-08
op
.It Ic bold
0404
2021-10-08
op
extra bright or bold.
0405
2021-10-08
op
.El
0406
2021-10-08
op
.Pp
0407
2021-10-08
op
Only the style identifiers with the
0408
2021-10-08
op
.Dq line.
0409
2021-10-08
op
prefix accept up to three attributes.
0410
2021-10-08
op
The other will only use the first one given.
0411
2021-10-08
op
.It Ic bg Ar prefix Oo Ar line Oo Ar trail Oc Oc
0412
2021-10-08
op
Sets the background color.
0413
2021-10-08
op
Follows the same behaviour as
0414
2021-10-08
op
.Ic attr
0415
2021-10-08
op
regarding the optional parameters.
0416
2021-10-08
op
The colour is one of black, red, green, yellow, blue,
0417
2021-10-08
op
magenta, cyan and white; colour0 to colour255
0418
2021-10-08
op
.Pq or color0 to color255
0419
2021-10-08
op
from the 256-colour set;
0420
2021-10-08
op
default for the default colour.
0421
2021-10-08
op
.It Ic fg Ar prefix Oo Ar line Oo Ar trail Oc Oc
0422
2021-10-08
op
Sets the foreground color.
0423
2021-10-08
op
It behaves just like
0424
2021-10-08
op
.Ic bg .
0425
2021-10-08
op
.It Ic prefix Ar prfx Op Ar cont
0426
2021-10-08
op
Sets the prefix for the current line type to
0427
2021-10-08
op
.Ar prfx
0428
2021-10-08
op
and
0429
2021-10-08
op
.Ar cont
0430
2021-10-08
op
as the prefix for the continuation lines
0431
2021-10-08
op
.Pq i.e. when a long line gets wrapped.
0432
2021-10-08
op
If
0433
2021-10-08
op
.Ar cont
0434
2021-10-08
op
is not given its value will be the same of
0435
2021-10-08
op
.Ar prfx .
0436
2021-10-08
op
.El
0437
2021-08-16
op
.El
0438
2021-03-28
op
.Sh DEFAULT KEY BINDINGS
0439
2021-03-28
op
The default key bindings are very similar to GNU Emacs, but care has
0440
2021-03-28
op
been taken to include also bindings familiar for
0441
2021-03-28
op
.Xr vi 1
0442
2021-03-28
op
and
0443
2021-03-28
op
.Dq CUA
0444
2021-03-28
op
users.
0445
2021-03-28
op
In the following examples, C-x means Control-x, M-x means Meta-x,
0446
2021-03-28
op
where the Meta key may be either a special key on the keyboard or the
0447
2021-03-28
op
ALT key; otherwise ESC followed by the key X works as well, and C-M-x
0448
2021-03-28
op
means to press the key X together with both Control and Meta.
0449
2021-03-28
op
.Pp
0450
2021-03-28
op
Keys are usually a single character, like
0451
2021-03-28
op
.Sq p
0452
2021-03-28
op
or
0453
2021-03-28
op
.Sq n ,
0454
2021-03-28
op
but some special keys are accepted as well.
0455
2021-03-28
op
.Pp
0456
2021-03-28
op
.Bl -tag -width 16m -offset indent -compact
0457
2021-03-28
op
.It <up>
0458
2021-03-28
op
Up arrow
0459
2021-03-28
op
.It <down>
0460
2021-03-28
op
Down arrow
0461
2021-03-28
op
.It <left>
0462
2021-03-28
op
Left arrow
0463
2021-03-28
op
.It <right>
0464
2021-03-28
op
Right arrow
0465
2021-03-28
op
.It <prior>
0466
2021-03-28
op
Previous page/Page up
0467
2021-03-28
op
.It <next>
0468
2021-03-28
op
Next page/Page down
0469
2021-03-28
op
.It <home>
0470
2021-03-28
op
Home
0471
2021-03-28
op
.It <end>
0472
2021-03-28
op
End
0473
2021-03-28
op
.It <f0> thru <f63>
0474
2021-03-28
op
Function keys
0475
2021-03-28
op
.It del or backspace
0476
2021-03-28
op
Backspace
0477
2021-03-28
op
.It esc
0478
2021-03-28
op
Escape
0479
2021-03-28
op
.It space or spc
0480
2021-03-28
op
Space
0481
2021-03-28
op
.It enter or ret
0482
2021-03-28
op
Enter
0483
2021-03-28
op
.It tab
0484
2021-03-28
op
Tab
0485
2021-06-15
op
.It backtab
0486
2021-08-03
op
Depends on the configuration of the terminal emulator; usually shift
0487
2021-08-03
op
tab.
0488
2021-03-28
op
.El
0489
2021-03-28
op
.Ss GNU Emacs-like keys
0490
2021-03-28
op
.Bl -tag -width xxxxxxxxxxxx -offset indent -compact
0491
2021-03-28
op
.It C-p
0492
2021-04-22
op
previous-line
0493
2021-03-28
op
.It C-n
0494
2021-04-22
op
next-line
0495
2021-03-28
op
.It C-f
0496
2021-04-22
op
forward-char
0497
2021-03-28
op
.It C-b
0498
2021-04-22
op
backward-char
0499
2021-03-28
op
.It M-{
0500
2021-04-22
op
backward-paragraph
0501
2021-03-28
op
.It M-}
0502
2021-04-22
op
forward-paragraph
0503
2021-03-28
op
.It C-a
0504
2021-04-22
op
move-beginning-of-line
0505
2021-03-28
op
.It C-e
0506
2021-04-22
op
move-end-of-line
0507
2021-03-28
op
.It M-v, M-space
0508
2021-04-22
op
scroll-up
0509
2021-03-28
op
.It C-v, space
0510
2021-04-22
op
scroll-down
0511
2021-03-28
op
.It M-<
0512
2021-04-22
op
beginning-of-buffer
0513
2021-03-28
op
.It M->
0514
2021-04-22
op
end-of-buffer
0515
2021-03-28
op
.It C-x C-c
0516
2021-04-22
op
kill-telescope
0517
2022-04-13
op
.It C-x C-w
0518
2022-04-13
op
write-buffer
0519
2021-03-28
op
.It C-g
0520
2021-04-22
op
clear-minibuf
0521
2021-03-28
op
.It M-x
0522
2021-04-22
op
execute-extended-command
0523
2021-06-26
op
.It C-c {
0524
2021-06-26
op
dec-fill-column
0525
2021-06-26
op
.It C-c }
0526
2021-06-26
op
inc-fill-column
0527
2021-06-25
op
.It C-c p
0528
2021-06-25
op
previous-heading
0529
2021-06-25
op
.It C-c n
0530
2021-06-25
op
next-heading
0531
2021-06-24
op
.It >
0532
2021-06-24
op
load-url
0533
2021-07-14
op
.It <
0534
2021-07-14
op
load-current-url
0535
2021-03-28
op
.It C-x C-f
0536
2021-04-22
op
load-url
0537
2021-03-28
op
.It C-x M-f
0538
2021-04-22
op
load-current-url
0539
2021-07-21
op
.It C-x o
0540
2021-07-21
op
other-window
0541
2021-03-28
op
.It C-x t 0
0542
2021-04-22
op
tab-close
0543
2021-03-28
op
.It C-x t 1
0544
2021-04-22
op
tab-close-other
0545
2021-03-28
op
.It C-x t 2
0546
2021-04-22
op
tab-new
0547
2021-03-28
op
.It C-x t o
0548
2021-04-22
op
tab-next
0549
2021-03-28
op
.It C-x t O
0550
2021-04-22
op
tab-previous
0551
2021-03-28
op
.It C-x t m
0552
2021-04-22
op
tab-move
0553
2021-03-28
op
.It C-x t M
0554
2021-04-22
op
tab-move-to
0555
2021-07-13
op
.It B, C-M-b
0556
2021-04-22
op
previous-page
0557
2021-07-13
op
.It F, C-M-f
0558
2021-04-22
op
next-page
0559
2021-03-28
op
.It <f7> a
0560
2021-04-22
op
bookmark-page
0561
2021-03-28
op
.It <f7> <f7>
0562
2021-04-22
op
list-bookmarks
0563
2021-07-15
op
.It C-z
0564
2021-07-15
op
suspend-telescope
0565
2021-03-28
op
.El
0566
2021-03-28
op
.Ss Xr vi 1 Ns -like keys
0567
2021-03-28
op
.Bl -tag -width xxxxxxxxxxxx -offset indent -compact
0568
2021-03-28
op
.It k
0569
2021-04-22
op
previous-line
0570
2021-03-28
op
.It j
0571
2021-04-22
op
next-line
0572
2021-03-28
op
.It l
0573
2021-04-22
op
forward-char
0574
2021-03-28
op
.It h
0575
2021-04-22
op
backward-char
0576
2021-03-28
op
.It {
0577
2021-04-22
op
backward-paragraph
0578
2021-03-28
op
.It }
0579
2021-04-22
op
forward-paragraph
0580
2021-03-28
op
.It ^
0581
2021-04-22
op
move-beginning-of-line
0582
2021-03-28
op
.It $
0583
2021-04-22
op
move-end-of-line
0584
2021-03-28
op
.It K
0585
2021-04-22
op
scroll-line-up
0586
2021-03-28
op
.It J
0587
2021-04-22
op
scroll-line-down
0588
2021-03-28
op
.It g g
0589
2021-04-22
op
beginning-of-buffer
0590
2021-04-01
op
.It G
0591
2021-04-22
op
end-of-buffer
0592
2021-03-28
op
.It g D
0593
2021-04-22
op
tab-close
0594
2021-03-28
op
.It g N
0595
2021-04-22
op
tab-new
0596
2021-03-28
op
.It g t
0597
2021-04-22
op
tab-next
0598
2021-03-28
op
.It g T
0599
2021-04-22
op
tab-previous
0600
2021-03-28
op
.It g M-t
0601
2021-04-22
op
tab-move
0602
2021-03-28
op
.It g M-T
0603
2021-04-22
op
tab-move-to
0604
2021-03-28
op
.It H
0605
2021-04-22
op
previous-page
0606
2021-03-28
op
.It L
0607
2021-04-22
op
next-page
0608
2022-01-05
op
.It u
0609
2022-01-05
op
tab-undo-close
0610
2021-03-28
op
.It q
0611
2021-04-22
op
kill-telescope
0612
2021-03-28
op
.It ESC
0613
2021-04-22
op
clear-minibuf
0614
2021-03-28
op
.It :
0615
2021-04-22
op
execute-extended-command
0616
2021-03-28
op
.El
0617
2021-03-28
op
.Ss CUA-like keys
0618
2021-03-28
op
.Bl -tag -width xxxxxxxxxxxx -offset indent -compact
0619
2021-03-28
op
.It <up>
0620
2021-04-22
op
previous-line
0621
2021-03-28
op
.It <down>
0622
2021-04-22
op
next-line
0623
2021-03-28
op
.It <right>
0624
2021-04-22
op
forward-char
0625
2021-03-28
op
.It <left>
0626
2021-04-22
op
backward-char
0627
2021-07-15
op
.It <home>
0628
2021-07-15
op
move-beginning-of-line
0629
2021-07-15
op
.It <end>
0630
2021-07-15
op
move-end-of-line
0631
2021-03-28
op
.It <prior>
0632
2021-04-22
op
scroll-up
0633
2021-03-28
op
.It <next>
0634
2021-04-22
op
scroll-down
0635
2021-07-08
op
.It C-w
0636
2021-07-08
op
tab-close
0637
2021-07-08
op
.It C-t
0638
2021-07-08
op
tab-new
0639
2021-07-08
op
.It M-<prior>
0640
2021-07-08
op
tab-previous
0641
2021-07-08
op
.It M-<next>
0642
2021-07-08
op
tab-next
0643
2021-01-02
op
.It del
0644
2021-01-02
op
previous-page
0645
2021-03-28
op
.It M-<left>
0646
2021-04-22
op
previous-page
0647
2021-03-28
op
.It M-<right>
0648
2021-04-22
op
next-page
0649
2021-07-14
op
.It <f5>
0650
2021-07-14
op
reload-page
0651
2021-07-14
op
.It r
0652
2021-07-14
op
reload-page
0653
2021-03-28
op
.El
0654
2021-03-28
op
.Ss Neither Emacs nor vi specific
0655
2021-03-28
op
.Bl -tag -width xxxxxxxxxxxx -offset indent -compact
0656
2021-04-01
op
.It <f1>
0657
2021-04-22
op
toggle-help
0658
2021-03-28
op
.It enter
0659
2021-04-22
op
push-button
0660
2021-03-28
op
.It M-enter
0661
2021-04-22
op
push-button-new-tab
0662
2021-03-28
op
.It M-tab
0663
2021-04-22
op
previous-button
0664
2021-06-15
op
.It backtab
0665
2021-06-15
op
previous-button
0666
2021-03-28
op
.It tab
0667
2021-04-22
op
next-button
0668
2021-07-14
op
.It M-t
0669
2021-07-14
op
tab-select
0670
2021-07-21
op
.It \&[
0671
2021-07-16
op
tab-previous
0672
2021-07-21
op
.It \&]
0673
2021-07-16
op
tab-next
0674
2021-08-18
op
.It M-\&[
0675
2021-08-18
op
tab-move-to
0676
2021-08-18
op
.It M-\&]
0677
2021-08-18
op
tab-move
0678
2021-07-15
op
.It M-l
0679
2021-07-14
op
link-select
0680
2021-07-14
op
.It M-/
0681
2021-07-14
op
swiper
0682
2022-02-08
op
.It M-r
0683
2022-02-08
op
reply-last-input
0684
2021-03-28
op
.El
0685
2021-03-28
op
.Ss Minibuffer-specific keys
0686
2021-03-28
op
.Bl -tag -width xxxxxxxxxxxx -offset indent -compact
0687
2021-03-28
op
.It enter
0688
2021-04-22
op
mini-complete-and-exit
0689
2021-03-28
op
.It C-g
0690
2021-04-22
op
mini-abort
0691
2021-03-28
op
.It ESC
0692
2021-04-22
op
mini-abort
0693
2021-03-28
op
.It C-d
0694
2021-04-22
op
mini-delete-char
0695
2021-03-28
op
.It del
0696
2021-04-22
op
mini-delete-backward-char
0697
2021-03-28
op
.It backspace
0698
2021-04-22
op
mini-delete-backward-char
0699
2021-03-28
op
.It C-h
0700
2021-04-22
op
mini-delete-backward-char
0701
2021-03-28
op
.It C-b
0702
2021-04-22
op
backward-char
0703
2021-03-28
op
.It C-f
0704
2021-04-22
op
forward-char
0705
2021-03-28
op
.It <left>
0706
2021-04-22
op
backward-char
0707
2021-03-28
op
.It <right>
0708
2021-04-22
op
forward-char
0709
2021-03-28
op
.It C-e
0710
2021-04-22
op
move-end-of-line
0711
2021-03-28
op
.It C-a
0712
2021-04-22
op
move-beginning-of-line
0713
2021-03-28
op
.It <end>
0714
2021-04-22
op
move-end-of-line
0715
2021-03-28
op
.It <home>
0716
2021-04-22
op
move-beginning-of-line
0717
2021-03-28
op
.It C-k
0718
2021-04-22
op
mini-kill-line
0719
2022-04-15
op
.It C-u
0720
2022-04-15
op
mini-kill-whole-line
0721
2021-03-28
op
.It M-p
0722
2021-04-22
op
mini-previous-history-element
0723
2021-03-28
op
.It M-n
0724
2021-04-22
op
mini-next-history-element
0725
2021-07-14
op
.It C-p
0726
2021-07-14
op
previous-completion
0727
2021-07-14
op
.It C-n
0728
2021-07-14
op
next-completion
0729
2021-07-14
op
.It <up>
0730
2021-07-14
op
previous-completion
0731
2021-07-14
op
.It <down>
0732
2021-07-14
op
next-completion
0733
2021-07-14
op
.It tab
0734
2021-07-14
op
insert-current-candidate
0735
2021-07-21
op
.It M-<
0736
2021-07-21
op
mini-goto-beginning
0737
2021-07-21
op
.It M->
0738
2021-07-21
op
mini-goto-end
0739
2021-03-28
op
.El
0740
2021-03-28
op
.Sh INTERACTIVE COMMANDS
0741
2021-03-28
op
Follows the documentation for the interactive commands.
0742
2021-03-28
op
These commands can be bound to a key or executed with
0743
2021-03-28
op
.Ic execute-extended-command .
0744
2021-03-28
op
.Ss Movement commands
0745
2021-03-28
op
.Bl -tag -width execute-extended-command -compact
0746
2021-03-28
op
.It Ic backward-char
0747
2021-03-28
op
Move point one character backward.
0748
2021-03-28
op
.It Ic backward-paragraph
0749
2021-03-28
op
Move point one paragraph backward.
0750
2021-03-28
op
.It Ic beginning-of-buffer
0751
2021-03-28
op
Move point to the beginning of the buffer.
0752
2021-03-28
op
.It Ic end-of-buffer
0753
2021-03-28
op
Move point to the end of the buffer.
0754
2021-03-28
op
.It Ic forward-char
0755
2021-03-28
op
Move point one character forward.
0756
2021-03-28
op
.It Ic forward-paragraph
0757
2021-03-28
op
Move point one paragraph forward.
0758
2021-07-14
op
.It Ic insert-current-candidate
0759
2021-07-14
op
Copy the current selection text as minibuffer input.
0760
2021-03-28
op
.It Ic move-beginning-of-line
0761
2021-03-28
op
Move point at the beginning of the current (visual) line.
0762
2021-03-28
op
.It Ic move-end-of-line
0763
2021-03-28
op
Move point at the end of the current (visual) line.
0764
2021-03-28
op
.It Ic next-button
0765
2021-03-28
op
Move point to the next link.
0766
2021-07-14
op
.It Ic next-completion
0767
2021-07-14
op
Select the next completion.
0768
2021-06-25
op
.It Ic next-heading
0769
2021-06-25
op
Move point to the next heading.
0770
2021-03-28
op
.It Ic next-line
0771
2021-03-28
op
Move point to the next (visual) line, in the same column if possible.
0772
2021-03-28
op
.It Ic previous-button
0773
2021-03-28
op
Move point to the previous link.
0774
2021-07-14
op
.It Ic previous-completion
0775
2021-07-14
op
Select the previous completion.
0776
2021-06-25
op
.It Ic previous-heading
0777
2021-06-25
op
Move point to the previous heading.
0778
2021-03-28
op
.It Ic previous-line
0779
2021-03-28
op
Move point to the previous (visual) line.
0780
2021-03-28
op
.El
0781
2021-03-28
op
.Ss Bookmark-related commands
0782
2021-03-28
op
.Bl -tag -width execute-extended-command -compact
0783
2021-03-28
op
.It Ic bookmark-page
0784
2021-07-18
op
Save a page in the bookmark file.
0785
2021-03-28
op
It preloads the minibuffer with the current URL.
0786
2021-04-01
op
.It Ic list-bookmarks
0787
2021-03-28
op
Load the bookmarks page.
0788
2021-03-28
op
.El
0789
2021-03-28
op
.Ss Tab-related commands
0790
2021-03-28
op
.Bl -tag -width execute-extended-command -compact
0791
2021-03-28
op
.It Ic tab-close
0792
2021-03-28
op
Close the current tab.
0793
2021-03-28
op
.It Ic tab-close-other
0794
2021-03-28
op
Close all tabs but the current one.
0795
2021-03-28
op
.It Ic tab-move
0796
2021-03-28
op
Move the current tab after the next one, wrapping around if
0797
2021-03-28
op
needed.
0798
2021-03-28
op
.It Ic tab-move-to
0799
2021-03-28
op
Move the current tab before the previous one, wrapping around if needed.
0800
2021-03-28
op
.It Ic tab-new
0801
2021-03-28
op
Open a new tab.
0802
2021-03-28
op
.It Ic tab-next
0803
2021-03-28
op
Focus next tab, wrapping around eventually.
0804
2021-03-28
op
.It Ic tab-previous
0805
2021-03-28
op
Focus the previous tab, wrapping around eventually.
0806
2021-07-14
op
.It Ic tab-select
0807
2021-07-14
op
Switch to a tab using the minibuffer.
0808
2022-01-05
op
.It Ic tab-undo-close
0809
2022-01-05
op
Re-open the most recently closed tab, if any.
0810
2021-03-28
op
.El
0811
2021-03-28
op
.Ss Misc commands
0812
2021-03-28
op
.Bl -tag -width execute-extended-command -compact
0813
2022-01-12
op
.It Ic cache-info
0814
2022-01-12
op
Show cache stats.
0815
2021-03-28
op
.It Ic clear-minibuf
0816
2021-07-18
op
Clear the echo area.
0817
2021-06-26
op
.It Ic dec-fill-column
0818
2021-07-18
op
Decrement fill-column by two.
0819
2021-03-28
op
.It Ic execute-extended-command
0820
2021-07-18
op
Execute an internal command.
0821
2021-03-28
op
.It Ic kill-telescope
0822
2021-03-28
op
Quit
0823
2021-03-28
op
.Nm .
0824
2021-06-26
op
.It Ic inc-fill-column
0825
2021-07-18
op
Increment fill-column by two.
0826
2021-07-14
op
.It Ic link-select
0827
2021-07-14
op
Select and visit a link using the minibuffer.
0828
2021-03-28
op
.It Ic load-current-url
0829
2021-07-18
op
Edit the current URL.
0830
2021-03-28
op
.It Ic load-url
0831
2021-07-18
op
Prompt for an URL.
0832
2021-03-28
op
.It Ic next-page
0833
2021-07-18
op
Go forward in the page history.
0834
2021-06-19
op
.It Ic olivetti-mode
0835
2021-06-19
op
Toggle olivetti mode (i.e. horizontal centering of the lines of the
0836
2021-06-19
op
window.)
0837
2021-07-21
op
.It Ic other-window
0838
2021-07-21
op
Select the other window.
0839
2021-03-28
op
.It Ic previous-page
0840
2021-07-18
op
Go backward in the page history.
0841
2021-03-28
op
.It Ic push-button
0842
2021-07-18
op
Follow link at point, or toggle the visibility of the following
0843
2021-07-18
op
preformatted block if called when the cursor is on the heading of the block.
0844
2021-03-28
op
.It Ic push-button-new-tab
0845
2021-07-18
op
Follow link at point in a new tab.
0846
2021-03-28
op
.It Ic redraw
0847
2021-06-19
op
Redraw the screen, useful if some background program messed up the
0848
2021-03-28
op
display.
0849
2021-07-14
op
.It Ic reload-page
0850
2021-07-14
op
Reload the current page.
0851
2022-02-08
op
.It Ic reply-last-input
0852
2022-02-08
op
Reply the last input request.
0853
2021-03-28
op
.It Ic scroll-down
0854
2021-03-28
op
Scroll down by one visual page.
0855
2021-03-28
op
.It Ic scroll-line-down
0856
2021-03-28
op
Scroll down by one line.
0857
2021-03-28
op
.It Ic scroll-line-up
0858
2021-03-28
op
Scroll up by one line.
0859
2021-03-28
op
.It Ic scroll-up
0860
2021-03-28
op
Scroll up by one visual page.
0861
2021-07-15
op
.It Ic suspend-telescope
0862
2021-07-15
op
Suspend the current
0863
2021-07-15
op
.Nm
0864
2021-07-15
op
session.
0865
2021-07-14
op
.It Ic swiper
0866
2021-07-14
op
Jump to a line using the minibuffer.
0867
2021-07-15
op
.It Ic toc
0868
2021-07-18
op
Jump to a heading using the minibuffer.
0869
2021-04-01
op
.It Ic toggle-help
0870
2021-04-01
op
Toggle side window with help about available keys and their associated
0871
2021-04-01
op
interactive command.
0872
2021-07-15
op
.It Ic toggle-pre-wrap
0873
2021-07-15
op
Toggle the wrapping of preformatted blocks.
0874
2022-04-13
op
.It Ic write-buffer
0875
2022-04-13
op
Save the current buffer to the disk.
0876
2021-03-28
op
.El
0877
2021-03-28
op
.Ss Minibuffer commands
0878
2021-03-28
op
.Bl -tag -width execute-extended-command -compact
0879
2021-03-28
op
.It Ic mini-abort
0880
2021-03-28
op
Abort the current minibuffer action.
0881
2021-03-28
op
.It Ic mini-complete-and-exit
0882
2021-03-28
op
Complete the current minibuffer action.
0883
2021-03-28
op
.It Ic mini-delete-backward-char
0884
2021-03-28
op
Delete the character before the point.
0885
2021-03-28
op
.It Ic mini-delete-char
0886
2021-03-28
op
Delete the character after the point.
0887
2021-07-17
op
.It Ic mini-goto-beginning
0888
2021-07-17
op
Select the first completion, if any.
0889
2021-07-17
op
.It Ic mini-goto-end
0890
2021-07-17
op
Select the last completion, if any.
0891
2021-03-28
op
.It Ic mini-kill-line
0892
2021-07-18
op
Delete from point until the end of the line.
0893
2022-04-15
op
.It Ic mini-kill-whole-line
0894
2022-04-15
op
Delete the whole line.
0895
2021-03-28
op
.It Ic mini-next-history-element
0896
2021-03-28
op
Load the previous history element.
0897
2021-03-28
op
.It Ic mini-previous-history-element
0898
2021-03-28
op
Load the next history element.
0899
2021-03-28
op
.El
0900
2021-04-30
op
.Ss Aliases
0901
2021-04-30
op
The following aliases are available during
0902
2021-04-30
op
.Ic execute-extended-command :
0903
2021-04-30
op
.Bl -tag -width 16m -compact
0904
2022-01-15
op
.It Ic open
0905
2022-01-15
op
.Ic load-url
0906
2021-05-12
op
.It Ic tabn
0907
2021-05-12
op
.Ic tab-next
0908
2021-05-12
op
.It Ic tabnew
0909
2021-05-12
op
.Ic tab-new
0910
2021-05-12
op
.It Ic tabp
0911
2021-05-12
op
.Ic tab-previous
0912
2021-04-30
op
.It Ic q No and Ic wq
0913
2021-04-30
op
.Ic kill-telescope
0914
2022-04-13
op
.It Ic w
0915
2022-04-13
op
.Ic write-buffer
0916
2021-06-19
op
.El
0917
2021-07-21
op
.Sh ENVIRONMENT
0918
2021-07-21
op
When
0919
2021-07-21
op
.Nm
0920
2021-07-21
op
is started, it inspects the following environment variables:
0921
2021-07-21
op
.Bl -tag -width NO_COLORS
0922
2021-07-21
op
.It Ev HOME
0923
2021-07-21
op
The user's login directory.
0924
2021-07-21
op
.It Ev NO_COLORS
0925
2021-07-21
op
To decide whether to use colors or not.
0926
2021-07-21
op
The content of the variable doesn't matter.
0927
2021-07-21
op
.It Ev TERM
0928
2021-07-21
op
The user's terminal name.
0929
2021-10-08
op
.It Ev XDG_CACHE_HOME , Ev XDG_CONFIG_HOME , Ev XDG_DATA_HOME
0930
2021-10-08
op
If defined can alter the default location of the files used.
0931
2021-07-21
op
.El
0932
2021-03-28
op
.Sh FILES
0933
2021-10-08
op
By default
0934
2021-10-08
op
.Nm
0935
2021-10-08
op
follows the XDG Base Directory Specification.
0936
2021-10-08
op
However, if
0937
2021-10-08
op
.Pa ~/.telescope
0938
2021-10-08
op
exists, XDG is ignored and all the files are stored inside it.
0939
2021-10-08
op
The usage of
0940
2021-10-08
op
.Ev XDG_CACHE_HOME ,
0941
2021-10-08
op
.Ev XDG_CONFIG_HOME
0942
2021-10-08
op
and
0943
2021-10-08
op
.Ev XDG_DATA_HOME
0944
2021-10-08
op
can further alter the location of these files.
0945
2021-10-08
op
.Pp
0946
2021-03-28
op
.Bl -tag -width Ds -compact
0947
2021-10-07
op
.It Pa ~/.config/telescope/config
0948
2021-06-19
op
Default configuration file.
0949
2021-11-26
op
.It Pa ~/.local/share/telescope/pages/about_*.gmi
0950
2021-10-07
op
Overrides for built-in about: pages.
0951
2021-10-07
op
.It Pa ~/.local/share/telescope/bookmarks.gmi
0952
2021-10-07
op
Bookmarks file.
0953
2021-10-07
op
.It Pa ~/.local/share/telescope/known_hosts
0954
2021-07-21
op
Hash of the certificates for all the known hosts.
0955
2021-07-21
op
Each line contains three fields: hostname with optional port number,
0956
2021-07-21
op
hash of the certificate and a numeric flag.
0957
2021-10-07
op
.It Pa ~/.cache/telescope/lock
0958
2021-07-15
op
Lock file used to prevent multiple instance of
0959
2021-07-15
op
.Nm
0960
2021-07-15
op
from running at the same time.
0961
2021-10-07
op
.It Pa ~/.cache/telescope/session
0962
2021-07-21
op
The list of tabs from the last session.
0963
2021-04-01
op
.El
0964
2021-06-19
op
.Sh EXAMPLES
0965
2021-06-23
op
It's possible to browse
0966
2021-06-23
op
.Dq the small web
0967
2021-06-23
op
.Pq i.e. simple websites
0968
2021-06-25
op
by using programs like the duckling-proxy by defining a proxy in
0969
2021-10-07
op
.Pa ~/.config/telescope/config :
0970
2021-06-23
op
.Bd -literal -offset indent
0971
2021-07-20
op
proxy http via "gemini://127.0.0.1:1965"
0972
2021-07-20
op
proxy https via "gemini://127.0.0.1:1965"
0973
2021-06-19
op
.Ed
0974
2021-06-24
op
.Pp
0975
2021-06-24
op
To load
0976
2021-06-24
op
.Nm
0977
2021-07-21
op
without any configuration
0978
2021-06-24
op
.Bd -literal -offset indent
0979
2021-06-24
op
telescope -c /dev/null
0980
2021-06-24
op
.Ed
0981
2021-10-08
op
.Sh STANDARDS
0982
2021-10-08
op
.Rs
0983
2021-10-08
op
.%B XDG Base Directory Specification
0984
2021-10-08
op
.%U https://specifications.freedesktop.org/basedir-spec/latest/
0985
2021-10-08
op
.Re
0986
2022-01-13
op
.Sh ACKNOWLEDGEMENTS
0987
2022-01-13
op
The
0988
2022-01-13
op
.Dq Trust, but verify (where appropriate)
0989
2022-01-13
op
TOFU scheme was firstly suggested by thfr:
0990
2022-01-13
op
.Lk gemini://thfr.info/gemini/modified-trust-verify.gmi .
0991
2021-03-28
op
.Sh AUTHORS
0992
2021-03-28
op
.An -nosplit
0993
2021-03-28
op
The
0994
2021-03-28
op
.Nm
0995
2021-03-28
op
program was written by
0996
2021-03-28
op
.An Omar Polo Aq Mt op@omarpolo.com .
0997
2021-11-27
op
.Sh CAVEATS
0998
2021-11-27
op
.Nm
0999
2021-01-02
op
assumes a UTF-8 environment and doesn't try to cope with other encodings.
1000
2021-01-02
op
This can cause strange rendering issues if you're lucky, or possibly
1001
2021-01-02
op
weird thing happening depending on your locale and terminal emulator.
1002
2022-01-13
op
.Pp
1003
2022-01-13
op
The algorithm used for text-wrapping is naive and doesn't really work for
1004
2022-01-13
op
languages that make heavily use of glyphs composed by multiple UNICODE
1005
2022-01-13
op
codepoints.
1006
2021-07-21
op
.Sh BUGS
1007
2021-07-21
op
There's no UI for out-of-band certificates validation.
Omar Polo