.Dd Jun 20, 2020
.Dt GEMINI-CAT 1
.Os
.Sh NAME
.Nm gemini-cat
.Nd concatnate responses from a Gemini URLs
.Sh SYNOPSIS
.Nm
.Op Fl RSisw
.Op Fl c Ar cert-file
.Op Fl h Ar proxy-host
.Op Fl k Ar key-file
.Op Fl p Ar port
.Op Fl r Ar max-redirects
.Op Fl t Ar tofu-file
.Ar URL ...
.Sh DESCRIPTION
Concatnate the responses from tha 
.Ar URL
arguments obtained by using the Gemini portocol.
The options are as follows:
.Bl -tag -width Ds
.It Fl R
Output the raw file, the default for non-TTY outputs.
.It Fl S
Strip out non-space control-characters before writing, the default for
TTY outputs.
.It Fl c Ar cert-file
The certificate file to use for TLS.
.It Fl h Ar proxy-host
The host to connect through.
.Ar proxy-host
can also specify a port number.
.It Fl i
Interactive mode (allow prompts).
.It Fl k Ar key-file
The key file to use for TLS.
.It Fl p Ar port
Use
.Ar port
instead of the default
.Pq 1965 .
.It Fl r Ar max-redirects
Set the maximum number of redirects (5 by default).
.It Fl s
Secure interactive mode (allow prompts, but do not echo).
.It Fl t Ar tofu-file
The file to read host certificate hashes from.
.It Fl w
Write any new hashes to the
.Ar tofu-file .
.El
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It Ev GEMINI_KEYFILE
Sets the TLS key file before
.Fl k .
.It Ev GEMINI_CERTFILE
Sets the TLS certificate file before
.Fl c .
.It Ev GEMINI_TOFUFILE
Sets the TOFU tile before
.Fl t .
.It Ev GEMINI_PROXY
Sets the proxy host before
.Fl h .
.It Ev GEMINI_MAX_REDIRECTS
Sets the maximum number of redirects before
.Fl r .
.It Ev GEMINI_PORT
Sets the default port number before
.Fl p .
.It Ev GEMINI_TOFU_WRITE
If set to a non-empty string, it is equivalent to
.Fl w .
.El
.Sh EXIT STATUS
.Ex -std
.Sh EXAMPLES
Fetch the 
.Lk tilde.black
root index:
.Dl gemini-cat gemini://tilde.black/ | more
Fetch
.Lk tilde.black
from its onion address:
.Bd -literal -offset indent -compact
torsocks gemini-cat -h \\
    black6kfjetfuzaeozz7fs53whh7xtd4e27telrf5fg5kgdt5ah5plad.onion \\
    //tilde.black/
.Ed
.Sh SEE ALSO
.Xr libgeminiclient 3 ,
.Xr tls_config_set_cert_file 3 ,
.Xr tls_config_set_key_file 3