clic.1 - clic - Clic is an command line interactive client for gopher written in Common LISP
HTML git clone git://bitreich.org/clic/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/clic/
DIR Log
DIR Files
DIR Refs
DIR Tags
DIR README
DIR LICENSE
---
clic.1 (2421B)
---
1 .Dd $Mdocdate: February 02 2018 $
2 .Dt CLIC 1
3 .Os
4 .Sh NAME
5 .Nm clic
6 .Nd a text based gopher client
7 .Sh SYNOPSIS
8 .Nm clic
9 .Op Fl t k
10 .Op URL
11 .Sh DESCRIPTION
12 .Nm
13 is a terminal gopher client.
14 Gopher is a simple protocol to retreive hierarchical information.
15 The protocol is defined in
16 .Em RFC 1436
17 (Gopher).
18 .Pp
19 When downloading a file,
20 .Nm
21 will save it using its filename under
22 .Pa /tmp/
23 .Sh OPTIONS
24 .Bl -tag -width Ds
25 .It Op Fl t
26 Activate the non split mode.
27 This prevents clic from breaking the menu display into parts when the display
28 reaches the terminal size.
29 This is useful when you want to scroll using your terminal.
30 .It Op Fl k
31 Activate the kiosk mode. (Disable running external applications, temp files,
32 downloading etc.)
33 .It Op URL
34 Load
35 .Op URL .
36 The syntax can be gopher://domain.tld or only domain.tld.
37 Port 70 is used by default.
38 For using another port, one should add :40550 like in domain.tld:40550.
39 .Pp
40 It is possible to load a local file using the syntax file://some_file.
41 This file should be a gophermap as defined in the RFC.
42 This allows for custom bookmarks to be created locally as an entry point to the
43 gopherspace.
44 .El
45 .Sh COMMANDS
46 Clic uses a simple command line for its interface.
47 There are multiple command options for some functions.
48 This allows clic to be used with a full keyboard or a numpad.
49 .Bl -tag -width Number
50 .It Cm Number
51 Follows the link numbered
52 .Cm Number .
53 .It Cm p | / | cd ..
54 Go to previous page.
55 .It Cm h
56 Display the history as a browseable menu.
57 .It Cm sNUMBER
58 Show the full URL of link numbered
59 .Cm NUMBER .
60 Useful for sharing or saving a link URL.
61 .It Cm d
62 Dump raw result of a menu.
63 This is useful for debugging.
64 .It Cm r | ls | *
65 Reload the current menu.
66 .It Cm help
67 Show the help text.
68 .It Cm / text
69 Search for the specified
70 .Cm text .
71 This acts as a filter which will redisplay the current menu only with lines
72 matching
73 .Cm text .
74 This can be used multiples times.
75 The filter will be used on the last result
76 to narrow the results.
77 .It Cm ^D | x | q | Cm . | exit
78 Exit clic.
79 .El
80 .Sh PLUMBER
81 When some file is opened other than a text file or a menu,
82 .Nm
83 will run
84 .Xr xdg-open 1
85 on it.
86 .Sh SEE ALSO
87 .Xr sacc 1 ,
88 .Xr xdg-open 1 ,
89 .Xr geomyidae 8
90 .Sh AUTHORS
91 .An See the LICENSE file for the authors .
92 .Sh LICENSE
93 See the LICENSE file for the terms of redistribution.
94 .Sh BUGS
95 Programs like torsocks or torify don't work with
96 .Nm .
97 .Pp
98 See the TODO file in the distribution.