lchat

A line oriented chat front end for ii.
git clone git://git.suckless.org/lchat
Log | Files | Refs | README

lchat.1 (1757B)


      1 .Dd May 13, 2018
      2 .Dt LCHAT 1
      3 .Os
      4 .Sh NAME
      5 .Nm lchat
      6 .Nd line chat
      7 .Sh SYNOPSIS
      8 .Nm
      9 .Op Fl aeh
     10 .Op Fl n Ar lines
     11 .Op Fl p Ar prompt
     12 .Op Fl t Ar title
     13 .Op Fl i Ar in
     14 .Op Fl o Ar out
     15 .Op directory
     16 .Sh DESCRIPTION
     17 The
     18 .Nm
     19 utility is a command line front end for ii-like chat programs.
     20 It uses
     21 .Xr tail 1
     22 in the background to get output lines from
     23 .Ar out .
     24 .Nm
     25 locates the
     26 .Ar in
     27 and
     28 .Ar out
     29 files inside of the
     30 .Ar directory
     31 path.
     32 .sp 1
     33 The options are as follows:
     34 .Bl -tag -width Ds
     35 .It Fl a
     36 Turn off the bell on external line input.
     37 .It Fl e
     38 Allow to enter empty lines.
     39 .It Fl h
     40 Shows usage text.
     41 .It Fl n Ar lines
     42 Shows
     43 .Ar lines
     44 of chat history at startup.
     45 .It Fl p Ar prompt
     46 Use
     47 .Ar prompt
     48 as prompt for the input line.
     49 .It Fl t Ar title
     50 Use
     51 .Ar title
     52 as title for the terminal window.
     53 In a
     54 .Xr tmux 1
     55 or
     56 .Xr screen 1
     57 environment its change the window name instead of the window title.
     58 .It Fl i Ar in
     59 Use path of
     60 .Ar in
     61 as in-file.
     62 Default is 'in'.
     63 This overrides
     64 .Ar directory .
     65 .It Fl o Ar out
     66 Use path of
     67 .Ar out
     68 as out-file.
     69 Default is 'out'.
     70 This overrides
     71 .Ar directory .
     72 .It Ar directory
     73 Uses
     74 .Ar directory
     75 to search for in and out file.
     76 Default path is the current working directory.
     77 .El
     78 .Sh FILES
     79 .Bl -tag -width Ds
     80 .It .bellmatch
     81 contains regular expressions that controls bell ring on matching input.
     82 .It .filter
     83 If this file exists and has executable permissions, it is used as a filter
     84 program for the output lines.
     85 This program should read raw lines from stdin and outputs filtered or
     86 transformed lines to stdout.
     87 .It .prompt
     88 contains the prompt string.
     89 .It .title
     90 contains the terminal window title.
     91 .El
     92 .Sh SEE ALSO
     93 .Xr ii 1 ,
     94 .Xr tail 1
     95 .Sh AUTHORS
     96 .An -nosplit
     97 The
     98 .Nm
     99 program was written by
    100 .An Jan Klemkow Aq Mt j.klemkow@wemelug.de .