mirror of https://github.com/xvxx/phetch
Add phetch(1) manual
parent
f90f4aef7e
commit
d082f4ca0c
@ -0,0 +1,223 @@
|
||||
.\" Generated by scdoc 1.10.0
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.nh
|
||||
.ad l
|
||||
.\" Begin generated content:
|
||||
.TH "PHETCH" "1" "2020-01-08"
|
||||
.P
|
||||
.SH NAME
|
||||
.P
|
||||
phetch - quick lil gopher client
|
||||
.P
|
||||
.SH SYNOPSIS
|
||||
.P
|
||||
\fBphetch\fR [\fIOPTIONS\fR] [\fIURL\fR]
|
||||
.P
|
||||
.SH OPTIONS
|
||||
.P
|
||||
\fB-l\fR, \fB--local\fR
|
||||
.RS 4
|
||||
Connect to the local gopher server at URL \fI127.0.0.1:7070\fR.
|
||||
.P
|
||||
.RE
|
||||
\fB-p\fR \fIURL\fR, \fB--print\fR \fIURL\fR
|
||||
.RS 4
|
||||
Print a rendered gopher server response of \fIURL\fR and exit.
|
||||
.P
|
||||
.RE
|
||||
\fB-r\fR \fIURL\fR, \fB--raw\fR \fIURL\fR
|
||||
.RS 4
|
||||
Print the raw gopher server response of \fIURL\fR and exit.
|
||||
.P
|
||||
.RE
|
||||
\fB-t\fR, \fB--tls\fR
|
||||
.RS 4
|
||||
Attempt to fetch all pages over TLS.
|
||||
.P
|
||||
.RE
|
||||
\fB-h\fR, \fB--help\fR
|
||||
.RS 4
|
||||
Print a help summary and exit.
|
||||
.P
|
||||
.RE
|
||||
\fB-v\fR, \fB--version\fR
|
||||
.RS 4
|
||||
Print version information and exit.
|
||||
.P
|
||||
.RE
|
||||
.SH NOTES
|
||||
.P
|
||||
When given a \fIURL\fR, \fBphetch\fR will show the requested gopher page and
|
||||
enter interactive mode.
|
||||
.P
|
||||
Without a \fIURL\fR, \fBphetch\fR will show a builtin dashboard with easy
|
||||
access to online help, bookmarks and history, and enter interactive
|
||||
mode.
|
||||
.P
|
||||
.SH NAVIGATION
|
||||
.P
|
||||
.SS KEYBOARD SHORTCUTS
|
||||
.P
|
||||
All single letter commands also work with the \fBCtrl\fR key: e.g., \fBh\fR
|
||||
and \fBCtrl-h\fR are synonyms.
|
||||
.P
|
||||
\fBh\fR
|
||||
.RS 4
|
||||
Go to builtin help page.
|
||||
.RE
|
||||
\fBq\fR
|
||||
.RS 4
|
||||
Quit \fBphetch\fR.
|
||||
.P
|
||||
.RE
|
||||
\fB←\fR, \fBleft arrow\fR
|
||||
.RS 4
|
||||
Go back in history.
|
||||
.RE
|
||||
\fB→\fR, \fBright arrow\fR
|
||||
.RS 4
|
||||
Go forward in history.
|
||||
.RE
|
||||
\fB↑\fR, \fBup arrow\fR, \fBp\fR, \fBk\fR
|
||||
.RS 4
|
||||
Select previous link.
|
||||
.RE
|
||||
\fB↓\fR, \fBdown arrow\fR, \fBn\fR, \fBj\fR
|
||||
.RS 4
|
||||
Select next link.
|
||||
.RE
|
||||
\fBPgUp\fR, \fBPgDn\fR
|
||||
.RS 4
|
||||
Scroll up or down by many lines.
|
||||
.RE
|
||||
\fB-\fR, \fBSPACE\fR
|
||||
.RS 4
|
||||
Same as \fBPgUp\fR and \fBPgDn\fR.
|
||||
.P
|
||||
.RE
|
||||
\fBNumber key\fR
|
||||
.RS 4
|
||||
Open/select link.
|
||||
.RE
|
||||
\fBEnter\fR
|
||||
.RS 4
|
||||
Open current link.
|
||||
.RE
|
||||
\fBEsc\fR, \fBCtrl-c\fR
|
||||
.RS 4
|
||||
Cancel
|
||||
.P
|
||||
.RE
|
||||
\fBf\fR, \fB/\fR
|
||||
.RS 4
|
||||
Find link in page.
|
||||
.P
|
||||
.RE
|
||||
\fBg\fR
|
||||
.RS 4
|
||||
Go to gopher URL.
|
||||
.RE
|
||||
\fBu\fR
|
||||
.RS 4
|
||||
Show gopher URL.
|
||||
.RE
|
||||
\fBy\fR
|
||||
.RS 4
|
||||
Copy URL.
|
||||
.P
|
||||
.RE
|
||||
\fBb\fR
|
||||
.RS 4
|
||||
Show bookmarks.
|
||||
.RE
|
||||
\fBs\fR
|
||||
.RS 4
|
||||
Save bookmark.
|
||||
.RE
|
||||
\fBa\fR
|
||||
.RS 4
|
||||
Show history.
|
||||
.P
|
||||
.RE
|
||||
\fBr\fR
|
||||
.RS 4
|
||||
View raw source.
|
||||
.RE
|
||||
\fBw\fR
|
||||
.RS 4
|
||||
Toggle wide mode.
|
||||
.P
|
||||
.RE
|
||||
.SS MENU NAVIGATION
|
||||
.P
|
||||
Up and down arrows
|
||||
.RS 4
|
||||
Use the up and down arrows, \fBj\fR and \fBk\fR keys, or \fBn\fR and \fBp\fR
|
||||
keys to select links. Phetch will scroll for you, or you can
|
||||
use page up and page down (or \fB-\fR and spacebar) to scroll by
|
||||
many lines at once.
|
||||
.P
|
||||
.RE
|
||||
Number keys
|
||||
.RS 4
|
||||
If there are few enough menu items, pressing a number key will
|
||||
open a link. Otherwise, the first matching number will be
|
||||
selected. Use \fBEnter\fR to open the selected link.
|
||||
.P
|
||||
.RE
|
||||
Incremental search
|
||||
.RS 4
|
||||
Press \fBf\fR or \fB/\fR to activate search mode, then just start
|
||||
typing. Phetch will look for the first case-insensitive match
|
||||
and try to select it. Use arrow keys or \fBp\fR/\fBn\fR to cycle
|
||||
matches.
|
||||
.P
|
||||
.RE
|
||||
.SH BOOKMARKS
|
||||
.P
|
||||
There are two ways to save the URL of the current page:
|
||||
.P
|
||||
\fBy\fR
|
||||
.RS 4
|
||||
Copy URL.
|
||||
.RE
|
||||
\fBs\fR
|
||||
.RS 4
|
||||
Save bookmark.
|
||||
.P
|
||||
.RE
|
||||
Bookmarks will be saved to the file \fI~/.config/phetch/bookmarks.gph\fR if
|
||||
the directory \fI~/.config/phetch/\fR exists.
|
||||
.P
|
||||
\fBb\fR
|
||||
.RS 4
|
||||
View saved bookmarks.
|
||||
.P
|
||||
.RE
|
||||
The clipboard function uses \fBpbcopy\fR on MacOS, and \fBxsel\fR \fI-sel clip\fR
|
||||
on Linux.
|
||||
.P
|
||||
.SH HISTORY
|
||||
.P
|
||||
If you create a \fIhistory.gph\fR file in \fI~/.config/phetch/\fR, each gopher
|
||||
URL you open will be stored there.
|
||||
.P
|
||||
New URLs are appended to the bottom, but loaded in reverse order, so
|
||||
you'll see the most recently visited pages first when you press the
|
||||
\fBa\fR key.
|
||||
.P
|
||||
Feel free to edit your history file directly, or share it with your
|
||||
friends!
|
||||
.P
|
||||
.SH ABOUT
|
||||
.P
|
||||
Phetch is maintained by dvkt, and released under the MIT license.
|
||||
.P
|
||||
Phetch's gopher hole:
|
||||
.RS 4
|
||||
\fIgopher://phkt.io/1/phetch\fR
|
||||
.RE
|
||||
Phetch's webpage:
|
||||
.RS 4
|
||||
\fIhttps://github.com/dvkt/phetch\fR
|
@ -0,0 +1,150 @@
|
||||
PHETCH(1)
|
||||
|
||||
# NAME
|
||||
|
||||
phetch - quick lil gopher client
|
||||
|
||||
# SYNOPSIS
|
||||
|
||||
*phetch* [_OPTIONS_] [_URL_]
|
||||
|
||||
# OPTIONS
|
||||
|
||||
*-l*, *--local*
|
||||
Connect to the local gopher server at URL _127.0.0.1:7070_.
|
||||
|
||||
*-p* _URL_, *--print* _URL_
|
||||
Print a rendered gopher server response of _URL_ and exit.
|
||||
|
||||
*-r* _URL_, *--raw* _URL_
|
||||
Print the raw gopher server response of _URL_ and exit.
|
||||
|
||||
*-t*, *--tls*
|
||||
Attempt to fetch all pages over TLS.
|
||||
|
||||
*-h*, *--help*
|
||||
Print a help summary and exit.
|
||||
|
||||
*-v*, *--version*
|
||||
Print version information and exit.
|
||||
|
||||
# NOTES
|
||||
|
||||
When given a _URL_, *phetch* will show the requested gopher page and
|
||||
enter interactive mode.
|
||||
|
||||
Without a _URL_, *phetch* will show a builtin dashboard with easy
|
||||
access to online help, bookmarks and history, and enter interactive
|
||||
mode.
|
||||
|
||||
# NAVIGATION
|
||||
|
||||
## KEYBOARD SHORTCUTS
|
||||
|
||||
All single letter commands also work with the *Ctrl* key: e.g., *h*
|
||||
and *Ctrl-h* are synonyms.
|
||||
|
||||
*h*
|
||||
Go to builtin help page.
|
||||
*q*
|
||||
Quit *phetch*.
|
||||
|
||||
*←*, *left arrow*
|
||||
Go back in history.
|
||||
*→*, *right arrow*
|
||||
Go forward in history.
|
||||
*↑*, *up arrow*, *p*, *k*
|
||||
Select previous link.
|
||||
*↓*, *down arrow*, *n*, *j*
|
||||
Select next link.
|
||||
*PgUp*, *PgDn*
|
||||
Scroll up or down by many lines.
|
||||
*-*, *SPACE*
|
||||
Same as *PgUp* and *PgDn*.
|
||||
|
||||
*Number key*
|
||||
Open/select link.
|
||||
*Enter*
|
||||
Open current link.
|
||||
*Esc*, *Ctrl-c*
|
||||
Cancel
|
||||
|
||||
*f*, */*
|
||||
Find link in page.
|
||||
|
||||
*g*
|
||||
Go to gopher URL.
|
||||
*u*
|
||||
Show gopher URL.
|
||||
*y*
|
||||
Copy URL.
|
||||
|
||||
*b*
|
||||
Show bookmarks.
|
||||
*s*
|
||||
Save bookmark.
|
||||
*a*
|
||||
Show history.
|
||||
|
||||
*r*
|
||||
View raw source.
|
||||
*w*
|
||||
Toggle wide mode.
|
||||
|
||||
## MENU NAVIGATION
|
||||
|
||||
Up and down arrows
|
||||
Use the up and down arrows, *j* and *k* keys, or *n* and *p*
|
||||
keys to select links. Phetch will scroll for you, or you can
|
||||
use page up and page down (or *-* and spacebar) to scroll by
|
||||
many lines at once.
|
||||
|
||||
Number keys
|
||||
If there are few enough menu items, pressing a number key will
|
||||
open a link. Otherwise, the first matching number will be
|
||||
selected. Use *Enter* to open the selected link.
|
||||
|
||||
Incremental search
|
||||
Press *f* or */* to activate search mode, then just start
|
||||
typing. Phetch will look for the first case-insensitive match
|
||||
and try to select it. Use arrow keys or *p*/*n* to cycle
|
||||
matches.
|
||||
|
||||
# BOOKMARKS
|
||||
|
||||
There are two ways to save the URL of the current page:
|
||||
|
||||
*y*
|
||||
Copy URL.
|
||||
*s*
|
||||
Save bookmark.
|
||||
|
||||
Bookmarks will be saved to the file _~/.config/phetch/bookmarks.gph_ if
|
||||
the directory _~/.config/phetch/_ exists.
|
||||
|
||||
*b*
|
||||
View saved bookmarks.
|
||||
|
||||
The clipboard function uses *pbcopy* on MacOS, and *xsel* _-sel clip_
|
||||
on Linux.
|
||||
|
||||
# HISTORY
|
||||
|
||||
If you create a _history.gph_ file in _~/.config/phetch/_, each gopher
|
||||
URL you open will be stored there.
|
||||
|
||||
New URLs are appended to the bottom, but loaded in reverse order, so
|
||||
you'll see the most recently visited pages first when you press the
|
||||
*a* key.
|
||||
|
||||
Feel free to edit your history file directly, or share it with your
|
||||
friends!
|
||||
|
||||
# ABOUT
|
||||
|
||||
Phetch is maintained by dvkt, and released under the MIT license.
|
||||
|
||||
Phetch's gopher hole:
|
||||
_gopher://phkt.io/1/phetch_
|
||||
Phetch's webpage:
|
||||
_https://github.com/dvkt/phetch_
|
Loading…
Reference in New Issue