Changeset

1193:b74acb50220b

Merge with 0.4
author Matthew Wild <mwild1@gmail.com>
date Fri, 22 May 2009 13:35:54 +0100
parents 1191:7f965bd37d65 (current diff) 1192:b1b42ce4f0f6 (diff)
children 1197:1f4a4e6ae694
files
diffstat 2 files changed, 106 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/INSTALL	Fri May 22 13:35:54 2009 +0100
@@ -0,0 +1,69 @@
+(This file was created from 
+http://prosody.im/doc/installing_from_source on 2009-05-22)
+
+===== Building =====
+==== Dependencies ====
+There are a couple of libraries which Prosody needs installed before 
+you can build it. These are:
+
+  * liblua5.1: Lua 5.1 library
+  * libssl 0.9.8: OpenSSL
+  * libidn11: GNU libidn library, version 1.1
+
+Both of these can be installed on Debian/Ubuntu with the packages: 
+liblua5.1-dev libidn11-dev libssl-dev
+
+On other systems... good luck, but please let me know of the best way 
+of getting the dependencies for your system and I can add it here.
+
+==== configure ====
+The first step of building is to run the configure script. This 
+creates a file called 'config.unix' which is used by the next step to 
+control aspects of the build process.
+
+All options to configure can be seen by running ./configure --help. 
+Sometimes you won't need to pass any parameters to configure, but on 
+most systems you shall.
+
+To make this a little easier, there are a few presets which configure 
+accepts. You can load a preset using:
+
+   ./configure --ostype=PRESET
+
+Where PRESET can currently be one of: debian, macosx
+
+==== make ====
+Once you have run configure successfully, then you can simply run:
+
+   make
+
+Simple? :-)
+
+If you do happen to have problems at this stage, it is most likely 
+due to the build process not finding the dependencies. Ensure you 
+have them installed, and in the standard library paths for your 
+system.
+
+For more help, just ask ;-)
+
+==== install ====
+At this stage you should be able to run Prosody simply with:
+
+   ./prosody
+
+There is no problem with this, it is actually the easiest way to do 
+development, as it doesn't spread parts around your system, and you 
+can keep multiple versions around in their own directories without 
+conflict.
+
+Should you wish to install it system-wide however, simply run:
+
+   sudo make install
+
+...it will install into /usr/local/ by default. To change this you 
+can pass to the initial ./configure using the 'prefix' option, or 
+edit config.unix directly. If the new path doesn't require root 
+permission to write to, you also won't need (or want) to use 'sudo' 
+in front of the 'make install'.
+
+Have fun, and see you on Jabber!
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Fri May 22 13:35:54 2009 +0100
@@ -0,0 +1,37 @@
+# Prosody IM Server
+
+## Description
+
+Prosody is a server for Jabber/XMPP written in Lua. It aims to be easy 
+to use and light on resources. For developers, it aims to give a 
+flexible system on which to rapidly develop added functionality or 
+rapidly prototype new protocols.
+
+## Useful links
+
+Homepage:        http://prosody.im/
+Download:        http://prosody.im/download
+Documentation:   http://prosody.im/doc/
+
+Jabber/XMPP Chat:
+               Address:
+                 prosody@conference.heavy-horse.co.uk
+               Web interface:
+                 http://prosody.im/webchat
+               
+Mailing lists:
+               User support and discussion:
+                 http://groups.google.com/group/prosody-users
+               
+               Development discussion:
+                 http://groups.google.com/group/prosody-dev
+               
+               Issue tracker changes:
+                 http://groups.google.com/group/prosody-issues
+
+## Installation
+
+See the accompanying INSTALL file for help on building Prosody from source. Alternatively 
+see our guide at http://prosody.im/install
+
+