configure: add sanity check that one plugin is selected
[siplcs.git] / README
blobaae2d1d30878f8609e62578cb6f4b6722f202eef
1 Introduction
2 ============
4 pidgin-sipe is a third-party plugin for the Pidgin multi-protocol instant
5 messenger. It implements the extended version of SIP/SIMPLE used by various
6 products:
8     * Microsoft Office Communications Server (OCS 2007/2007R2 and newer)
9     * Microsoft Live Communications Server (LCS 2003/2005)
10     * Reuters Messaging
12 With this plugin you should be able to replace your Microsoft Office
13 Communicator client with Pidgin.
16 Features
17 ========
19 The plugin has support for
21     * Instant Messaging
22     * Chat rooms
23     * File transfer
24     * Buddy list maintenance
25     * Search contacts
26     * Presence with calendar data provisioning
27     * TLS/SSL protected connection
28     * NTLMv2 & Kerberos authentication
29     * Calendar data sources: Exchange
32 Support
33 =======
35 The Pidgin project does not support third-party plugins! If you have problems
36 with this plugin then please check out the support forums:
38     http://sf.net/projects/sipe/forums/
40 Bugs should be reported here:
42     http://sourceforge.net/tracker/?group_id=194563
45 Localization
46 ============
48 SIPE has already been localized for several languages. You can help to
49 translate SIPE to your native language at Transifex:
51     http://transifex.net/projects/p/pidgin-sipe/c/mob-branch/
53 The service offers a convenient web editor and automatic submission to the
54 repository.
57 Installing from a distribution repository
58 =========================================
60 Many Open Source OS distributions have a ready-made package "pidgin-sipe".
61 Before trying to compile it from the source code yourself, you should try
62 to install this package with the standard installation method provided by
63 your OS.
66 Do It Yourself I: compiling against "pidgin" package
67 ====================================================
69 If you already have installed the "pidgin" package from your distribution
70 repository and want compile pidgin-sipe from source code yourself, then you
71 need to install the necessary headers first. Depending on your distribution
72 you'll need to install one of the following packages
74         libpurple-dev
75         libpurple-devel
77 For the compilation you'll need to install a C compiler and some of the
78 following packages
80         libtool
81         intltool
82         libglib2.0-dev
83         gettext-devel
85 Now you should be able to compile the source code with
87         ./configure --prefix=/usr
88         make
90 If you get errors then you are missing some required package. After
91 successful compilation you can install pidgin-sipe with:
93         su -c "make install"
96 Do It Yourself II: compiling against self-compiled pidgin
97 =========================================================
99 If you have compiled pidgin from source code yourself then you'll have to
100 specify the correct installation path in configure. Usually pidgin is
101 installed in /usr/local so the following command should work
103         ./configure --prefix=/usr/local
105 The rest of the steps are the same as in the previous section.