Annotate

README @ 22:19c5a66837ed

clix.receive: Suppress history from chatrooms unless -h/--history is supplied
author Matthew Wild <mwild1@gmail.com>
date Thu, 07 Jan 2010 21:24:47 +0000
parent 10:49b83fa1f6fd
child 30:2323adeb8c7c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
1 # clix - Command-line XMPP tool
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
2
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
3 ## Description
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
4 Clix is a small utility to interact with an XMPP server. It can be
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
5 used to send messages, presence, and info queries to any XMPP address.
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
6
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
7 ## Example
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
8 clix message --to=user@example.com "The kettle has now boiled"
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
9
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
10 ## Usage
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
11 Syntax: clix COMMAND [OPTIONS] [...]
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
12
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
13 Different commands accept different sets of options, but they all
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
14 follow some general conventions. The command must be the first
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
15 parameter, followed by a series of flags or options. Global options
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
16 include:
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
17
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
18 --account=default
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
19 The account to use from the configuration file (default
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
20 is 'default')
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
21
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
22 -v
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
23 --verbose
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
24 Enables verbose logging of the XMPP connection
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
25
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
26 When no command is specified, clix will print a list of the names
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
27 and descriptions of all built-in commands.
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
28
10
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
29 ## Configuration
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
30 Clix looks for its config file at $HOME/.clix - it is a simple 'ini'
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
31 format, which looks like this:
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
32
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
33 [default]
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
34 jid=user@example.com
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
35 password=mypassword
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
36
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
37 [otheraccount]
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
38 jid=otheruser@example.org
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
39 password=theirpassword
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
40
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
41 and so on. You can define as many accounts as you want, if no account
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
42 is called 'default' then the first account is the default. If there is
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
43 no [] header at the start of the file it is assumed to be [default].
49b83fa1f6fd README: Add config file example
Matthew Wild <mwild1@gmail.com>
parents: 6
diff changeset
44
6
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
45 ## Building and installing
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
46 Building clix is (by no accident) quite simple. It depends on Verse,
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
47 an XMPP client library for Lua. Verse in turn depends on several
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
48 libraries, all dependencies are listed here.
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
49
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
50 Verse 2.0+: http://matthewwild.co.uk/projects/verse
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
51 At the time of writing Verse 2.x has not been released yet and
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
52 is available only from: http://code.matthewwild.co.uk/verse/
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
53
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
54 LuaExpat: http://www.keplerproject.org/luaexpat/
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
55 Lua XML parser. Available in Debian as liblua5.1-expat0
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
56
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
57 LuaSocket: http://www.tecgraf.puc-rio.br/~diego/professional/luasocket/
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
58 Lua networking library. Available in Debian as liblua5.1-socket2
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
59
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
60 Clix can be run directly from source if the above dependencies are
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
61 installed. To make life easier it can be installed to standard directories,
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
62 on most systems this means to copy clix.lua to /usr/bin/clix and the clix
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
63 directory to /usr/lib/lua/5.1/clix (on some non-Debian systems the 5.1
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
64 directory isn't needed).
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
65
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
66 Alternatively you can use Squish to compress all Clix's files into a single
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
67 executable. If you have Squish installed then simply type 'squish' in
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
68 clix's source directory to generate the compacted 'clix.bin' file. Squish
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
69 can be found at http://matthewwild.co.uk/projects/squish .
0ec2fd06a962 README: Added
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
70