commit 77afdb1f9663d3872e048faf15026f33d0ce11c3 parent bb055e70f7a276ab1a4ce54b00565285ea84c66b Author: Andrew Kloet <andrew@kloet.net> Date: Fri, 27 Mar 2026 12:12:28 -0400 create an mdoc manual page Diffstat:
| A | nio.1 | | | 107 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
1 file changed, 107 insertions(+), 0 deletions(-)
diff --git a/nio.1 b/nio.1 @@ -0,0 +1,107 @@ +.Dd March 27, 2026 +.Dt NIO 1 +.Os +.Sh NAME +.Nm nio +.Nd a minimal IRC client +. +.Sh SYNOPSIS +.Nm nio +.Op Fl ht +.Op Fl l Ar logfile +.Op Fl n Ar nick +.Op Fl p Ar port +.Op Fl s Ar server +.Op Fl u Ar user +. +.Sh DESCRIPTION +.Nm +is a multiplexing curses interface for IRC featuring: +.Bl -bullet -compact +.It +Infinite scrollback; +.It +Automatic reconnection; +.It +UTF-8 support (inputting is still to do); +.It +Line editing (emacs like keybindings); +.It +Activity markers +.It +Logging +.It +Terminal resizes (inside an xterm). +.El +. +.Sh COMMANDS +.Ss Chat Commands +Chat commands are submitted with a newline. +.Bl -tag -width Ds +.It Ic j Ar #channel +Join a given channel +.It Ic l Op Ar #channel +Leave the given channel(s), defaults to current channel. +.It Ic m Ar recipient message +Sends a private message. +.It Ic r Ar message +Sends a raw message to the server. +.It Ic q +Quits +.Nm . +.El +.Ss Interface Commands +.Bl -tag -width Ds +.It Ic ^n +Increases focused window index by 1 (wrapping). +.It Ic ^p +Decreases focused window index by 1 (wrapping). +.It Ic PAGEUP +Scrolls chat up by 15 lines. +.It Ic PAGEDOWN +Scrolls chat down by 15 lines. +.El +.Ss Line Editing +The following key bindings are available when entering text: +.Bl -tag -width Ds +.It Ic ^A +Move cursor to the beginning of the line. +.It Ic ^E +Move cursor to the end of the line. +.It Ic ^B No \&| Ic LEFTARROW +Move cursor one character to the left. +.It Ic ^F No \&| Ic RIGHTARROW +Move cursor one character to the right. +.It Ic ^K +Delete from the cursor to the end of the line. +.It Ic ^U +Delete from the beginning of the line to the cursor. +.It Ic ^D +Delete character under the cursor. +.It Ic ^H +Delete character to the left of the cursor. +.It Ic ^W +Delete word to the left of the cursor. +.It Ic BACKSPACE +Delete character to the left of the cursor. +.It Ic ENTER +Submit current line. +.El +. +.Sh ENVIRONMENT +.Bl -tag -width Ds +.It Ev USER +The default username to use. +.It Ev IRCNICK +The default nickname to use. +.It Ev IRCPASS +The default password to use. +.El +. +.Sh EXIT STATUS +.Nm +exits 0 if requested by the user and >0 if any other error occurs. +.Sh AUTHORS +.An Quentin Carbonneaux Aq Mt qcarbonneaux@gmail.com +.An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org +.An Andrew Kloet Aq Mt andrew@kloet.net