| 1 | +=============================================================================+ |
|---|
| 2 | | _ | |
|---|
| 3 | | (_) ______ ______ Jabber | |
|---|
| 4 | | / / | /| / / __ `/ ___/ WindowGram | |
|---|
| 5 | | / /| |/ |/ / /_/ / /__ Client | |
|---|
| 6 | | __/ / |__/|__/\__, /\___/ | |
|---|
| 7 | | /___/ /____/ "But I -like- my ugly X Windows!" -me | |
|---|
| 8 | | | |
|---|
| 9 | +=============================================================================+ |
|---|
| 10 | http://jwgc.sourceforge.net/ |
|---|
| 11 | |
|---|
| 12 | The Jabber Windowgram Client is based entirely off of MIT's Zephyr Windowgram |
|---|
| 13 | Client program, and is designed to behave almost exactly the same. It supports, |
|---|
| 14 | or will support, most or all of the same functions that zwgc and other jabber |
|---|
| 15 | clients support. |
|---|
| 16 | |
|---|
| 17 | If you are interested in submitting patches, places note the BUILDINFO file |
|---|
| 18 | for information about the environment(s) with which I develop and compile |
|---|
| 19 | jwgc. |
|---|
| 20 | |
|---|
| 21 | |
|---|
| 22 | |
|---|
| 23 | |
|---|
| 24 | Installation |
|---|
| 25 | ------------------------------------------------------------------------------- |
|---|
| 26 | Compilation and installation should go fairly smoothly on most unix-based |
|---|
| 27 | operating systems. The most simple set of instructions are: |
|---|
| 28 | |
|---|
| 29 | 1. Untar the distribution |
|---|
| 30 | 2. Change into the distribution directory |
|---|
| 31 | 3. Run: ./configure |
|---|
| 32 | 4. Run: make |
|---|
| 33 | 5. Run: make install |
|---|
| 34 | |
|---|
| 35 | This installs into /usr/local by default, so you may need to add a --prefix |
|---|
| 36 | option to specify a path you have access to install into. You should also |
|---|
| 37 | run configure with the --help option to see the available options. The |
|---|
| 38 | options should be self-explanatory. The defaults are in parenthesis. |
|---|
| 39 | |
|---|
| 40 | |
|---|
| 41 | |
|---|
| 42 | |
|---|
| 43 | Usage |
|---|
| 44 | ------------------------------------------------------------------------------- |
|---|
| 45 | By default, jwgc will try to log you into the jabber server specified at |
|---|
| 46 | configure time, with your local unix username, and will prompt you for a |
|---|
| 47 | password. You should run jwgc with -h to see how you can change these |
|---|
| 48 | settings at run time. You may also want to read over the jwgc man page. |
|---|
| 49 | |
|---|
| 50 | The available commands are as follows: |
|---|
| 51 | jwgc - the core piece that connects you to the jabber server, and handles |
|---|
| 52 | all incoming and outgoing messages. no other commands will work |
|---|
| 53 | without jwgc running. |
|---|
| 54 | |
|---|
| 55 | jwrite - this command allows you to send a message to another user. |
|---|
| 56 | |
|---|
| 57 | jlocate - this command allows you to check your "buddy list". |
|---|
| 58 | |
|---|
| 59 | jstat - this command allows you to check on the status of jwgc, and your |
|---|
| 60 | connect to the jabber server. |
|---|
| 61 | |
|---|
| 62 | jctl - this command contains all other functions, such as subscriptions, |
|---|
| 63 | configuration, and shutdown. |
|---|
| 64 | |
|---|
| 65 | All of these commands come with man pages that describe their usage. They |
|---|
| 66 | should all also accept a -h flag for help. |
|---|
| 67 | |
|---|
| 68 | |
|---|
| 69 | |
|---|
| 70 | |
|---|
| 71 | Questions |
|---|
| 72 | ------------------------------------------------------------------------------- |
|---|
| 73 | If you have any suggestions, questions, bug reports, whatever.. please feel |
|---|
| 74 | free to either: |
|---|
| 75 | 1. submit them via the trackers as http://www.sourceforge.net/projects/jwgc |
|---|
| 76 | 2. drop me some email at jadestorm@users.sourceforge.net |
|---|
| 77 | 3. drop me a jabber im at daniel@jabber.vorpalcloud.org |
|---|
| 78 | |
|---|
| 79 | I hope you enjoy it! If you don't and can think of a way that it could be |
|---|
| 80 | improved to make you enjoy it, let me know! |
|---|
