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