cgo

[Fork] Gopher Client
git clone https://git.jojolepro.com/cgo.git
Log | Files | Refs | README | LICENSE

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 .