sacc

sacc (saccomys): simple gopher client.
Log | Files | Refs | LICENSE

sacc.1 (2591B)


      1 .TH SACC 1 2022-10-15 %VERSION%
      2 .SH NAME
      3 sacc \- a terminal gopher client
      4 .SH SYNOPSIS
      5 .B sacc
      6 .IR URL
      7 .SH DESCRIPTION
      8 .B sacc
      9 (short for saccomys)
     10 is a terminal gopher client. Gopher is a simple protocol to retrieve
     11 hierarchical information. The protocol is defined in
     12 .I RFC 1436
     13 (Gopher).
     14 .PP
     15 .B sacc
     16 also supports non-standard TLS encryption,
     17 if built with TLS support,
     18 with the gophers:// scheme.
     19 It will search the
     20 .B ~/.share/sacc/cert
     21 directory for local certificates.
     22 .SH SHORTCUTS
     23 Shortcuts can be redefined in the
     24 .BR config.h .
     25 The manpage is showing the default shortcuts.
     26 .TP
     27 .B Down or j
     28 Move one line down.
     29 .TP
     30 .B J
     31 Move to the next link item downwards.
     32 .TP
     33 .B Up or k
     34 Move one line up.
     35 .TP
     36 .B K
     37 Move to the next link item upwards.
     38 .TP
     39 .B PgDown or Space
     40 Move one page down.
     41 .TP
     42 .B PgUp or b
     43 Move one page up.
     44 .TP
     45 .B Home or g
     46 Move to the top of the page.
     47 .TP
     48 .B End or G
     49 Move to the end of the page.
     50 .TP
     51 .B Right or l
     52 View highlighted item.
     53 .TP
     54 .B Left or h
     55 View previous item.
     56 .TP
     57 .B L
     58 Refetch currently viewed item.
     59 .TP
     60 .B /
     61 Search in the current page.
     62 .TP
     63 .B n
     64 Search the same string forward.
     65 .TP
     66 .B N
     67 Search the same string backwards.
     68 .TP
     69 .B U
     70 Print the URI of the current page.
     71 .TP
     72 .B u
     73 Print the URI of the highlighted item.
     74 .TP
     75 .B Y
     76 Yank the current page URI to an external program.
     77 .TP
     78 .B y
     79 Yank the highlighted item URI to an external program.
     80 .TP
     81 .B ?
     82 Show the help message of shortcuts.
     83 .TP
     84 .B ^D or q
     85 Exit sacc.
     86 .SH ENVIRONMENT
     87 .B sacc
     88 will use the pager set in the
     89 .B PAGER
     90 variable to display textual content.
     91 If unset, it'll try to use
     92 .BR more (1).
     93 Note that sacc takes back control of the screen
     94 as soon as the pager finishes.
     95 In case of doubt,
     96 read your pager documentation.
     97 .PP
     98 If built with TLS support,
     99 .B sacc
    100 will search for local TLS certificates
    101 in the directory set in the
    102 .B SACC_CERT_DIR
    103 variable,
    104 instead of the default path
    105 .RB ( ~/.share/sacc/cert ).
    106 .SH PLUMBER
    107 When some file is opened
    108 .B sacc
    109 cannot open natively, it will run
    110 .BR xdg-open .
    111 This can be configured in the
    112 .B config.h
    113 to run some other plumber.
    114 .SH CUSTOMIZATION
    115 .B sacc
    116 can be customized by creating a custom
    117 .B config.h
    118 and (re)compiling the source
    119 code. This keeps it fast, secure and simple.
    120 .SH VERSION
    121 It is possible to get
    122 .B sacc
    123 version
    124 from the binary
    125 with the standard
    126 .BR what (1)
    127 tool.
    128 .SH AUTHORS
    129 See the
    130 .B LICENSE
    131 file for the authors.
    132 .SH LICENSE
    133 See the
    134 .B LICENSE
    135 file for the terms of redistribution.
    136 .SH SEE ALSO
    137 .BR more (1)
    138 .BR xdg-open (1)
    139 .BR geomyidae (8)
    140 .BR clic (1)
    141 .BR what (1)
    142 .SH BUGS
    143 Please report them to Quentin Rameau <quinq@fifth.space>