-
Notifications
You must be signed in to change notification settings - Fork 15
/
cgo.1
121 lines (121 loc) · 3.26 KB
/
cgo.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
.\"
.\" cgo - a simple terminal based gopher client
.\" Copyright (c) 2013-2019 Sebastian Steinhauer <s.steinhauer@yahoo.de>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd Mai 31, 2019
.Dt CGO 1
.Os
.Sh Name
.Nm cgo
.Nd simple terminal based gopher client
.Sh SYNOPSIS
.Nm cgo
.Op Fl Hv
.Op Ar gopher URI
.Sh DESCRIPTION
.Nm
is a UNIX/Linux terminal based gopher client.
It has no dependencies other than libc and some syscalls.
It should run on every VT100 compatible terminal.
To show media like images, music, or web pages it relies on external programs
you can specify.
.Pp
.Nm
means, more or less, the "c go"pher client.
And c could stand for C (the programming language), colorful, or console.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl H
Show usage.
.It Fl v
Print version.
.It Ar gopher URI
Open given gopher URI.
.El
.Pp
When surfing gopherspace
.Nm
only presents directory listings.
Every selector is preceded by two ASCII characters,
or three if we run out of selectors in the range 'aa', 'ab' ... 'zz'.
By typing in these characters
.Nm
will jump to the given selector.
Every time you jump to another directory listing
.Nm
generates a history entry (like every browser).
To show other media
.Nm
uses external programs (e.g. less, display, mplayer, firefox).
.Pp
The following commands are understood by
.Nm :
.Bl -tag -width Ds -compact -offset indent
.It Ar \?
Help.
.It Ar <
Jump back one step in history.
.It Ar *
Reload current directory.
.It Ar H
Show history.
.It Ar B
Show bookmarks.
.It Ar [LINK]
Jump to selector.
.It Ar \.[LINK]
Download selector.
.It Ar H[LINK]
Jump to specified history item.
.It Ar B[LINK]
Jump to specified bookmark item.
.It Ar G[URI]
Jump to the specified gopher URI.
.It Ar CTRL-d
Quit.
.El
.Pp
[LINK] stands for the two (or three) colored letters in front of each selector.
.Sh CONFIGURATION
.Nm
reads /etc/cgorc and then ~/.cgorc for defaults.
If both files are missing, hardcoded defaults will be used.
The following configuration keys are recognized by
.Nm :
.Bl -tag -width Ds -compact -offset indent
.It start_uri
Gopher URI to display at launch.
.It bookmarkN
Configure a bookmark.
.It cmd_text
Program to view text files.
.It cmd_browser
Program to view HTML links.
.It cmd_image
Program to view images.
.It cmd_player
Program to play audio files.
.It color_prompt
ANSI color sequence for the prompt.
.It color_selector
ANSI color sequence for selectors.
.It verbose
If not "false" or "off" it will show messages like "downloading" / "executing" when downloading a selector.
.El
.Sh AUTHOR
.Nm
was written by
.An Sebastian Steinhauer Aq Mt s.steinhauer@yahoo.de .