catgirl/catgirl.1

461 lines
6.4 KiB
Groff
Raw Normal View History

2018-12-02 23:12:45 +00:00
.Dd December 2, 2018
.Dt CATGIRL 1
2018-12-02 23:12:45 +00:00
.Os
2018-09-10 18:52:59 +00:00
.
.Sh NAME
.Nm catgirl
.Nd IRC client
2018-09-10 18:52:59 +00:00
.
.Sh SYNOPSIS
.Nm
2018-10-28 06:44:09 +00:00
.Op Fl Nv
.Op Fl W Ar pass
.Op Fl a Ar auth
.Op Fl h Ar host
.Op Fl j Ar chan
.Op Fl l Ar path
.Op Fl n Ar nick
.Op Fl p Ar port
2018-12-03 04:08:49 +00:00
.Op Fl r Ar real
.Op Fl u Ar user
.Op Fl w Ar pass
2018-09-10 18:52:59 +00:00
.
.Sh DESCRIPTION
.Nm
2018-12-02 23:12:45 +00:00
is a curses, TLS-only IRC client.
2018-09-10 18:52:59 +00:00
.
.Pp
The arguments are as follows:
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.Bl -tag -width "-w pass"
2018-10-28 06:44:09 +00:00
.It Fl N
Send notifications with
.Xr notify-send 1 .
.
.It Fl W Ar pass
Send
.Ql WEBIRC
command with
.Ar pass .
See
.Sx ENVIRONMENT
for details.
2018-09-10 18:52:59 +00:00
.
.It Fl a Ar auth
Authenticate with SASL PLAIN.
.Ar auth
is a colon-separated
username and password pair.
.
.It Fl h Ar host
Connect to
.Ar host .
.
.It Fl j Ar chan
Join
.Ar chan
after connecting.
.Ar chan
may be a comma-separated list.
2018-09-10 18:52:59 +00:00
.
.It Fl l Ar path
Log messages to subdirectories by target
and files by date under
.Ar path .
2018-09-10 18:52:59 +00:00
.
.It Fl n Ar nick
Set nickname to
.Ar nick .
2018-09-10 18:52:59 +00:00
.
.It Fl p Ar port
Connect to
.Ar port .
The default port is 6697.
2018-09-10 18:52:59 +00:00
.
2018-12-03 04:08:49 +00:00
.It Fl r Ar real
Set realname to
.Ar real .
The default realname is
the same as the nickname.
.
.It Fl u Ar user
Set username to
.Ar user .
The default username is
the same as the nickname.
2018-09-10 18:52:59 +00:00
.
.It Fl v
Show raw IRC protocol in the
.Ql -raw-
view.
2018-09-10 18:52:59 +00:00
.
.It Fl w Ar pass
Log in with
.Ar pass .
.El
2018-09-10 18:52:59 +00:00
.
.Pp
If
.Fl h
or
.Fl n
are not provided,
they will be prompted for.
2018-09-10 18:52:59 +00:00
.
2018-09-10 06:01:30 +00:00
.Sh COMMANDS
2018-12-02 23:12:45 +00:00
Any unique prefix
may be used to abbreviate a command.
2018-09-09 03:26:44 +00:00
A slash followed immediately by a number
is equivalent to
.Ic /view .
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.Bl -tag -width Ds
2018-09-09 03:26:44 +00:00
.It Ic /close
Close the current view.
2018-12-02 23:12:45 +00:00
Later views are renumbered.
2018-09-10 18:52:59 +00:00
.
2018-09-11 20:10:49 +00:00
.It Ic /help
Equivalent to
.Ic /man .
.
2018-09-09 03:26:44 +00:00
.It Ic /join Ar chan
Join a channel.
2018-09-10 18:52:59 +00:00
.
2018-09-10 23:18:26 +00:00
.It Ic /man
View this manual.
.
2018-09-09 03:26:44 +00:00
.It Ic /me Ar action
Send a CTCP
.Ql ACTION
to the current target.
2018-09-10 18:52:59 +00:00
.
2018-09-09 03:26:44 +00:00
.It Ic /names
List users in the current channel.
Equivalent to
.Ic /who .
2018-09-10 18:52:59 +00:00
.
2018-09-09 03:26:44 +00:00
.It Ic /nick Ar nick
Change nicknames.
2018-09-10 18:52:59 +00:00
.
2018-09-09 03:26:44 +00:00
.It Ic /open Op Ar range
2018-12-02 23:12:45 +00:00
.Xr open 1
2018-09-09 03:26:44 +00:00
.Ar range
most recent URLs
2018-12-02 23:12:45 +00:00
appearing in the current view.
2018-09-09 03:26:44 +00:00
.Ar range
may be a hypen- or comma-separated range
from the most recent URL,
starting at 1.
The default
.Ar range
is 1.
2018-09-10 18:52:59 +00:00
.
2018-09-11 18:36:30 +00:00
.It Ic /open Ar substring
2018-12-02 23:12:45 +00:00
.Xr open 1
the most recent URL
2018-09-11 18:36:30 +00:00
appearing in the current view
matching
2018-12-02 23:12:45 +00:00
.Ar substring .
2018-09-11 18:36:30 +00:00
.
2018-09-09 03:26:44 +00:00
.It Ic /part
Leave the current channel.
2018-09-10 18:52:59 +00:00
.
2018-09-09 03:26:44 +00:00
.It Ic /query Ar nick
Open a private message view with
.Ar nick .
2018-09-10 18:52:59 +00:00
.
2018-09-09 03:26:44 +00:00
.It Ic /quit Op Ar message
Quit IRC.
The default
.Ar message
is
.Dq Goodbye .
2018-09-10 18:52:59 +00:00
.
2018-12-05 20:04:34 +00:00
.It Ic /raw Op Ar command
Toggle the
.Ql -raw-
view
and send the raw IRC
.Ar command .
.
2018-09-09 03:26:44 +00:00
.It Ic /topic Op Ar topic
Show the topic of the current channel
or set it to
.Ar topic .
2018-09-10 18:52:59 +00:00
.
2018-09-09 03:26:44 +00:00
.It Ic /url
Hide the UI and
2018-12-02 23:12:45 +00:00
list the most recent URLs
2018-09-09 03:26:44 +00:00
which appeared in the current view.
Press
2018-09-10 06:01:30 +00:00
.Aq Enter
2018-09-09 03:26:44 +00:00
to resume the UI.
2018-09-10 18:52:59 +00:00
.
2018-09-09 03:26:44 +00:00
.It Ic /view Ar num
Switch to view number
.Ar num .
2018-09-10 18:52:59 +00:00
.
2018-09-09 03:26:44 +00:00
.It Ic /view Ar name
Switch to view for
.Ar name .
2018-09-10 18:52:59 +00:00
.
2018-09-09 03:26:44 +00:00
.It Ic /who
List users in the current channel.
2018-11-29 10:37:10 +00:00
.
.It Ic /whois Ar nick
Query information about a user.
2018-09-09 03:26:44 +00:00
.El
2018-09-10 18:52:59 +00:00
.
2018-09-09 03:26:44 +00:00
.Pp
Additionally,
messages entered in the
.Ql -raw-
2018-09-09 03:26:44 +00:00
view
will be sent as raw IRC commands.
2018-09-10 18:52:59 +00:00
.
.Sh KEY BINDINGS
2018-09-10 06:01:30 +00:00
.Nm
provides Emacs-like
line editing keys,
as well as keys for entering
IRC formatting codes.
2018-12-02 23:12:45 +00:00
The prefixes
.Sy C- ,
.Sy M-
and
.Sy S-
represent the control, meta and shift modifiers,
respectively.
Special keys are enclosed in
.Aq angle brackets .
2018-09-10 18:52:59 +00:00
.
.Ss View Keys
2018-12-02 23:12:45 +00:00
.Bl -tag -width <PageDown>
.It Sy C-l
2018-09-10 06:01:30 +00:00
Redraw the UI.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy M-m
Insert a blank line in the view.
.
2018-12-02 23:12:45 +00:00
.It Sy M-0 .. Sy M-9
2018-09-10 06:01:30 +00:00
Switch to view by number.
See
.Ic /view .
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy S- Ns Aq Sy Left
2018-09-10 06:01:30 +00:00
Scroll view up by one line.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy S- Ns Aq Sy Right
2018-09-10 06:01:30 +00:00
Scroll view down by one line.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Aq Sy PageUp
2018-09-10 06:01:30 +00:00
Scroll view up by half a page.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Aq Sy PageDown
2018-09-10 06:01:30 +00:00
Scroll view down by half a page.
.El
2018-09-10 18:52:59 +00:00
.
.Ss Line Editing
2018-12-02 23:12:45 +00:00
.Bl -tag -width "C-f, <Right>"
.It Sy C-b , Aq Sy Left
2018-09-10 06:01:30 +00:00
Move cursor left.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-f , Aq Sy Right
2018-09-10 06:01:30 +00:00
Move cursor right.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-a , Aq Sy Home
2018-09-10 06:01:30 +00:00
Move cursor to beginning of line.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-e , Aq Sy End
2018-09-10 06:01:30 +00:00
Move cursor to end of line.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy M-b
2018-09-10 06:01:30 +00:00
Move cursor to beginning of word.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy M-f
2018-09-10 06:01:30 +00:00
Move cursor to end of word.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Aq Sy Backspace
2018-09-10 06:01:30 +00:00
Delete character before cursor.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-d , Aq Sy Delete
2018-09-10 06:01:30 +00:00
Delete character under cursor.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-w , Sy M- Ns Aq Sy Backspace
2018-09-10 06:01:30 +00:00
Delete word before cursor.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy M-d
2018-09-10 06:01:30 +00:00
Delete word after cursor.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-k
2018-09-10 06:01:30 +00:00
Delete line after cursor.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Aq Sy Tab
2018-09-10 06:01:30 +00:00
Cycle through completions
for commands, nicks and channels.
2018-12-16 22:19:06 +00:00
.
.It Sy M-?
ROT13-encode line.
.El
2018-09-10 18:52:59 +00:00
.
.Ss IRC Formatting
2018-12-02 23:12:45 +00:00
.Bl -tag -width Ds
.It Sy C-n
Reset formatting.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-o
Toggle bold.
Note: this may need to be typed as
2018-12-02 23:12:45 +00:00
.Sy C-v C-o .
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-t
Toggle italic.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-u
Toggle underline.
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-v
Toggle reverse video.
Note: this must usually be typed as
2018-12-02 23:12:45 +00:00
.Sy C-v C-v .
2018-09-10 18:52:59 +00:00
.
2018-12-02 23:12:45 +00:00
.It Sy C-r
Set or reset color.
.El
.
.Pp
To reset color,
follow
2018-12-02 23:12:45 +00:00
.Sy C-r
by a non-digit.
To set the foreground color,
follow
2018-12-02 23:12:45 +00:00
.Sy C-r
by one or two digits.
To set the foreground and background colors,
follow
2018-12-02 23:12:45 +00:00
.Sy C-r
by one or two digits,
a comma,
and one or two digits.
.
.Pp
The colors are as follows:
2018-12-02 23:12:45 +00:00
.Pp
.Bl -tag -width Ds -compact
.It 0
white
.It 1
black
.It 2
blue
.It 3
green
.It 4
red
.It 5
brown (dark red)
.It 6
magenta
.It 7
orange (dark yellow)
.It 8
yellow
.It 9
light green
.It 10
cyan
.It 11
light cyan
.It 12
light blue
.It 13
pink (light magenta)
.It 14
gray
.It 15
light gray
2018-09-10 06:01:30 +00:00
.El
2018-09-10 18:52:59 +00:00
.
.Sh ENVIRONMENT
2018-12-02 23:12:45 +00:00
.Bl -tag -width SSH_CLIENT
.It Ev SSH_CLIENT
If
.Fl W
is passed and
.Ev SSH_CLIENT
is set,
the
.Ql WEBIRC
command is used
to set the hostname
to the first word of
.Ev SSH_CLIENT ,
usually the client IP address.
.El
2018-09-10 18:52:59 +00:00
.
.Sh EXAMPLES
2018-12-02 23:12:45 +00:00
.Dl catgirl -h ascii.town -j '&town'
2018-09-10 18:52:59 +00:00
.
.Sh STANDARDS
.Nm
is a partial implementation of the following:
.
.Bl -item
.It
.Rs
.%A C. Kalt
.%T Internet Relay Chat: Client Protocol
.%I IETF
.%N RFC 2812
.%D April 2000
.%U https://tools.ietf.org/html/rfc2812
.Re
2018-09-10 18:52:59 +00:00
.
.It
.Rs
.%A Kevin L. Mitchell
.%A Perry Lorier
.%A Lee Hardy
.%A William Pitcock
.%T IRCv3.1 Client Capability Negotiation
.%I IRCv3 Working Group
.%U https://ircv3.net/specs/core/capability-negotiation-3.1.html
.Re
.
.It
.Rs
.%A Jilles Tjoelker
.%A William Pitcock
.%T IRCv3.1 SASL Authentication
.%I IRCv3 Working Group
.%U https://ircv3.net/specs/extensions/sasl-3.1.html
.Re
.
.It
.Rs
.%A K. Zeilenga, Ed.
.%Q OpenLDAP Foundation
.%T The PLAIN Simple Authentication and Security Layer (SASL) Mechanism
.%I IETF
.%N RFC 4616
.%D August 2006
.%U https://tools.ietf.org/html/rfc4616
.Re
.
.It
.Rs
.%A S. Josefsson
.%Q SJD
.%T The Base16, Base32, and Base64 Data Encodings
.%I IETF
.%N RFC 4648
.%D October 2006
.%U https://tools.ietf.org/html/rfc4648
.Re
.El
.
.Sh CAVEATS
.Nm
does not support unencrypted connections.