lily - a readline-based user interface to the lily
lily [ -h hostname -p port ] [ -r ] [ -P pagesize ] [ -S ] [
-l logfile ] [ -t sendlist | file ]
lily is a multi-user, interactive communications system. It
was designed so that people from all over the world can
communicate with each other in a comfortable fashion. Its
basic function is to allow users to send messages to each
other, either privately to each other or publicly to
discussions, which many users can participate in.
lily has an extensive on-line help system. Issuing the
command ``/help'' will give you general information about
lily, and tell you how to get more specific information.
There is also a ``%help'' command which will give you help
with `local' commands.
See also: ``CLIENT vs. SERVER'', and ``CLIENT COMMANDS''
Connect to the specified hostname and port number of a
lily server. Using these options will override the
compile time defaults (usually lily.acm.rpi.edu and
-r Turns off readline mode, disabling many of the nice
features of the user interface, e.g.: masking your
password, use of the arrow keys, etc.
-P Set the number of lines to print before pausing.
-S Run in secure mode. This disables the following
commands: ``%log'', ``%source'', ``!<command>'' and
``%export''; which may be `unsafe' for anonymous users.
-l Choose a default name for your logfile, overriding the
compiled default (usually ~/lclient-log). When you run
lily with this option, you are automatically logging
your session to the specified file until you issue a
``%log'' command in lily.
-t Choose what action will occur when you use the tab key.
``sendlist'' gives you sendlist (irc-like) tab
completion, while ``file'' gives file completion.
CLIENT vs. SERVER
When you run lily, you are connecting to one of many lily
`servers'. These servers are the workhorses that direct your
messages to the appropriate users, keep track of what
discussions you're a member of, etc. When you connect to the
server, you can either directly telnet to it, or run a
client to make the connection for you.
If you're reading this man page, you're most likely goingt o
be using the client (also called lclient). This client
provides a much better user interface than a simple telnet
connection. All of the command line options shown in this
man page (except for -h and -p are based on lclient
functionality, as is the readline interface (enabling you to
use your cursor keys, e.g.) Also, there are a suite of
commands ``%command'' which are client based, not server
based. (Basically, these commands are executed by lclient
because of the required interaction with the system you are
See also: ``CLIENT COMMANDS''
The basic message format is ``recipients;message''. The list
of recipients is a comma delimited list of people or
discussions to whom the message should be given (i.e.
isis,pris,gourmet would go to Isis, Prisoner, and the
gourmet discussion). The ';' character can actually be
either a ';' or a ':', the system doesn't care. Everything
after that character is taken to be the text of the message
and sent to the recipients list.
If you are using lclient in readline mode (the default),
there are some special features:
; Fills in the recipients list with the last list you
: Fills in the recipients list with the name of the last
person who sent you a message.
= Fills in the recipients list with the names of everyone
who received the last message you did. For example, if
you receive a message that was sent to you, Coke,
Prisoner, and computer, pressing ``='' will
automatically fill in the recipients list as
See also: ``/help sending'' for more information.
Discussions are the center of the lily system. They are
hangouts where groups of people converse together. A
discussion has a name and a title. The name is used to
reference the discussion in sends and other commands, much
like a user's reserved name or psuedonym. The title tells
you what kinds of things are being talked about in the
discussion. Discussions also have `introductions' that
explain in more detail To get a list of discussions use
To participate in a discussion you must be a member first
(see ``/help join'' and ``/help quit''). Once you are a
member of the discussion you can check the review buffer to
see converstaion which you've missed (see ``/help review'').
Here is a brief listing of the lclient commands available in
this release. Use ``%help'' in lily for more information.
%alias [newcommand <string>]
%export <filename> [discussion]
%color [<event> <color>|off]
OBTAINING AN ACCOUNT
To access lily, you must first request an account. Send
email to your local lily admininstrator with your preferred
login, and up to three "reserved names", or psuedonyms.
(e.g.: if you're using the rpi lily server, the correct
email address would be firstname.lastname@example.org.) You will
receive a response verifying that your account has been
created, along with your actual login, password, and
reserved names. Once you have an account, run lily and enter
your login and password when prompted. When connecting for
the first time, be sure to change your password using the
``/password'' command on lily. Change your password
frequently to avoid security problems.
OBTAINING THE LILY CLIENT
lclient is available for anonymous FTP at
RUNNING YOUR OWN SERVER
For information about how to setup your own local lily
server, contact email@example.com.
Maker (Ron Frederick) original concept & suggestion
Pavel Curtis MOO database server
Harq al-Ada (Christian Ratliff) design & development of lily
Isis (Tandy E.A. Ratliff) design of lily
Prisoner (Allen Firstenberg) design of lily
Achorrath (Matt Nelson) development of lily
Shiva (Shiva Ramabadran) design & development of portable objects
Phil (Phil Rzewski) development of lily games
Ceej (Chris Hillery) development of lily games
Harq al-Ada (Christian Ratliff) orig. design & dev. (lclient&pad)
Prisoner (Allen Firstenberg) design & development (lclient&lhub)
Nala (Nancy Deschenes) design & development (lclient)
Darkwind (Gene Homicki) design & development (lclient)
Shiva (Shiva Ramabadran) design & development (emacs client)
Josh (Josh Wilmes) (lclient 1.0 coordination and autoconf)
Albert (Chris Stevens) (lclient 1.0 color patches)
Achorrath (Matt Nelson) (lclient 1.0 readline2 and paging patches)
Garance (Garance Drosehn) (lclient 1.0 testing and color fixes)
Derek (Jeff Rogers) (lclient 1.0 %alias patch)
Monte (Danny Daglas) (lclient 1.0 %keepalive patch)
Isis (Tandy E.A. Ratliff) lily administrator
bp (Atul Jagga) assistant lily administrator
The Flamemaster (Gordon Goldberg) assistant lily administrator
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either
version 2, or (at your option) any later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
You should have received a copy of the GNU General Public
License along with this program (see the file COPYING); if
not, write to the Free Software Foundation, Inc., 675 Mass
Ave, Cambridge, MA 02139, USA.
Many thanks to all the lily users who have taken the time to
submit their suggestions, and helped us with testing.
There are no known bugs at this time.
If you discover a bug in lily, please send mail to
firstname.lastname@example.org with a description of the bug and the
output from the ``/me'' command. (We recommmend using the
``%log'' command to give a detailed example of the problem).